wiki:es:Documentation/ARexxAPI/ADDRFIND

En otros idiomas:


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
<stem>ALIAS.COUNT - número de coincidencias encontradas
<stem>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

Last modified 3 months ago Last modified on Sep 27, 2014, 3:56:44 PM