_ungetc_nolock, _ungetwc_nolock

Schiebt ein Zeichen zurück auf den Stream.

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

Parameter

  • c
    Zu verschiebendes Zeichen.

  • stream
    Zeiger zur FILE-Struktur.

Rückgabewert

Bei Erfolg gibt jede dieser Funktionen das Zeichenargument c zurück. Wenn c nicht zurückgeschoben werden kann oder wenn kein Zeichen gelesen wurde, bleibt der Eingabestream unverändert und _ungetc_nolock gibt EOF zurück. _ungetwc_nolock gibt WEOF zurück. Wenn streamNULL ist, wird EOF oder WEOF zurückgegeben und errno ist auf EINVAL festgelegt.

Weitere Informationen über diese und andere Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.

Hinweise

Diese Funktionen sind nicht sperrende Versionen von ungetc und ungetwc. Die Versionen mit dem _nolock-Suffix sind identisch, allerdings sind sie nicht vor Störungen durch andere Threads geschützt. Sie sind möglicherweise schneller, da kein Mehraufwand zur Sperrung anderer Threads erforderlich ist. Verwenden Sie diese Funktionen nur in threadsichere Kontexten wie z. B. in Singlethreadanwendungen oder in Fällen, in denen der aufrufende Bereich die Threadisolation bereits handhabt.

Zuordnung generischer Textroutinen

TCHAR.H-Routine

_UNICODE & _MBCS nicht definiert

_MBCS definiert

_UNICODE definiert

_ungettc_nolock

_ungetc_nolock

_ungetc_nolock

_ungetwc_nolock

Anforderungen

Routine

Erforderlicher Header

_ungetc_nolock

<stdio.h>

_ungetwc_nolock

<stdio.h> oder <wchar.h>

Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

.NET Framework-Entsprechung

Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.

Siehe auch

Referenz

Stream-E/A

getc, getwc

putc, putwc