Changes between Initial Version and Version 1 of es:Documentation/ARexxAPI/ADDRFIND


Ignore:
Timestamp:
Oct 1, 2013, 9:18:03 PM (15 months ago)
Author:
AmigaPhil
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • es:Documentation/ARexxAPI/ADDRFIND

    v1 v1  
     1== ADDRFIND
     2
     3'''NOMBRE'''
     4     AddrFind -- Buscar fichas en el listín.  (V2.0)
     5
     6'''PLANTILLA'''
     7     VAR/K,STEM/K,PATTERN/A,NAMEONLY/S,EMAILONLY/S
     8
     9'''FUNCIÓN'''
     10     Busca una o más fichas en el listín, explorando por omisión
     11     los campos "Alias", "Nombre real", "Dirección electrónica",
     12     "Descripción", "Calle", "Ciudad" y "País".
     13
     14'''ENTRADAS'''
     15     VAR/K         - variable en la que almacenar los resultados de la búsqueda\\
     16     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\\
     17     PATTERN/A     - patrón usado como criterio de búsqueda; se soportan todos los comodines del AmigaDOS\\
     18     NAMEONLY/S    - limitar la búsqueda al campo "Nombre real"\\
     19     EMAILONLY/S   - limitar la búsqueda al campo "Dirección electrónica"\\
     20
     21'''RESULTADOS'''
     22     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\\
     23     <stem>ALIAS.COUNT - número de coincidencias encontradas\\
     24     <stem>ALIAS.NR    - el N alias de la lista de alias que coinciden, donde NR es un número entre 0 y N-1\\
     25
     26     RC se pone a 5 si no se ha encontrado ninguna coincidencia.
     27
     28'''NOTAS'''
     29     Los alias se devuelven en el orden en el que aparecen en el listín.
     30
     31'''EJEMPLO'''
     32         /* Activar códigos de resultados */
     33
     34         OPTIONS RESULTS
     35
     36         /* Encontrar todos los alias que usan un cierto proveedor */
     37
     38         ADDRFIND PATTERN '#?@saug.org' STEM st. EMAILONLY
     39
     40         /* Listar resultados */
     41
     42         IF RC = 0 THEN\\
     43            DO i = 0 TO st.alias.count-1\\
     44               SAY 'Coincidencia #'i+1': 'st.alias.i\\
     45            END\\
     46         ELSE\\
     47            SAY 'No se ha encontrado ninguna coincidencia.'\\
     48         EXIT\\
     49
     50'''FALLOS'''
     51     AddrFind no puede buscar en los campos "Alias" y "Descripción"
     52     de los grupos.
     53
     54'''VÉASE TAMBIÉN'''
     55     [[rx_addrresolve| ADDRRESOLVE ]]