UDF > File >


_FileWriteFromArray

Écrit un tableau dans un fichier

#include <File.au3>
_FileWriteFromArray ( $sFilePath, Const ByRef $aArray [, $iBase = Default [, $iUBound = Default [, $sDelimiter = "|"]]] )

Paramètres

$sFilePath Le chemin et le nom du fichier dans lequel écrire, ou le handle du fichier retourné par FileOpen().
$aArray Le tableau qui doit être écrit dans le fichier.
$iBase [optionnel] Index où doit commencer la lecture, normalement fixé à 0 ou 1. Par défaut, 0.
$iUbound [optionnel] Sélectionne le dernier élément, du tableau, que vous souhaitez écrire dans le fichier. Par défaut, le tableau entier.
$sDelimiter [optionnel] Caractère(s) délimiteurs(s) pour les tableaux de dimension 2. Par défaut, "|".

Valeur de retour

Succès: Retourne 1.
Échec: Retourne 0 et définit @error <> 0.
@error: 1 - Erreur à l'ouverture du fichier
2 - $aArray n'est pas un tableau
3 - Erreur d'écriture dans le fichier
4 - $aArray n'est pas un tableau 1D ou 2D
5 - L'index de départ est supérieur au paramètre $iUbound

Remarque

Si un chemin est fourni sous forme de chaîne, le fichier est écrasé et fermé.
Pour utiliser d'autres modes d'écriture, comme les formats Append ou Unicode, ouvrir d'abord le fichier avec FileOpen() et passer le handle du fichier à la place du chemin.
Si un handle de fichier est passé, le fichier reste ouvert après l'écriture.

En relation

_FileReadToArray

Exemple

#include <File.au3>

; Liste tous les fichiers du répertoire courant du script.
Local $aScriptDir = _FileListToArray(@ScriptDir)

; Crée un fichier dans le répertoire %TEMP% de l'utilisateur.
Local $sFilePath = @TempDir & "\Examples.txt"

; Ecrit un tableau dans un fichier en passant le nom du fichier.
_FileWriteFromArray($sFilePath, $aScriptDir, 1)

; Affiche le fichier.
ShellExecute($sFilePath)