getchar, getwchar

Lit un caractère à partir d’une entrée standard.

Syntaxe

int getchar();
wint_t getwchar();

Valeur retournée

Retourne le caractère lu. Ces fonctions attendent l’entrée et ne retournent pas tant que l’entrée n’est pas disponible.

Pour indiquer une erreur ou une condition de fin de fichier, getchar retourne EOF, tandis que getwchar retourne WEOF. Pour getchar, utilisez ferror ou feof pour tester la présence d’une erreur ou la fin du fichier.

Notes

Chaque routine lit un caractère à partir de stdin et incrémente le pointeur de fichier associé pour qu’il désigne le caractère suivant. getchar est identique à , mais il est implémenté en tant que _fgetcharfonction et en tant que macro.

Ces fonctions verrouillent également le thread appelant et sont thread-safe. Pour obtenir une version non verrouillée, consultez _getchar_nolock, _getwchar_nolock.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routines de texte générique

Spécifications

La console n’est pas prise en charge dans les applications de la plateforme Windows universelle (UWP). Les handles de flux standard associés à la console (stdin, stdout et stderr) doivent être redirigés pour que les fonctions de runtime C puissent les utiliser dans les applications UWP. Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

// crt_getchar.c
// Use getchar to read a line from stdin.

#include <stdio.h>

int main()
{
    char buffer[81];
    int i, ch;

    for (i = 0; (i < 80) && ((ch = getchar()) != EOF)
                         && (ch != '\n'); i++)
    {
        buffer[i] = (char) ch;
    }

    // Terminate string with a null character
    buffer[i] = '\0';
    printf( "Input was: %s\n", buffer);
}

This textInput was: This text

Voir aussi

E/S de flux
getc, getwc
fgetc, fgetwc
_getch, _getwch
putc, putwc
ungetc, ungetwc