getchar, getwchar

Artículo
06/09/2015

Lee un carácter de entrada estándar.

int getchar();
wint_t getwchar();

Valor devuelto

Devuelve el carácter leído. Para indicar un error de lectura o una condición de final de archivo, getchar devuelve returns EOF y getwchar devuelve WEOF. En el caso de getchar, use ferror o feof para comprobar si hay un error o una condición de fin de archivo.

Comentarios

Cada rutina lee un solo carácter de stdin y aumenta el puntero de archivo asociado para que señale al carácter siguiente. getchar es igual que _fgetchar, pero se implementa como función y como macro.

Estas funciones bloquean el subproceso de llamada y son, por consiguiente, seguras para subprocesos. Para consultar una versión que no realiza el bloqueo, vea _getchar_nolock, _getwchar_nolock.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_gettchar	getchar	getchar	getwchar

Requisitos

Rutina	Encabezado necesario
getchar	<stdio.h>
getwchar	<stdio.h> o <wchar.h>

La consola no se admite en las aplicaciones de Tienda Windows. Se deben redirigir los identificadores estándar de flujo que están asociados a la consola, stdin, stdout y stderr, antes de que las funciones en tiempo de ejecución de C puedan usarlos en aplicaciones de Tienda Windows. Para obtener más información sobre compatibilidad, vea Compatibilidad.

Ejemplo

// 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);
}