getws ou fgetws Sous-routine

Objectif

Obtient une chaîne d'un flux.

Bibliothèque

Bibliothèque d'E-S standard (libc.a)

Syntaxe

#include <stdio.h>

wchar_t *getws (WString)
wchar_t *WString;

Descriptif

La sous-routine fgetws lit les caractères du flux d'entrée, les convertit en codes de caractères larges correspondants et les place dans le tableau désigné par le paramètre WString . La sous-routine se poursuit jusqu'à ce que le nombre de caractères spécifié par le paramètre Nombre moins 1 soit lu ou que le sous-programme rencontre un caractère de nouvelle ligne ou de fin de fichier. La sous-routine fgetws met fin à la chaîne de caractères large spécifiée par le paramètre WString avec un caractère large null.

La sous-routine getws lit les caractères larges du flux d'entrée désigné par le flux d'entrée standard (stdin) dans le tableau désigné par le paramètre WString . La sous-routine continue jusqu'à ce qu'elle rencontre une nouvelle ligne ou le caractère de fin de fichier, puis elle supprime tout caractère de nouvelle ligne et place un caractère de largeur NULL après le dernier caractère lu dans le tableau.

Paramètres

Valeurs renvoyées

Si la sous-routine getws ou fgetws atteint la fin du fichier sans lire de caractères, elle ne transfère aucun caractère au paramètre String et renvoie un pointeur null. Si une erreur de lecture se produit, la sous-routine getws ou fgetws renvoie un pointeur null et définit la variable globale errno pour indiquer l'erreur.

Codes d'erreur

Si la sous-routine getws ou fgetws échoue car le flux n'est pas mis en mémoire tampon ou que des données doivent être lues dans la mémoire tampon du flux, elle renvoie un ou plusieurs des codes d'erreur suivants: