wiki:es:Documentation/ARexxAPI/ADDRFIND

Version 3 (modified by AmigaPhil, 6 months ago) (diff)

--

En otros idiomas:


ARexx API

    ADDRFIND

    NOMBRE

    AddrFind -- Buscar fichas en el listín. (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 ?