NOM
lsearch, lfind - Recherche linéaire dans une table.
SYNOPSIS
#include <search.h>
void *lfind(const void *key, const void *base, size_t *nmemb,
size_t size, int(*compar)(const void *, const void *));
void *lsearch(const void *key, void *base, size_t *nmemb,
size_t size, int(*compar)(const void *, const void *));
Les fonctions lfind() et lsearch() effectuent une recherche linéaire de
la clé key dans la table base contenant *nmemb éléments, chacun de
taille size octets. La fonction de comparaison, pointée par compar, est
supposée prendre deux arguments pointant sur l’objet key et sur un
élément de la table, dans cet ordre. La fonction de comparaison renvoie
zéro si key correspond à cet élément de la table, et une valeur non
nulle sinon.
Si lsearch() ne trouve pas d’élément correspondant, alors l’objet key
est ajouté à la fin de la table et *nmemb est incrémenté. Il faut
savoir qu’un élément de correspondance existe, ou qu’il n’y a plus de
place disponible.
VALEUR RENVOYÉE
lfind() renvoie un pointeur sur l’élément de la table correspondant, ou
NULL si aucune correspondance n’est trouvée. lsearch() renvoie un
pointeur sur un élément correspondant de la table, ou sinon sur le
nouvel élément ajouté.
CONFORMITÉ
SVr4, BSD 4.3, POSIX.1-2001. Fonctions présentes dans la libc depuis la
version 4.6.27.
BOGUES
L’appellation est malheureuse.
VOIR AUSSI
bsearch(3), hsearch(3), tsearch(3)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».