_ungetc_nolock, _ungetwc_nolock_ungetc_nolock, _ungetwc_nolock

Vuelve a insertar un carácter en el flujo.Pushes a character back onto the stream.

SintaxisSyntax

int _ungetc_nolock(
   int c,
   FILE *stream
);
wint_t _ungetwc_nolock(
   wint_t c,
   FILE *stream
);

ParámetrosParameters

unidadc
Carácter que se va a devolver.Character to be pushed.

misionesstream
Puntero a la estructura FILE.Pointer to FILE structure.

Valor devueltoReturn Value

Si es correcto, cada una de estas funciones devuelve el argumento de carácter c.If successful, each of these functions returns the character argument c. Si c no se puede volver a insertar o si no se ha leído ningún carácter, el flujo de entrada no cambia y _ungetc_nolock devuelve EOF; _ungetwc_nolock devuelve WEOF.If c cannot be pushed back or if no character has been read, the input stream is unchanged and _ungetc_nolock returns EOF; _ungetwc_nolock returns WEOF. Si Stream es null, se devuelve EOF o WEOF y errno se establece en EINVAL.If stream is NULL, EOF or WEOF is returned and errno is set to EINVAL.

Para obtener información sobre estos y otros códigos de error, vea _doserrno, errno, _sys_errlist y _sys_nerr.For information on these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

ObservacionesRemarks

Estas funciones son versiones que no son de bloqueo de ungetc y ungetwc.These functions are non-locking versions of ungetc and ungetwc. Las versiones que tienen el sufijo _nolock son idénticas, salvo que no están protegidas contra las interferencias de otros subprocesos.The versions with the _nolock suffix are identical except that they are not protected from interference by other threads. Pueden ser más rápidas, porque no incurren en la sobrecarga de bloquear otros subprocesos.They may be faster since they do not incur the overhead of locking out other threads. Use estas funciones solo en contextos seguros para subprocesos como aplicaciones de un único subproceso o donde el ámbito de llamada ya controle el aislamiento de subprocesos.Use these functions only in thread-safe contexts such as single-threaded applications or where the calling scope already handles thread isolation.

De forma predeterminada, el ámbito de este estado global de esta función es la aplicación.By default, this function's global state is scoped to the application. Para cambiar esto, vea estado global en CRT.To change this, see Global state in the CRT.

Asignaciones de rutina de texto genéricoGeneric-Text Routine Mappings

Rutina TCHAR.HTCHAR.H routine _UNICODE y _MBCS no definidos_UNICODE & _MBCS not defined _MBCS definido_MBCS defined _UNICODE definido_UNICODE defined
_ungettc_nolock_ungettc_nolock _ungetc_nolock_ungetc_nolock _ungetc_nolock_ungetc_nolock _ungetwc_nolock_ungetwc_nolock

RequisitosRequirements

RutinaRoutine Encabezado necesarioRequired header
_ungetc_nolock_ungetc_nolock <stdio.h><stdio.h>
_ungetwc_nolock_ungetwc_nolock <stdio.h> o <wchar.h><stdio.h> or <wchar.h>

Para obtener información adicional sobre compatibilidad, consulte Compatibilidad.For additional compatibility information, see Compatibility.

Consulta tambiénSee also

E/S de secuenciaStream I/O
getc, getwcgetc, getwc
putc, putwcputc, putwc