version 6.8.1 (Modifiée)
IT_Encode (nomFichier; nomFichierCodé; modeCodage) Entier
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".
Référence