wiki:es:Documentation/ARexxAPI/MAILFILTER

Version 1 (modified by AmigaPhil, 11 months ago) (diff)

--

En otros idiomas:

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