4D Doc Center : POP3

4D Internet Commands v14

POP3_Charset


POP3_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 POP3_Charset automatiza o tratamento dos caracteres estendidos nas mensagens enquanto os processa com os comandos POP3 e MSG. Se este comando não é chamado ou tem os parâmetros em 0, o Internet Commands versão 6.7 ou superior funcionarão da mesma forma que a versão 6.5.x.

POP3_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 e-mail (por exemplo, para decodificar um endereço como “=?ISO-8859-1?Q?Test=E9?= <test@n.net >”).

O parâmetro decodCabe define os tratamentos a aplicar aos campos do cabeçalho durante a execução dos comandos POP3_MsgLst ou MSG_FindHeader(ver Nota de compatibilidade). O valor por padrão é 0.

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

Nota de compatibilidade (versão 6.8.1): POP3_Charset se aplica ao comando MSG_FindHeader unicamente se o comando MSG_Charset não foi executado com antecipação.

O parâmetro conjCorpos define o tratamento a aplicar ao corpo da mensagem durante a execução do comando MSG_GetBody (ver Nota de compatibilidade). 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 o ISO-2022-JP, o texto do corpo da mensagem é convertido utilizando ASCII Mac OS ou Shift-JIS, respectivamente.

Nota de compatibilidade (versão 6.8.1): POP3_Charset se aplica ao comando MSG_GetBody unicamente se o comando MSG_Charset não foi executado com antecipação.

Exemplo 1

Com 4D Internet Commands versão 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)

Exemplo 2

Com Internet Commands versão 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)

Exemplo 3

Com Internet Commands versão 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)