4D Doc Center : POP3

4D Internet Commands v14

POP3_Charset


POP3_Charset ( décoderEntêtes ; jeuCorps ) -> Résultat

Paramètre	Type	Description
décoderEntêtes	Entier	-1 = Utiliser le paramétrage courant, 0 = Ne rien faire, 1 = Convertir dans le jeu de caractères Mac OS si ISO-8859-1 ou ISO-2022-JP, décoder les caractères étendus
jeuCorps	Entier	-1 = Utiliser le paramétrage courant, 0 = Ne rien faire, 1 = Convertir dans le jeu de caractères Mac OS si ISO-8859-1 ou ISO-2022-JP
Résultat	Entier	Code d'erreur

Description

La commande POP3_Charset automatise le traitement des caractères étendus dans les messages lors de leur exploitation via certaines commandes POP3 et MSG. Si cette commande n’est pas appelée ou si ses deux paramètres sont mis à 0, les commandes Internet de 4D version 6.7 ou supérieure fonctionneront de la même manière qu'en version 6.5.x.

La commande POP3_Charset permet de définir, d’une part, si les en-têtes comportant des caractères étendus doivent être décodés et, d’autre part, si le jeu de caractères utilisé dans le corps des messages et dans les en-têtes doit être converti.

Cette commande est particulièrement utile pour le traitement des caractères étendus dans les en-têtes tels que “Subject” et les noms placés dans les adresses (par exemple, pour le décodage d'adresses sous la forme =?ISO-8859-1?Q?Test=E9?= <test@n.net>).

Le paramètre decoderEntêtes définit les traitements à appliquer aux champs d’en-tête lors de l’exécution des commandes POP3_MsgLst et MSG_FindHeader (voir Note de compatibilité). Par défaut, ce paramètre a pour valeur 0.

-1 : Utiliser les paramétrages courants ;
0 : Ne rien faire ;
1 : L'en-tête est décodé si nécessaire. Si l’en-tête est décodé et si le jeu de caractères spécifié est de l'ISO-8859-1 ou de l’ISO-2022-JP, il est converti, respectivement en ASCII Mac OS ou en Shift-JIS.

Note de compatibilité (version 6.8.1) : POP3_Charset s’applique à la commande MSG_FindHeader uniquement si la commande MSG_Charset n’a pas été préalablement exécutée.

Le paramètre jeuCorps définit les traitements à appliquer au corps du message lors de l’exécution de la commande MSG_GetBody (voir Note de compatibilité). Par défaut, ce paramètre a pour valeur 0.

-1 : Utiliser les paramètrages courants ;
0 : Ne rien faire ;
1 : Si le jeu de caractères spécifié dans le champ "Body-Content-Type" est de l’ ISO-8859-1 ou de l’ISO-2022-JP, le texte du corps du message est converti, respectivement en ASCII Mac OS ou en Shift-JIS.

Note de compatibilité (version 6.8.1) : POP3_Charset s’applique à la commande MSG_GetBody uniquement si la commande MSG_Charset n’a pas été préalablement exécutée.

Exemple 1

Avec les commandes Internet de 4D version 6.5.x :

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

 $from:=ISO vers Mac($from)

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

 $to:=ISO vers Mac($to)

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

 $cc:=ISO vers Mac($cc)

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

 $subject:=ISO vers Mac($subject)

 

 $Err:=MSG_MessageSize($fichMsg;$tailleEntete;$tailleCorps;$tailleMsg)

 $Err:=MSG_GetBody($fichMsg;0;$tailleCorps;$Corps)

 $Corps:=ISO vers Mac($Corps)

Exemple 2

Avec les commandes Internet de 4D version 6.7.x :

 $Err:=POP3_Charset(1;1)

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

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

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

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

 

 $Err:=MSG_MessageSize($fichMess;$tailleEntete;$tailleCorps;$tailleMsg)

 $Err:=MSG_GetBody($fichMess;0;$tailleCorps;$Corps)

Exemple 3

Avec les commandes Internet de 4D version 6.8.x :

 $Err:=MSG_Charset(1;1)

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

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

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

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

 

 $Err:=MSG_MessageSize($fichMess;$tailleEntete;$tailleCorps;$tailleMsg)

 $Err:=MSG_GetBody($fichMess;0;$tailleCorps;$Corps)