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 routine de texte générique

TCHAR.H Routine	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_gettchar	getchar	getchar	getwchar

Spécifications

Routine	En-tête requis
getchar	<stdio.h>
getwchar	<stdio.h> ou <wchar.h>

La console n’est pas prise en charge dans les applications plateforme Windows universelle (UWP). Les handles de flux standard associés à la console, stdinet stdoutstderrdoivent être redirigés avant que les fonctions d’exécution 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