_putc_nolock、_putwc_nolock
更新 : 2007 年 11 月
スレッドをロックすることなく、ストリームに文字を書き込みます。
int _putc_nolock(
int c,
FILE *stream
);
wint_t _putwc_nolock(
wchar_t c,
FILE *stream
);
パラメータ
c
書き込む文字。stream
FILE 構造体へのポインタ。
戻り値
putc、putwc を参照してください。
解説
_putc_nolock 関数と _putwc_nolock 関数は、他のスレッドからの干渉から保護されない点を除いて、_nolock サフィックスが付いていないバージョンと同じです。スレッドをロックアウトするオーバーヘッドがないため、この方が処理が早くなります。これらの関数は、シングルスレッド アプリケーションや、呼び出し元のスコープで既にスレッドの隔離が処理されている場合などの、スレッド セーフなコンテキストだけで使用します。
_putwc_nolock は _putc_nolock のワイド文字バージョンであり、ストリームが ANSI モードで開いている場合、この 2 つの関数の動作は同じです。現在 _putc_nolock では、UNICODE ストリームへの出力はサポートされていません。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_puttc_nolock |
_putc_nolock |
_putc_nolock |
_putwc_nolock |
必要条件
ルーチン |
必須ヘッダー |
---|---|
_putc_nolock |
<stdio.h> |
_putwc_nolock |
<stdio.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
使用例
// 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 );
}
出力
This is the line of output