Aide:FileReadLine.txt

Document original V3.3.6.1 :

###Function###
FileReadLine

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

###Syntax###
FileReadLine ( "filehandle/filename" [, line] )


###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.
line
	[optional] The line number to read.  The first line of a text file is line 1 (not zero), last line is -1.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns a line of text.
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###
Returns the text of the line read, any newline characters ( CHR(10) or @LF ) at the end of a line read in are automatically stripped.
If no line number to read is given, the "next" line will be read.  ("Next" for a newly opened file is initially the first line.)
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!

From a performance standpoint it is a bad idea to read line by line specifying "line" parameter whose value is incrementing by one. This forces AutoIt to reread the file from the beginning until it reach the specified line.

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


###Related###
IniRead, FileOpen, FileRead, FileWrite, FileWriteLine, FileSetPos, FileGetPos


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

Document traduit V3.3.6.1 :

FileReadLine

###Description###
Lire une ligne d'un texte à partir d'un fichier texte précédemment ouvert.

###Syntax###
FileReadLine ( "filehandle/filename" [, line] )


###Parameters###
@@ParamTable@@
filehandle/filename
	Le handle d'un fichier, comme renvoyé par un précédent par appel à FileOpen. Sinon, vous pouvez utiliser une chaine de caractères contenant le nom du fichier comme premier paramètre.
line
	[optionnel] Le numéro de ligne à lire. La première ligne d'un fichier texte est la ligne 1 (non nul), dernière ligne est -1.
@@End@@

###ReturnValue###
@@ReturnTable@@
Succès:	Retourne une ligne d'un texte.
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 d'autres erreurs.
@@End@@


###Remarks###
Retourne le texte de la ligne lue, toutes le nouveaux caractères de saut de ligne (CHR(10) ou @LF) à la fin d'une ligne lue en sont automatiquement supprimé.
Si aucun numéro de ligne à lire est donné, la "prochainne" en ligne sera lue. ("Prochainne" pour un fichier nouvellement ouvert est d'abord la première ligne.)
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 des 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!

Du point de vue performances, il est une mauvaise idée de lire ligne par ligne en spécifiant le paramètre dont la valeur est incrémenté par un. Cela oblige AutoIt à relire le fichier depuis le début jusqu'à ce qu'il atteignent la ligne spécifiée.

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


###Related###
IniRead, FileOpen, FileRead, FileWrite, FileWriteLine, FileSetPos, FileGetPos


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

Traducteur :TT22