wiki:es:Documentation/ARexxAPI/ADDRINFO

Version 2 (modified by AmigaPhil, 12 months ago) (diff)

--

En otros idiomas:

ADDRINFO

NOMBRE

AddrInfo -- Obtener información sobre una ficha del listín. (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