NUME

lfind, lsearch - căutare liniară într-o matrice

BIBLIOTECA

Biblioteca C standard (libc, -lc)

REZUMAT

#include <search.h>

void *lfind(const void key[.size], const void base[.size * .nmemb],
            size_t *nmemb, size_t size,
            int(*compar)(const void [.size], const void [.size]));
void *lsearch(const void key[.size], void base[.size * .nmemb],
            size_t *nmemb, size_t size,
            int(*compar)(const void [.size], const void [.size]));

DESCRIERE

lfind() și lsearch() efectuează o căutare liniară pentru key în matricea base care are *nmemb elemente de size octeți fiecare. Se așteaptă ca funcția de comparație la care face referire compar să aibă două argumente care indică obiectul key ș i un membru al matricei, în această ordine, ș i care returnează zero dacă obiectul key se potriveș te cu membrul matricei și diferit de zero în caz contrar.

În cazul în care lsearch() nu găsește un element corespunzător, atunci obiectul key este inserat la sfârșitul tabelului, iar *nmemb este incrementat. În special, ar trebui să se știe că există un element corespunzător sau că este disponibil mai mult spațiu.

VALOAREA RETURNATĂ

lfind() returnează un indicator către un membru al matricei care coincide sau NULL în cazul în care nu se găsește nicio potrivire. lsearch() returnează un indicator către un membru care se potrivește al matricei sau către membrul nou adăugat, dacă nu se găsește nicio potrivire.

ATRIBUTE

Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).

STANDARDE

POSIX.1-2008.

ISTORIC

POSIX.1-2001, SVr4, 4.3BSD. libc-4.6.27.

ERORI

Denumirea este nefericită.

CONSULTAȚI ȘI

bsearch(3), hsearch(3), tsearch(3)

TRADUCERE

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.