IT_Encode

4D v20 R7

IT_Encode


IT_Encode ( nomFichier ; nomFichierCodé ; modeCodage ) -> Résultat

Paramètre	Type	Description
nomFichier	Texte	Chemin d'accès local à un fichier
nomFichierCodé	Texte	Chemin d'accès du fichier encodé
		Chemin d'accès au fichier encodé résultant
modeCodage	Entier	Mac & Win: 0 = Pas d'encodage (DataFork uniquement) ±1 = BinHex ±2 = Base64 (n'envoie que la DataFork) ±7 = UUEncode; Mac seulement: ±3 = AppleSingle ±4 = AppleDouble ±5 = AppleSingle ET Base64 ±6 = AppleDouble ET Base64
Résultat	Entier	Code d'erreur

Description

La commande IT_Encode encode un fichier au moyen du modeCodage spécifié. Le fichier désigné n'est pas modifié, seule une copie encodée est créée. Le nom du fichier encodé créé est le nom initial du fichier plus un suffixe ajouté pour spécifier la méthode de codage. Pour le codage Binhex, le suffixe ".hqx" est ajouté. Pour le codage Base64, le suffixe ".b64" est ajouté. Pour le codage AppleSingle, le suffixe ".as" est ajouté.

Le paramètre nomFichier contient le chemin d'accès complet au fichier que vous voulez encoder.

Le paramètre nomFichierCodé peut contenir :

Le chemin d'accès complet de la copie encodée du fichier, ce qui vous permet de définir son nom et son emplacement.
Le chemin d'accès complet du dossier devant recevoir la copie encodée, sans spécification du nom de fichier, auquel cas le nom du fichier encodé créé est le nom initial du fichier plus un suffixe ajouté pour spécifier la méthode de codage.
Une chaîne vide, auquel cas IT_Encode attribue un nom par défaut au document (défini suivant les principes énoncés précédemment) et le place dans le même dossier que le fichier désigné dans le premier paramètre.
Qu'il soit spécifié ou non, le chemin d'accès final du document encodé est retourné dans le paramètre nomFichierCodé. En raison des conflits de noms potentiels dans le répertoire spécifié, il est conseillé de prendre en compte la valeur résultante du paramètre.

Le paramètre modeCodage vous permet de définir la méthode d'encodage à appliquer au fichier. La valeur par défaut est 1 (encodage binhex). Les méthodes d'encodage proposées sont les suivantes :

Code	Méthode	Disponible sur
1	BinHex	Win & Mac
2	Base64 (Data fork uniquement)	Win & Mac
3	AppleSingle	Mac
4	AppleDouble	Mac
5	AppleSingle et Base64	Mac
6	AppleDouble et Base64	Mac
7	UUEncode	Win & Mac
8	MacBinary	Win & Mac

Pour le codage au moyen d'AppleDouble (modes de codage 4 & 6), deux fichiers sont créés, appelés "%nomFichier" et "nomFichier".

Voir aussi

IT_Decode