wiki:es:Documentation/ARexxAPI/ADDRINFO

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

--

En otros idiomas:


ARexx API

    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