Parametry
| curs | číslo tabulky nebo otevřeného kurzoru |
| attrname | jméno sloupce |
| res | vstupní parametr - beztypová proměnná obsahující hodnotu, které se má sloupec attrname rovnat; |
| [cdp | kontextová proměnná klienta] |
Popis
Funkce prohledá tabulku nebo kurzor curs a nalezne záznamy, v nichž se sloupec attrname rovná hodnotě res. Funkce vrátí absolutní číslo prvního záznamu, který této rovnosti vyhovuje. Neexistuje-li takový záznam nebo dojde k chybě, vrátí hodnotu -1.
Upozornění: funkci nejde použí na needitovatelné dotazy tvořené pomocí GROUP BY nebo agregačních funkcí!
Parametr res ukazuje resp. odkazuje na hledanou hodnotu zapsanou v klientském formátu, tedy např. dvou- nebo čtyřbajtové celé číslo, osmibajtové číslo v pohyblivé čárce, řetězec znaků ukončený nulou apod.
Efektivnějším způsobem práce s daty (vkládání, mazání, vyhledávání) je použití jazyka SQL, zvláště pak uložených procedur.
Hodnota funkce
Funkce vrátí absolutní číslo záznamu vyhovující dané rovnosti nebo -1 v jiném případě.