wiki:es:Documentation/ARexxAPI/ADDRINFO

En otros idiomas:


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

Last modified 3 months ago Last modified on Sep 27, 2014, 3:57:21 PM