4D Doc Center : POP3

4D Internet Commands v14

POP3_Charset


POP3_Charset ( decodEncab ; conjCuerpos ) -> resultado

Parámetro	Tipo	Descripción
decodEncab	Entero	-1 = Utilizar el parámetro actual, 0 = No hace nada, 1 = Convertir en el conjunto de caracteres Mac OS si ISO-8859-1 o ISO-2022-JP, decodificar los caracteres extendidos
conjCuerpos	Entero	-1 = Utilizar el parámetro actual, 0 = No hace nada, 1 = Convertir en el conjunto de caracteres Mac OS si ISO-8859-1 o ISO-2022-JP
resultado	Entero	Código de error

Descripción

El comando POP3_Charset automatiza el tratamiento de los caracteres extendidos en los mensajes mientras los procesa con los comandos POP3 y MSG. Si este comando no se llama o tiene los parámetros en 0, los Internet Commands versión 6.7 o superior funcionarán del mismo modo que la versión 6.5.x.

POP3_Charset permite, en primer lugar, definir si los encabezados con caracteres extendidos deben ser decodificados y en segundo lugar, si debe convertirse el conjunto de caracteres utilizado en el cuerpo del mensaje y en los encabezados.
Este comando es especialmente útil para el tratamiento de caracteres extendidos incluidos en los encabezados tales como el "Asunto" o direcciones de correo electrónico (por ejemplo, para decodificar una dirección como “=?ISO-8859-1?Q?Test=E9?= <test@n.net >”).

El parámetro decodEncab define los tratamientos a aplicar a los campos de encabezado durante la ejecución de los comandos POP3_MsgLst o MSG_FindHeader(ver Nota de compatibilidad). El valor por defecto es 0.

-1: Usar la configuración actual;
0: No hacer nada;
1: Los encabezados son decodificados si es necesario. Si el encabezado es decodificado y si el conjunto de caracteres especificado es ISO-8859-1 o ISO-2022-JP, los encabezados se convierten utilizando ASCII Mac OS código o Shift-JIS, respectivamente.

Nota de compatibilidad (versión 6.8.1): POP3_Charset se aplica al comando MSG_FindHeader únicamente si el comando MSG_Charset no se ha ejecutado con anterioridad.

El parámetro conjCuerpos define el tratamiento a aplicar al cuerpo del mensaje durante la ejecución del comando MSG_GetBody (ver Nota de compatibilidad). El valor por defecto es 0.

-1: Usar la configuración actual;
0: No hacer nada;
1: Si el conjunto de caracteres especificado en el campo "Body-Content-Type" es ISO-8859-1 o ISO-2022-JP, el texto del cuerpo del mensaje se convierte utilizando ASCII Mac OS o Shift-JIS, respectivamente.

Nota de compatibilidad (versión 6.8.1): POP3_Charset se aplica al comando MSG_GetBody únicamente si el comando MSG_Charset no se ha ejecutado con anterioridad.

Ejemplo 1

Con 4D Internet Commands versión 6.5.x:

 $Err:=MSG_FindHeader($msgfile;"From";$from)

 $from:=ISO to Mac($from)

 $Err:=MSG_FindHeader($msgfile;"To";$to)

 $to:=ISO to Mac($to)

 $Err:=MSG_FindHeader($msgfile;"Cc";$cc)

 $cc:=ISO to Mac($cc)

 $Err:=MSG_FindHeader($msgfile;"Subject";$subject)

 $subject:=ISO to Mac($subject)

 

 $Err:=MSG_MessageSize($msgfile;$HdrSize;$BdySize;$MsgSize)

 $Err:=MSG_GetBody($msgfile;0;$BdySize;$BodyContent)

 $BodyContent:=ISO to Mac($BodyContent)

Ejemplo 2

Con Internet Commands versión 6.7.x:

 $Err:=POP3_Charset(1;1)

 $Err:=MSG_FindHeader($msgfile;"From";$from)

 $Err:=MSG_FindHeader($msgfile;"To";$to)

 $Err:=MSG_FindHeader($msgfile;"Cc";$cc)

 $Err:=MSG_FindHeader($msgfile;"Subject";$subject)

 

 $Err:=MSG_MessageSize($msgfile;$HdrSize;$BdySize;$MsgSize)

 $Err:=MSG_GetBody($msgfile;0;$BdySize;$BodyContent)

Ejemplo 3

Con Internet Commands versión 6.8.x:

 $Err:=MSG_Charset(1;1)

 $Err:=MSG_FindHeader($msgfile;"From";$from)

 $Err:=MSG_FindHeader($msgfile;"To";$to)

 $Err:=MSG_FindHeader($msgfile;"Cc";$cc)

 $Err:=MSG_FindHeader($msgfile;"Subject";$subject)

 

 $Err:=MSG_MessageSize($msgfile;$HdrSize;$BdySize;$MsgSize)

 $Err:=MSG_GetBody($msgfile;0;$BdySize;$BodyContent)