4D Doc Center : MSG

4D Internet Commands v14

MSG_Charset


MSG_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 MSG_Charset automatiza el tratamiento de los caracteres extendidos en los mensajes durante el proceso con los comandos MSG. Si este comando no se llama o los parámetros están en 0, 4D Internet Commands versión 6.8.1 o superior funcionará del mismo modo que la versión 6.5.x.

MSG_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 el tratamiento a aplicar a los campos de encabezado durante la ejecución del comando MSG_FindHeader. 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 código ASCII Mac OS o Shift-JIS, respectivamente.

El parámetro conjCuerpos define el tratamiento a aplicar al cuerpo del mensaje durante la ejecución del comando MSG_GetBody. 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): si el comando MSG_Charset no se utiliza y el comando POP3_Charset se ha utilizado, los comandos MSG_FindHeader y MSG_GetBody tendrán en cuenta los parámetros de POP3_Charset. Si se utiliza MSG_Charset, se ignoran los parámetros de POP3_Charset.

Ejemplo 1

Utilizando una versión 6.5.x de 4D Internet Commands:

 $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

Utilizando una versión 6.8.1 o superior de 4D Internet Commands:

 $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).