Parametry
| name | jméno objektu; |
| category | kategorie objektu; |
| position | výstupní parametr: číslo záznamu v systémové tabulce |
| [cdp | kontextová proměnná klienta] |
Popis
Funkce zjistí, zda existuje v otevřené aplikaci objekt jména name a kategorie category. Pokud ano, vrátí v parametru position jeho číslo (tj. externí číslo záznamu v příslušné systémové tabulce - TABTAB pro tabulky, OBJTAB pro ostatní objekty, USERTAB pro uživatele a skupiny).
Jako parametr category se používají konstanty CATEG_....
Funkci lze použít i na vyhledání objektu typu uživatel nebo skupina (CATEG_USER, CATEG_GROUP), které nepatří do žádné aplikace.
Hodnota funkce
Funkce vrací při úspěchu FALSE, při neúspěchu TRUE. Typická chyba je OBJECT_NOT_FOUND - Objekt nenalezen. Doporučujeme vždy ověřovat výsledek této funkce, a tak se vyhnout pozdější práci s nesmyslným číslem objektu.
Viz