fLitLigne (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Fonctions de gestion des fichiers externes

Position dans le fichier

Gestion ANSI/UNICODE

Exemples associés

Voir aussi

Constantes des fichiers externes

Fonctions de gestion des fichiers externes

Manipulez des fichiers externes

Stockage de fichiers sous Android

Tableau récapitulatif : Gestion des répertoires de l'application selon la plateforme

fAjouteBuffer

fAjouteTexte

fAttribut

fAttributLectureSeule

fCopieFichierRépertoireWeb

fDétecteStockageAmovible

fLitLigneExpressionRégulière

fRepDonnéesUtilisateur

fRepGlobalUtilisateur

fSupprimeFichierRépertoireWeb

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.

Quel que soit le format du fichier externe, la chaîne de caractères lue est au format UNICODE.

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

Versions 15 et supérieures

Cette fonction est désormais disponible pour les applications Android.

Nouveauté 15

Cette fonction est désormais disponible pour les applications Android.

Versions 16 et supérieures

Cette fonction est désormais disponible pour les applications Windows Phone.

Nouveauté 16

Cette fonction est désormais disponible pour les applications Windows Phone.

Versions 17 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 17

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 18 et supérieures

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Nouveauté 18

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Versions 21 et supérieures

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Nouveauté 21

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Exemple

Voir des exemples supplémentaires

// Ouverture d'un fichier externe
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
IDFichier = fOuvre("\MesRépertoires\Fichier.txt", foLectureEcriture)
SI IDFichier <> -1 ALORS
// Lecture d'une ligne dans ce fichier
ResLecture = fLitLigne(IDFichier)
...
FIN

Syntaxe

<Résultat> = fLitLigne(<Identifiant du fichier> [, <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.

<Identifiant du fichier> : Entier

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

<Séparateur> : Chaîne de caractères (avec ou sans guillemets)

Versions 17 et supérieures
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).
Nouveauté 17
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).
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
	Pocket PC	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 :