====== File ======
L'objet Fichier vous permet de lire et écrire un fichier.

===== Fonctions =====

==== File ====
Fonction de construction.

=== Syntaxe ===
<code javascript>
var myObject = new File();
</code>

=== Exemple ===
Créer l'objet Fichier.
<code javascript>
var myObject = new File();
</code>

==== copy ====
Copier un fichier.

=== Syntaxe ===
<code javascript>
File.copy(source, destination);
</code>
<code javascript>
File.copy(source, destination, options);
</code>

=== Arguments ===
  - source - (string) la source du fichier à copier
  - destination - (string) la destination fichier/dossier
  - options - (object) [//Ajouté dans Actionaz 3.0.1.//]
    * noErrorDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une erreur est rencontrée ?(Windows seulement, défaut: vrai)
    * noConfirmDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une confirmation est requise ? (Windows seulement, défaut: vrai)
    * noProgressDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait en cours de progression (Windows seulement, défaut: vrai)
    * createDestinationDirectory - (bool) le chemin de destination devrait-il être créé s'il n'existe pas ? (Linux seulement, défaut: vrai)

=== Renvoie ===
  * (null) rien

=== Exceptions ===
  * (ParameterCountError) paramètre de compteur incorrect
  * (DirectoryCreationError) impossible de créer le dossier de destination (Linux seulement)
  * (DirectoryDoesntExistError) le dossier de destination n'existe pas (Linux seulement)
  * (CopyError) copie échouée
  * (CopyAbortedError) copie annulée (Windows seulement)

==== move ====
Déplace un fichier.

=== Syntaxe ===
<code javascript>
File.move(source, destination);
</code>
<code javascript>
File.move(source, destination, options);
</code>

=== Arguments ===
  - source - (string) la source du fichier à déplcer
  - destination - (string) la destination du fichier/dossier
  - options - (object) [//Ajouté dans Actionaz 3.0.1.//]
    * noErrorDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une erreur est rencontrée ?(Windows seulement, défaut: vrai)
    * noConfirmDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une confirmation est requise ? (Windows seulement, défaut: vrai)
    * noProgressDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait en cours de progression (Windows seulement, défaut: vrai)
    * createDestinationDirectory - (bool) le chemin de destination devrait-il être créé s'il n'existe pas ? (Linux seulement, défaut: vrai)

=== Renvoie ===
  * (null) rien

=== Exceptions ===
  * (ParameterCountError) paramètre de compteur incorrect
  * (DirectoryCreationError) impossible de créer le dossier de destination (Linux seulement)
  * (DirectoryDoesntExistError) le dossier de destination n'existe pas (Linux seulement)
  * (MoveError) déplacement échoué
  * (MoveAbortedError) déplacement annulé (Windows seulement)

==== rename ====
Cette fonction est un alias de la fonction [[#move|move]] .

==== remove ====
Supprimer un fichier.

=== Syntaxe ===
<code javascript>
File.remove(filename);
</code>
<code javascript>
File.remove(filename, options);
</code>

=== Arguments ===
  - filename - (string) le fichier à supprimer
  - options - (object) [//Ajouté dans Actionaz 3.0.1.//]
    * noErrorDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une erreur est rencontrée ?(Windows seulement, défaut: vrai)
    * noConfirmDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une confirmation est requise ? (Windows seulement, défaut: vrai)
    * noProgressDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait en cours de progression (Windows seulement, défaut: vrai)
    * allowUndo - (bool) le fichier/dossier doit-il être envoyé vers la corbeille (Windows seulement, défaut: faux)

=== Renvoie ===
  * (null) rien

=== Exceptions ===
  * (ParameterCountError) paramètre de compteur incorrect
  * (RemoveError) supression échoué
  * (RemoveAbortedError) supression annulée (Windows seulement)

===== Methods =====

==== open ====
Ouvrir un fichier.

=== Syntaxe ===
<code javascript>
myObject.open(filename, openMode);
</code>

=== Arguments ===
  - filename - (string) le nom de fichier du fichier à ouvrir
  - openMode - ([[#openmode|OpenMode]]) le mode ouvrir

=== Returns ===
  * (File) ce Fichier

=== Exceptions ===
  * (CannotOpenFileError) ne peut pas ouvrir le fichier

==== write ====
Écrire une série de données sur un fichier.

=== Syntaxe ===
<code javascript>
myObject.write(data);
</code>
<code javascript>
myObject.write(other);
</code>

=== Arguments ===
  - data - ([[en:code:core:rawdata|RawData]]) les données à écrire
  - other - (mixed) les données à écrire

=== Renvoie ===
  * (File) ce Fichier

=== Exceptions ===
  * (WriteFailedError) écriture échouée

==== writeText ====
Écrire du texte sur un fichier.

=== Syntaxe ===
<code javascript>
myObject.writeText(text);
</code>
<code javascript>
myObject.writeText(text, encoding);
</code>

=== Arguments ===
  - text - (string) le texte à écrire
  - encoding - ([[en:code:core:global#encoding|Encoding]]) l'encodage à utiliser

=== Renvoie ===
  * (File) ce Fichier

=== Exceptions ===
  * (WriteFailedError) écriture échouée

==== read ====
Lire une série de données à partir d'un fichier.

=== Syntaxe ===
<code javascript>
myObject.read();
</code>

=== Renvoie ===
  * ([[en:code:core:rawdata|RawData]]) la série de donnée en provenance du fichier

==== readText ====
Lire du texte à partir d'un fichier.

=== Syntaxe ===
<code javascript>
myObject.readText();
</code>
<code javascript>
myObject.readText(encoding);
</code>

=== Arguments ===
  - encoding - ([[en:code:core:global#encoding|Encoding]]) l'encodage à utiliser

=== Renvoie ===
  * (string) le texte à lire en provenance du fichier

==== close ====
Fermer un fichier.

=== Syntaxe ===
<code javascript>
myObject.close();
</code>

=== Renvoie ===
  * (File) ce Fichier

==== copy ====
Copier ce fichier vers une autre destination.

=== Syntaxe ===
<code javascript>
myObject.copy(destination);
</code>
<code javascript>
myObject.copy(destination, options);
</code>

=== Arguments ===
  - destination - (string) la destination où doit être copié ce fichier
  - options - (object) [//Ajouté dans Actionaz 3.0.1.//]
    * noErrorDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une erreur est rencontrée ?(Windows seulement, défaut: vrai)
    * noConfirmDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une confirmation est requise ? (Windows seulement, défaut: vrai)
    * noProgressDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait en cours de progression (Windows seulement, défaut: vrai)
    * createDestinationDirectory - (bool) le chemin de destination devrait-il être créé s'il n'existe pas ? (Linux seulement, défaut: vrai)

=== Renvoie ===
  * (File) ce Fichier

=== Exceptions ===
  * (ParameterCountError) paramètre de compteur incorrect
  * (DirectoryCreationError) impossible de créer le répertoire de destination (Linux seulement)
  * (DirectoryDoesntExistError) le répertoire de destination n'existe pas (Linux seulement)
  * (CopyError) copie échouée
  * (CopyAbortedError) copy annulée (Windows seulement)

==== move ====
Déplacer un fichier vers une autre destination.

=== Syntaxe ===
<code javascript>
myObject.move(destination);
</code>
<code javascript>
myObject.move(destination, options);
</code>

=== Arguments ===
  - destination - (string) la destination où déplacer le fichier
  - options - (object) [//Ajouté dans Actionaz 3.0.1.//]
    * noErrorDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une erreur est rencontrée ?(Windows seulement, défaut: vrai)
    * noConfirmDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une confirmation est requise ? (Windows seulement, défaut: vrai)
    * noProgressDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait en cours de progression (Windows seulement, défaut: vrai)
    * createDestinationDirectory - (bool) le chemin de destination devrait-il être créé s'il n'existe pas ? (Linux seulement, défaut: vrai)

=== Renvoie ===
  * (File) ce Fichier

=== Exceptions ===
  * (ParameterCountError) paramètre de compteur incorrect
  * (DirectoryCreationError) impossible de créer le répertoire de destination (Linux seulement)
  * (DirectoryDoesntExistError) le répertoire de destination n'existe pas (Linux seulement)
  * (MoveError) déplacement échoué
  * (MoveAbortedError) déplacement annulé (Windows seulement)

==== rename ====
Cette méthode est un alias de la méthode [[#move1|move]] .

==== remove ====
Supprimer un fichier.

=== Syntaxe ===
<code javascript>
myObject.remove();
</code>
<code javascript>
myObject.remove(options);
</code>

=== Arguments ===
  - options - (object) [//Ajouté dans Actionaz 3.0.1.//]
    * noErrorDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une erreur est rencontrée ?(Windows seulement, défaut: vrai)
    * noConfirmDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait si une confirmation est requise ? (Windows seulement, défaut: vrai)
    * noProgressDialog - (bool) devrait-il y avoir une fenêtre de dialogue qui apparait en cours de progression (Windows seulement, défaut: vrai)
    * allowUndo - (bool) le fichier/dossier doit-il être envoyé vers la corbeille (Windows seulement, défaut: faux)

=== Renvoie ===
  * (File) ce Fichier

=== Exceptions ===
  * (ParameterCountError) paramètre de compteur incorrect
  * (RemoveError) suppression échouée
  * (RemoveAbortedError) suppression annulée (Windows seulement)

===== Enumerations =====

==== OpenMode ====
Mode ouverture de Fichier.

=== Values ===
  - ReadOnly: fichier ouvert pour lecture seule
  - WriteOnly: fichier ouvert pour écriture seule
  - ReadWrite: fichier ouvert pour lecture et écriture
  - Append: fichier ouvert pour une écriture à la fin de ce fichier
  - Truncate: fichier ouvert pour une écriture en effaçant tout le contenu précédent
  - Text: fichier ouvert en mode texte
  - Unbuffered: fichier ouvert en mode "unbuffered" (sans tampon)

=== Notes ===
C'est une suite d’indicateur, ce qui signifie que vous pouvez utilisez plusieurs valeurs en utilisant l'opérateur | .

Example:
<code javascript>
myObject.open("myfile.txt", File.WriteOnly | File.Append | File.Text);
</code>