_putc_nolock, _putwc_nolock

  • Artikel

Schreibt ein Zeichen in einen Datenstrom ohne zu sperren.

Syntax

int _putc_nolock(
   int c,
   FILE *stream
);
wint_t _putwc_nolock(
   wchar_t c,
   FILE *stream
);

Parameter

c
Zu schreibende Zeichen.

stream
Zeiger auf die FILE-Struktur.

Rückgabewert

Siehe putc, putwc.

Hinweise

_putc_nolock und _putwc_nolock sind identisch mit den Versionen ohne das Suffix _nolock, 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.

_putwc_nolock ist die Breitzeichenversion von _putc_nolock; die zwei Funktionen verhalten sich identisch, wenn der Stream im ANSI-Modus geöffnet ist. _putc_nolock unterstützt derzeit die Ausgabe in einen UNICODE-Stream nicht.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

Tchar.h-Routine _UNICODE und _MBCS nicht definiert _MBCS definiert _UNICODE definiert
_puttc_nolock _putc_nolock _putc_nolock _putwc_nolock

Anforderungen

Routine Erforderlicher Header
_putc_nolock <stdio.h>
_putwc_nolock <stdio.h> oder <wchar.h>

Die Konsole wird in UWP-Apps (Universelle Windows-Plattform) nicht unterstützt. Die mit der Konsole verknüpften Standardstreamhandles stdin, stdout und stderr müssen umgeleitet werden, bevor sie von C-Laufzeitfunktionen in UWP-Apps verwendet werden können. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Libraries

Alle Versionen der C-Laufzeitbibliotheken.

Beispiel

// crt_putc_nolock.c
/* This program uses putc to write buffer
* to a stream. If an error occurs, the program
* stops before writing the entire buffer.
*/

#include <stdio.h>

int main( void )
{
   FILE *stream;
   char *p, buffer[] = "This is the line of output\n";
   int  ch;

   ch = 0;
   /* Make standard out the stream and write to it. */
   stream = stdout;
   for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
      ch = _putc_nolock( *p, stream );
}

Output

This is the line of output

Weitere Informationen

Stream-E/A
fputc, fputwc
getc, getwc