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


Ignore:
Timestamp:
Oct 1, 2013 9:18:03 PM (13 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 ]]