gets - Lit une ligne à partir d'un canal

SYNTAXE

 gets channelId ?varName?

DESCRIPTION

Cette commande lit la ligne suivante à partir channelId, retourne toute la ligne jusqu’à (non inclus) le(s) caractère(s) fin de ligne et écarte le(s) caractère(s) fin de ligne. Si varName est omise la ligne est renvoyée comme résultat de la commande. Si varName est spécifié alors la ligne est placée dans la variable sous son nom et la valeur de retour est un compte du nombre de caractères renvoyés.

Si une fin de fichier se produit pendant la recherche d'une fin de ligne, la commande retourne toute entrée disponible jusqu’à la fin du fichier. Si channelId est en mode non bloquant et qu'il n'y a pas une ligne complète disponible, la commande retourne une chaîne vide et ne consomme plus aucune entrée. Si varName est spécifié et qu'une chaîne vide est renvoyée dans varName parce que la fin de fichier est atteinte ou à cause de données insuffisantes en mode non bloquant, alors le compte retourné est -1. Notez que si varName n'est pas spécifiée alors les cas de fin-de-fichier et de pas-de-ligne-complète-disponible peuvent produire les mêmes résultats que si on avait entré une ligne consistant seulement du caractère fin de ligne. Les commandes eof et fblocked peuvent être utilisées pour distinguer ces trois cas

VOIR ÉGALEMENT

eof, fblocked

Mis à jour le 19 septembre 2012 à 12:55 CEST par Stéphane Aulery