FGETS

Icône du lien vers le conceptVoir également

Lit une chaîne de caractères dans un fichier.

Support WebVue - Oui.

Avant d'utiliser une des instructions de gestion de fichiers, exceptés FSTAT, RENAME, UNLINK, FILETOBUF ou BUFTOFILE, vous devez ouvrir en premier lieu le fichier en utilisant l'instruction FOPEN.

A la fin de chaque programme utilisant une instruction FOPEN vous devez exécuter l’instruction FCLOSE.

Syntaxe

StrVal = FGETS(Filename, Num);

Type de retour : STR

Argument

Définition

Filename

Nom du fichier dans lequel la chaîne de caractères doit être lue. Type STR.
Si exécutée dans le contexte d'une session WebVue, cette instruction est traitée par le back end web, en conséquence de quoi le fichier doit exister sur la machine back end web.

Num

Nombre de caractères à lire. Tout type numérique.

Exécution

StrVal

Le nombre spécifié de caractères est lu et retourné dans une chaîne.

Si la fin du fichier est atteinte avant que le nombre de caractères soit retourné, ou qu'un caractère "Retour à la ligne" soit trouvé, la chaîne de retour sera tronquée en conséquence. Le pointeur de fichier avance du nombre de caractères lus.

Exemple

str1 = FGETS("HELP.TXT",20);