NOMBRE

       lfind, lsearch - búsqueda líneal en una matriz

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

SINOPSIS

       #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]));

DESCRIPCIÓN

       lfind()  y  lsearch() realizan una búsqueda líneal de key en la matriz base que tiene *nmemb elementos de
       size bytes cada uno. Se espera que la función de comparación a  que  hace  referencia  compar  tenga  dos
       argumentos que apuntan al objeto key y a un miembro de la matriz, en ese orden, y que devuelva cero si el
       objeto key coincide con el miembro de la matriz, y distinto de cero en cualquier otro caso.

       If  lsearch()  does not find a matching element, then the key object is inserted at the end of the table,
       and *nmemb is incremented.  In particular, one should know that a matching element exists, or  that  more
       room is available.

VALOR DEVUELTO

       lfind()  devuelve  un  puntero  a  un  miembro coincidente de la matriz, o NULL si no hubo coincidencias.
       lsearch() devuelve un puntero a un miembro coincidente de la matriz, o al nuevo  miembro  añadido  si  no
       hubo coincidencias.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
       ┌──────────────────────────────────────────────────────────────┬────────────────────┬───────────────────┐
       │ Interfaz                                                     │ Atributo           │ Valor             │
       ├──────────────────────────────────────────────────────────────┼────────────────────┼───────────────────┤
       │ lfind(), lsearch()                                           │ Seguridad del hilo │ Multi-hilo seguro │
       └──────────────────────────────────────────────────────────────┴────────────────────┴───────────────────┘

ESTÁNDARES

       POSIX.1-2008.

HISTORIAL

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

ERRORES

       The naming is unfortunate.

VÉASE TAMBIÉN

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

TRADUCCIÓN

       La   traducción   al   español   de   esta  página  del  manual  fue  creada  por  Vicente  Pastor  Gómez
       <vpastorg@santandersupernet.com> y Juan Piernas <piernas@ditec.um.es>

       Esta traducción es documentación libre;  lea  la  GNU General Public License Version 3  o  posterior  con
       respecto a las condiciones de copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si  encuentra  algún  error  en  la  traducción  de esta página del manual, envíe un correo electrónico a
       debian-l10n-spanish@lists.debian.org.

Páginas de Manual de Linux 6.9.1                   2 Mayo 2024                                        lsearch(3)