SMTP_Charset

4D Internet Commands v16

SMTP_Charset


SMTP_Charset ( codifiCab ; conjCorpos ) -> Resultado

Parâmetro	Tipo	Descrição
codifiCab	Inteiro	-1 = Utilizar a configuração atual, 0 = Não fazer nada, 1 = Converter utilizando o conjunto de caracteres especificado se ISO-8859-1 ou ISO-2022-JP, codificar 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 SMTP_Charset permite o suporte automático das mensagens que contém caracteres estendidos, durante seu envio com os comandos SMTP_QuickSend ou SMTP_Send. Se este comando não é chamado ou tem os parâmetros em 0, os Internet Commands versão 6.7 ou superior funcionarão do mesmo modo que a versão 6.5.x.

O comando SMTP_Charset permite em primeiro lugar, definir se o conjunto de caracteres definido no parâmetro tipoCorpo do comando SMTP_SetPrefs deve ser aplicado aos cabeçalhos e corpos das mensagens a enviar; em segundo lugar, para definir se um cabeçalho que contém caracteres estendidos deve ser codificados utilizando a sintaxes “=?ISO-8859-1?Q?Test=E9?= …” como o especifica a RFC # 1342. Este comando tem um alcance interprocessos e terá efeito em todos as mensagens posteriores que se enviem com SMTP_QuickSend e SMTP_Send em todos os processos 4D.

Este comando é especialmente útil para suportar caracteres estendidos incluídos nos cabeçalhos da mensagem, tais como Assunto ou os nomes inseridos nos endereços (por exemplo, para a codificação de endereços como “=?ISO-8859-1?Q?Test=E9?= <test@n.net >”).

Os cabeçalhos dos mensagens e os nomes dos arquivos adjuntos serão codificados da seguinte maneira, de acordo com a RFC1342:

Assunto, Comentário e nomes de arquivos de anexos: a string completa é codificada em base 64 se for incluidos caracteres estendidos.
Para os cabeçalhos From, To, CC, Bcc, Sender, ReplyTo, InReplyTo (chamados "cabeçalhos estruturados"):
- Qualquer texto entre (“<”, “>”) é sistematicamente considerado como um endereço de email e não é codificado.
- Os caracteres separadores tais como SPC < > ( ) @ , ; : " / ? . = não são codificados.
- As cadeias delimitadas por caracteres especiais são codificados se incluem caracteres estendidos.
- Exemplos de endereços:
  someone@somewhere não é codificado;
  Michèle <michele@somewhere>, só é codificado o nome Michèle.
- Outros cabeçalhos não são codificados.

O parâmetro CodifiCab especifica como lidar com a conversão do cabeçalho e a codificação durante o envio de uma mensagem. O valor por padrão é 0.

-1: Usar a configuração atual;
0: Não fazer nada;
1: O conjunto de caracteres para cabeçalhos e nomes de arquivos de anexos é definida pelo parâmetro SMTP_SetPrefs

Nota: Os cabeçalhos estendidos de tipo X_Mailer devem estar em ASCII US.

O parâmetro conjCorpos define os tratamentos e codificação a aplicar ao corpo da mensagem durante seu envio. O valor por padrão é 0.

-1: Usar a configuração atual;
0: Valor por defecto: UTF-8 base 64;
1: Utilizar el conjunto de caracteres y la codificación definida por el parámetro caractYcodifSMTP_SetPrefs

Nota: Recomendamos usar configurações padrão, que são apropriadas para a maioria dos sistemas/aplicativos atuais

Exemplo

Neste exemplo, o assunto e o corpo se convertem utilizando o conjunto de caracteres ISO-8859-1 e o assunto está codificado de acordo a sintaxes RFC 1342:

 SMTP_SetPrefs(1;1;0)

 $err:=SMTP_Charset(1;1)

 $err:=SMTP_QuickSend("mymail.com";"myaddress";"destination";"the Euro €";"the Euro symbol is €")

Ver também

POP3_Charset
SMTP_SetPrefs