es:Documentation ARexxAPI ADDRINFO

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