es:Documentation ARexxAPI ADDRFIND

ADDRFIND

NOMBRE AddrFind -- Busca contactos en la agenda de direcciones. (V2.0)

PLANTILLA VAR/K,STEM/K,PATTERN/A,NAMEONLY/S,EMAILONLY/S

FUNCIÓN Busca una o más fichas en el listín, explorando por omisión los campos "Alias", "Nombre real", "Dirección electrónica", "Descripción", "Calle", "Ciudad" y "País".

ENTRADAS VAR/K - variable en la que almacenar los resultados de la búsqueda\ STEM/K - nombre base a utilizar para los STEMs donde se almacenarán los alias de las fichas del listín que respondan a la búsqueda\ PATTERN/A - patrón usado como criterio de búsqueda; se soportan todos los comodines del AmigaDOS\ NAMEONLY/S - limitar la búsqueda al campo "Nombre real"\ EMAILONLY/S - limitar la búsqueda al campo "Dirección electrónica"\

RESULTADOS VAR - cadena con el número de fichas que han respondido a la búsqueda y una lista de sus correspondientes alias separados por un espacio\ ALIAS.COUNT - número de coincidencias encontradas\ ALIAS.NR - el N alias de la lista de alias que coinciden, donde NR es un número entre 0 y N-1\

 RC se pone a 5 si no se ha encontrado ninguna coincidencia.

NOTAS Los alias se devuelven en el orden en el que aparecen en el listín.

EJEMPLO

        /* Activar códigos de resultados */

         OPTIONS RESULTS

         /* Encontrar todos los alias que usan un cierto proveedor */

         ADDRFIND PATTERN '#?@saug.org' STEM st. EMAILONLY

         /* Listar resultados */

         IF RC = 0 THEN\\
            DO i = 0 TO st.alias.count-1\\
               SAY 'Coincidencia #'i+1': 'st.alias.i\\
            END\\
         ELSE\\
            SAY 'No se ha encontrado ninguna coincidencia.'\\
         EXIT\\

FALLOS AddrFind no puede buscar en los campos "Alias" y "Descripción" de los grupos.

VÉASE TAMBIÉN ADDRRESOLVE