4D Doc Center : MSG

4D Internet Commands v14

MSG_Charset


MSG_Charset ( decodCabe ; conjCorpos ) -> Resultado

Parâmetro	Tipo	Descrição
decodCabe	Inteiro	-1 = Utilizar o parâmetro atual, 0 = Não faz nada, 1 = Converter no conjunto de caracteres Mac OS se ISO-8859-1 ou ISO-2022-JP, decodificar os caracteres estendidos
conjCorpos	Inteiro	-1 = Utilizar o parâmetro atual, 0 = Não faz nada, 1 = Converter no conjunto de caracteres Mac OS se ISO-8859-1 ou ISO-2022-JP
Resultado	Inteiro	Código de erro

Descrição

O comando MSG_Charset automatiza o tratamento dos caracteres estendidos nas mensagens durante o processo com os comandos MSG. Se este comando não é chamado ou os parâmetros estão em 0, 4D Internet Commands versão 6.8.1 ou a superior funcionará da mesmo forma que a versão 6.5.x.

MSG_Charset permite, em primeiro lugar, definir se os cabeçalhos com caracteres estendidos devem ser decodificados e em segundo lugar, se deve ser convertido o conjunto de caracteres utilizado no corpo da mensagem e nos cabeçalhos.

Este comando é especialmente útil para o tratamento de caracteres estendidos incluídos nos cabeçalhos tais como o "Assunto" ou direções de email (por exemplo, para decodificar uma direção como “=?ISO-8859-1?Q?Test=E9?= <test@n.net >”).

O parâmetro decodCabe define o tratamento a aplicar aos campos de cabeçalho durante a execução do comando MSG_FindHeader. O valor por padrão é 0.

-1: Usar a configuração atual;
0: Não fazer nada;
1: Os cabeçalhos são decodificados se é necessário. Se o cabeçalho é decodificado e se o conjunto de caracteres especificado é ISO-8859-1 ou ISO-2022-JP, os cabeçalhos se convertem utilizando código ASCII Mac OS ou Shift-JIS, respectivamente.

O parâmetro conjCorpos define o tratamento a aplicar ao corpo da mensagem durante a execução do comando MSG_GetBody. O valor por padrão é 0.

-1: Usar a configuração atual;
0: Não fazer nada;
1: Se o conjunto de caracteres especificado no campo "Body-Content-Type" é ISO-8859-1 ou ISO-2022-JP, o texto do corpo da mensagem se converte utilizando ASCII Mac OS ou Shift-JIS, respectivamente.

Nota de compatibilidade (versão 6.8.1): se o comando MSG_Charset não é utilizado e o comando POP3_Charset foi utilizado, os comandos MSG_FindHeader e MSG_GetBody terão em conta os parâmetros de POP3_Charset. Caso se utilize MSG_Charset, serão ignorados os parâmetros de POP3_Charset.

Exemplo 1

Utilizando uma versão 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)

Exemplo 2

Utilizando uma versão 6.8.1 ou 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).