4D Internet Commands v16

POP3_Charset

Accueil

 
4D Internet Commands v16
POP3_Charset

POP3_Charset 


 

POP3_Charset ( décoderEntêtes ; jeuCorps ) -> Résultat 
Paramètre Type   Description
décoderEntêtes  Entier in -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 in -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 in Code d'erreur

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.

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)

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)

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)



Voir aussi  

MSG_Charset
SMTP_Charset

 
PROPRIÉTÉS 

Produit : 4D Internet Commands
Thème : IC POP3 Review Mail
Numéro : 88891
Nom intl. : POP3_Charset

 
HISTORIQUE 

Modifié : 4D Internet Commands 6.8.1

 
UTILISATION DE L'ARTICLE

4D Internet Commands ( 4D Internet Commands v16)