4D Doc Center : IT

4D Internet Commands v14

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	1 = BinHex 2 = Base64 (Data fork uniquement) 3 = AppleSingle 4 = AppleDouble 5 = AppleSingle ET Base64 6 = AppleDouble ET Base64 7 = UUEncode 8 = MacBinary
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. Si vous passez une chaîne vide dans ce paramètre, une boîte de dialogue standard d'ouverture de documents apparaît, permettant à l'utilisateur de sélectionner lui-même le fichier.

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
1	BinHex
2	Base64 (Data fork uniquement)
3	AppleSingle
4	AppleDouble
5	AppleSingle et Base64
6	AppleDouble et Base64
7	UUEncode
8	MacBinary

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