wiki:es:Documentation/ARexxAPI/ADDRFIND

Version 2 (modified by AmigaPhil, 14 months ago) (diff)

--

En otros idiomas:

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 ?