Aide:FileRead.txt

Document original V3.3.6.1 :

###Function###
FileRead

###Description###
Read in a number of characters from a previously opened text file.

###Syntax###
FileRead ( "filehandle/filename" [, count] )


###Parameters###
@@ParamTable@@
filehandle/filename
	The handle of a file, as returned by a previous call to FileOpen.  Alternatively you may use a string filename as the first parameter.
count
	[optional] The number of characters to read. Default read the entire file.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns the binary/string read. @extended is set to the number of bytes/characters returned.
Special:	Sets @error to -1 if end-of-file is reached.
Failure:	Sets @error to 1 if file not opened in read mode or other error.
@@End@@


###Remarks###
If a filename is given rather than a file handle - the file will be opened and closed during the function call - for parsing large text files this will be much slower than using filehandles.
Note: Do not mix filehandles and filenames, i.e., don't FileOpen a file and then use a filename in this function.  Use either filehandles or filenames in your routines, not both!

Both ANSI and UTF16/UTF8 text formats can be read - AutoIt will automatically determine the type.

A file can be read as binary(byte) data by using FileOpen with the binary flag - in this case count is in bytes rather than characters.


###Related###
FileOpen, FileReadLine, FileWrite, FileWriteLine, String, FileSetPos, FileGetPos


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

Document traduit V3.3.6.1 :

###Function###
FileRead

###Description###
Lit un certain nombre de caractères à partir d'un fichier texte précédemment ouvert.

###Syntax###
FileRead ( "filehandle/filename" [, count] )


###Parameters###
@@ParamTable@@
filehandle/filename
	Le handle d'un fichier, comme renvoyé par l'utilisation de FileOpen. Sinon, vous peuvent utiliser une chaine de caractères contenant le nom du fichier comme premier paramètre.
count
	[optionnel] Le nombre de caractères à lire. Par défaut lire le fichier entier.
@@End@@

###ReturnValue###
@@ReturnTable@@
Succès:	Retourne le binaire/la chaine de caractères lue. @extended est défini sur le nombre d'octets/de caractères retournés.
Spécial:	Définit @error à -1 si la fin de fichier est atteinte.
Échec:	Définit @error à 1 si le fichier n'est pas ouvert en mode lecture ou pour les autres erreurs.
@@End@@


###Remarks###
Si un nom de fichier est donné plutôt qu'un handle de fichier - le fichier sera ouvert et fermé durant l'appel de fonction - pour analyser des fichiers texte de grande taille ce sera beaucoup plus lent que d'utiliser des handles de fichiers.
Remarque: Ne pas mélanger les handles de fichiers et noms de fichiers, c'est à dire, ne pas utiliser FileOpen pour un fichier, puis utiliser un nom de fichier dans cette fonction. Utilisez soit des handles de fichiers soit des noms de fichiers dans votre routine, mais pas les deux!

Les deux formats de texte ANSI et UTF16/UTF8 peuvent être lus - AutoIt va automatiquement déterminer le type.

Un fichier peut être lu comme binaire (octet) de données en utilisant FileOpen avec l'option binaire - dans ce cas le comptage est en octets plutôt qu'en caractères.


###Related###
FileOpen, FileReadLine, FileWrite, FileWriteLine, String, FileSetPos, FileGetPos


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

Traducteur :TT22