wiki:es:Documentation/ARexxAPI/ADDRINFO

Version 4 (modified by Emilio Jimenez, 5 years ago) (diff)

En otros idiomas:


ARexx API

    ADDRINFO

    NOMBRE

    AddrInfo — Obtener información sobre un contacto de la agenda. (V2.0)

    PLANTILLA

    VAR/K,STEM/K,ALIAS/A

    FUNCIÓN

    Devuelve información sobre una ficha del listín.

    ENTRADAS

    VAR/K - variable donde almacenar los resultados del comando
    STEM/K - nombre base a utilizar para los STEMs donde se almacenarán los resultados del comando
    ALIAS/A - alias de la ficha de la que obtener información

    RESULTADOS

    <STEM>TYPE - tipo de ficha, puede ser P (persona), L (lista de distribución) o G (grupo)
    <STEM>NAME - nombre real de esta ficha
    <STEM>EMAIL - dirección electrónica de esta ficha
    <STEM>PGP - ID de clave PGP de esta ficha
    <STEM>HOMEPAGE - página web de esta ficha
    <STEM>STREET - dirección ordinaria de esta ficha
    <STEM>CITY - ciudad de esta ficha
    <STEM>COUNTRY - país de esta ficha
    <STEM>PHONE - número de teléfono de esta ficha
    <STEM>COMMENT - comentario guardado con esta ficha
    <STEM>BIRTHDATE - fecha de nacimiento de esta ficha, en formato (D)DMMAAAA
    <STEM>IMAGE - fichero donde está el retrato de esta ficha
    <STEM>MEMBERS.COUNT - número de miembros, si la ficha es en realidad una lista de distribución
    <STEM>MEMBERS.NR - el miembro N si la ficha es en realidad una lista de distribución, donde NR es un número entre 0 y N-1

    RC se pone a 10 si el alias indicado no existe, o si no se indicó ninguno.

    NOTAS

    Los campos cuya información no está disponible se devuelven en forma de cadena vacía, excepto en el caso de la fecha de nacimiento, que se devuelve como cero (0).

    EJEMPLO

             /* Activar códigos de resultados */
    
             OPTIONS RESULTS
    
             /* Ignorar posible error de ADDRINFO */
    
             OPTIONS FAILAT 11
    
             /* Encontrar una ficha determinada */
    
             ADDRINFO 'mars' STEM st.
    
             /* Listar resultados */
    
             IF RC ~= 0 THEN EXIT
    
             SAY 'Tipo de ficha:         'st.type\\
             SAY 'Nombre real:           'st.name\\
             SAY 'Dirección electrónica: 'st.email\\
             SAY 'ID de clave PGP:       'st.pgp\\
             SAY 'Página web:            'st.homepage\\
             SAY 'Calle:                 'st.street\\
             SAY 'Ciudad:                'st.city\\
             SAY 'País:                  'st.country\\
             SAY 'Número de teléfono:    'st.phone\\
             SAY 'Descripción:           'st.comment\\
             SAY 'Fecha de nacimiento:   'st.birthdate\\
             SAY 'Retrato:               'st.image\\
    

    FALLOS

    VÉASE TAMBIÉN