Aide:FileOpen.txt

Document original V3.3.6.1 :

###Function###
FileOpen

###Description###
Opens a text file for reading or writing.

###Syntax###
FileOpen ( "filename" [, mode ] )


###Parameters###
@@ParamTable@@
filename
	Filename of the text file to open.
mode
	[optional] Mode to open the file in.
	Can be a combination of the following:
	  0 = Read mode (default)
	  1 = Write mode (append to end of file)
	  2 = Write mode (erase previous contents)
	  8 = Create directory structure if it doesn't exist (See Remarks).
	  16 = Force binary mode (See Remarks).
	  32 = Use Unicode UTF16 Little Endian reading and writing mode. Reading does not override existing BOM.
	  64 = Use Unicode UTF16 Big Endian reading and writing mode. Reading does not override existing BOM.
	  128 = Use Unicode UTF8 (with BOM) reading and writing mode. Reading does not override existing BOM.
	  256 = Use Unicode UTF8 (without BOM) reading and writing mode.
	  16384 = When opening for reading and no BOM is present, use full file UTF8 detection. If this is not used then only the initial part of the file is checked for UTF8.
	The folder path must already exist (except using mode '8' - See Remarks).
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns a file "handle" for use with subsequent file functions.
Failure:	Returns -1 if error occurs.
@@End@@


###Remarks###
<ul>
<li>The file handle must be closed with the <a href="FileClose.htm">FileClose()</a> function.</li>
<li>A file may fail to open due to access rights or attributes.</li>
<li>The default mode when writing text is ANSI - use the unicode flags to change this. When writing unicode files the Windows default mode (and the fastest in AutoIt due to the least conversion) is UTF16 Little Endian (mode 32).</li>
<li>Opening a file in write mode creates the file if it does not exist.  Directories are not created unless the correct flag is used.</li>
<li>When reading and writing via the same file handle, the <a href="FileSetPos.htm">FileSetPos()</a> function must be used to update the current file position.</li>
</ul>

###Related###
FileClose, FileFlush, FileRead, FileReadLine, FileWrite, FileWriteLine, FileGetPos, FileSetPos


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
FileOpen

###Description###
Ouvre un fichier texte pour lecture ou écriture.


###Syntax###
FileOpen ( "filename" [, mode ] )


###Parameters###
@@ParamTable@@
filename
	Nom du fichier texte à ouvrir.
mode
	[optionnel] Mode d'ouverture du fichier.
	Peut-être une combinaison des éléments suivants:
	 0 = Mode lecture (par défaut)
	 1 = Mode écriture (ajoute à la fin du fichier)
	 2 = Mode écriture (efface le contenu précédent)
	 8 = Créé la structure des répertoires si elle n'existe pas (voir les remarques).
	 16 = Force le mode binaire (voir les remarques).
	 32 = Utilise l'Unicode UTF16 Little Endian en mode lecture et écriture. La lecture ne remplace pas la marque d'ordre des octets (<i>BOM</i>) existante.
	 64 = Utilise l'Unicode UTF16 Big Endian en mode lecture et écriture. La lecture ne remplace pas la marque d'ordre des octets (<i>BOM</i>)existante.
	 128 = Utilise l'Unicode UTF8 (avec <i>BOM</i>). La lecture ne remplace pas la marque d'ordre des octets <i>BOM</i>existante.
	 256 = Utilise l'Unicode UTF8 (sans <i>BOM</i>) en lecture et écriture.
	 16384 = Lors de l'ouverture en lecture et sans <i>BOM</i>, utilise la détection UTF8 sur le fichier complet. Si ce n'est pas utilisé, alors seulement la partie initiale du fichier est vérifiée pour l'UTF8.
	Le chemin du dossier doit déjà exister (sauf en utilisant le mode '8' - voir les remarques).
@@End@@


###ReturnValue###
Succès:	Retourne un "handle" de fichier pour utilisation ultérieure avec les fonctions de fichier.
Échec:	Retourne -1 si erreur est rencontrée.


###Remarks###
<ul>
<li>Le "handle" de fichier doit être fermé avec la fonction <a href="FileClose.htm">FileClose()</a>.</li>
<li>Un fichier peut ne pas s'ouvrir en raison de droits d'accès ou d'attributs.</li>
<li>Le mode par défaut lors de l'écriture de texte est ANSI - Utilisez le mode Unicode pour changer cela. Lors de l'écriture des fichiers, le mode Unicode par défaut de Windows (et le plus rapide dans AutoIt en raison de la conversion simple) est UTF16 Little Endian (mode 32).</li>
<li>L'ouverture d'un fichier en mode écriture crée le fichier s'il n'existe pas. Les répertoires ne sont pas créés à moins d'utiliser le bon mode.</li>
<li>Lors de la lecture et l'écriture par le même "handle" de fichier, la fonction <a href="FileSetPos.htm">FileSetPos()</a> doit être utilisée pour mettre à jour la position courante dans le fichier.</li>
</ul>


###Related###
<a href="FileClose.htm">FileClose</a>, <a href="FileFlush.htm">FileFlush</a>, <a href="FileRead.htm">FileRead</a>, <a href="FileReadLine.htm">FileReadLine</a>, <a href="FileWrite.htm">FileWrite</a>, <a href="FileWriteLine.htm">FileWriteLine</a>, <a href="FileGetPos.htm">FileGetPos</a>, <a href="FileSetPos.htm">FileSetPos</a>


###Example###
@@IncludeExample@@

Traducteur : Strofe

Contributeurs (pour les modifications avant le Wiki) : Tlem