fLitLigne (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français (historique)

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes

Gestion des erreurs
Position dans le fichier
Gestion ANSI/Unicode

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

fLitLigne (Fonction)

En anglais : fReadLine

Lit une ligne dans un fichier externe.

Dans cette version, il est possible uniquement de lire une ligne dans un fichier externe au format ANSI.

Exemple

Voir des exemples supplémentaires

// Ouverture d'un fichier externe
IDFichier est un entier
ResLecture est une chaîne
IDFichier = fOuvre("C:\MesRépertoires\Fichier.txt", foLectureEcriture)
SI IDFichier <> -1 ALORS
	// Lecture d'une ligne dans ce fichier
	ResLecture = fLitLigne(IDFichier)
	...
FIN

// Ouverture d'un fichier externe
MonFichierTxt est un FichierDisque
ResLecture est une chaîne
MonFichierTxt = fOuvre("C:\MesRépertoires\Fichier.txt", foLectureEcriture)
SI PAS ErreurDétectée ALORS
	// Lecture d'une ligne dans ce fichier
	ResLecture = fLitLigne(MonFichierTxt)
	...
FIN

Syntaxe

Lire chaque ligne d'un fichier Masquer les détails

<Résultat> = fLitLigne(<Fichier manipulé> [, <Séparateur>])

<Résultat> : Chaîne de caractères ou Chaîne de caractères Unicode

Ligne lue dans un fichier externe.
Constante EOT si la fin du fichier a été atteinte.
Chaîne vide ("") en cas d'erreur. Dans ce cas, la variable ErreurDétectée est mise à Vrai.
Remarque : Une ligne se termine par un retour chariot (RC).
Ce paramètre doit être de type chaîne de caractères.

<Fichier manipulé> : Entier ou variable de type FichierDisque

Identifiant du fichier à manipuler, défini avec la fonction fOuvre ou fCrée.
Nom de la variable de type FichierDisque initialisée avec la fonction fOuvre ou fCrée.
Non disponible.
Ce paramètre doit être de type variant.

<Séparateur> : Chaîne de caractères

Séparateur utilisé entre les lignes. Par défaut, le séparateur utilisé correspond au Retour-Chariot (RC).
Ce paramètre n'est pas disponible. Le séparateur utilisé correspond au Retour-Chariot (RC).

Lire chaque ligne d'un fichier via une procédure Masquer les détails

<Résultat> = fLitLigne(<Fichier manipulé> , <Procédure WLangage> [, <Séparateur>])

<Résultat> : Entier

Nombre de lignes lues.
Remarque : Une ligne se termine par un retour chariot (RC).

<Fichier manipulé> : Entier ou variable de type FichierDisque

Identifiant du fichier à manipuler, défini avec la fonction fOuvre ou fCrée.
Nom de la variable de type FichierDisque initialisée avec la fonction fOuvre ou fCrée.
Non disponible.
Ce paramètre doit être de type variant.

<Procédure WLangage> : Nom de procédure

Nom de la procédure WLangage (également nommée "callback") appelée pour chaque ligne lue dans le fichier. Cette procédure permet de manipuler la ligne en cours. Pour plus de détails sur cette procédure, consultez Paramètres de la procédure utilisée par la fonction fLitLigne.

<Séparateur> : Chaîne de caractères

Séparateur utilisé entre les lignes. Par défaut, le séparateur utilisé correspond au Retour-Chariot (RC).
Ce paramètre n'est pas disponible. Le séparateur utilisé correspond au Retour-Chariot (RC).

Remarques

Gestion des erreurs

La fonction fLitLigne génère une erreur dans les cas suivants :

le fichier n'est pas ouvert,
le fichier n'est pas accessible en lecture,
le fichier est bloqué par un autre poste ou par une autre application. La fonction fDébloque permet de débloquer un fichier externe.

Position dans le fichier

A l'ouverture d'un fichier, la position en cours correspond :

au premier octet du fichier (par défaut),
au dernier octet du fichier si le fichier est ouvert en "ajout" (constante foAjout).

Cette position peut être modifiée par la fonction fPositionne.

La fonction fLitLigne lit les éléments spécifiés à partir de la position en cours. Après l'exécution de fLitLigne, la position en cours correspond au dernier octet lu. La fonction fLitLigne retourne la constante EOT si la fin du fichier a été atteinte.

Gestion ANSI/Unicode

La fonction fLitLigne permet de lire :

une chaîne de type Unicode dans un fichier Unicode.
une chaîne de type Ansi dans un fichier Ansi.

Le fichier a été créé ou ouvert avec les fonctions fCrée/fOuvre en précisant le type du fichier.

Selon le format du fichier externe manipulé, certaines conversions sont nécessaires après la lecture d'une chaîne de caractères dans un fichier externe :


	Poste en cours	Fichier externe au format ANSI (fonction fOuvre ou fCrée avec la constante foAnsi)	Fichier externe au format Unicode (fonction fOuvre ou fCrée avec la constante foUnicode)
Fonction fLitLigne	PC sous Windows	Lecture au format ANSI Conversion possible en Unicode avec la fonction AnsiVersUnicode
	Mobile	Lecture au format Unicode Conversion possible en ANSI avec la fonction UnicodeVersAnsi

Remarque : Si le résultat de la fonction fLitLigne d'un fichier ANSI est affecté à une chaîne Unicode (et inversement), la conversion sera implicitement réalisée.

Pour plus de détails, consultez Gestion de l'Unicode

Liste des exemples associés :