wiki:es:Documentation/ARexxAPI/MAILFILTER

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

--

En otros idiomas:


ARexx API

    MAILFILTER

    NOMBRE

    MailFilter -- Filtrar los mensajes de la carpeta actual. (V1.3.3)

    PLANTILLA

    VAR/K,STEM/K,ALL/S

    FUNCIÓN

    Filtra todos los mensajes de la carpeta actual, o bien sólo aquéllos marcados como "nuevos".

    ENTRADAS

    VAR/K - variable alternativa en la que almacenar los resultados en lugar de RESULT (V2.0)
    STEM/K - nombre base usado para los STEMs donde se almacenará la información devuelta (V2.0)
    ALL/S - filtrar todos los mensajes de la carpeta, en lugar de sólo los marcados como "nuevos"

    RESULTADOS

    VAR - información devuelta por el comando
    <STEM>CHECKED - número total de mensajes evaluados
    <STEM>BOUNCED - número de mensajes desviados
    <STEM>FORWARDED - número de mensajes reenviados
    <STEM>REPLIED - número de mensajes auto-respondidos
    <STEM>EXECUTED - número de mensajes que provocaron la ejecución de un comando
    <STEM>MOVED - número de mensajes movidos a otra carpeta
    <STEM>DELETED - número de mensajes borrados

    Tenga en cuenta que los STEMs se inicializan aunque la carpeta esté vacía.

    AVISO

    Debido a un defecto de diseño de YAM, filtrar una gran cantidad de mensajes y que sea necesario cargar los índices de muchas carpetas es una operación potencialmente peligrosa en el caso de Amigas con una cantidad muy limitada de memoria, puesto que el sistema podría quedarse sin memoria mientras se está haciendo el filtrado, lo cual podría producir la caída del sistema. Úsese con precaución.

    NOTAS

    Al contrario de lo que ocurre cuando se utiliza el interfaz gráfico, el comando no hace aparecer ningún aviso en caso de ser invocado sobre una carpeta distinta de "Entrantes".

    EJEMPLO

    /* Activar códigos de resultados */

    OPTIONS RESULTS

    /* Filtrar todos los mensajes de la carpeta actual */

    MAILFILTER ALL STEM st.

    /* Mostrar los resultados */

    SAY 'Mensajes evaluados: 'st.checked
    SAY 'Desviados: 'st.bounced
    SAY 'Auto-reenviados: 'st.forwarded
    SAY 'Auto-respondidos: 'st.replied
    SAY 'Comandos ejecutados: 'st.executed
    SAY 'Movidos: 'st.moved
    SAY 'Borrados: 'st.deleted

    FALLOS

    VÉASE TAMBIÉN