_fputc_nolock、_fputwc_nolock
更新 : 2007 年 11 月
スレッドをロックすることなく、ストリームに文字を書き込みます。
int _fputc_nolock(
int c,
FILE *stream
);
wint_t _fputwc_nolock(
wchar_t c,
FILE *stream
);
パラメータ
c
書き込む文字。stream
FILE 構造体へのポインタ。
戻り値
これらの各関数は、書き込まれた文字を返します。エラーについては、「fputc、fputwc」を参照してください。
解説
_fputc_nolock と _fputwc_nolock は、他のスレッドからの干渉から保護されない点を除いて、それぞれ fputc および fputwc と同じです。スレッドをロックアウトするオーバーヘッドがないため、この方が処理が早くなります。これらの関数は、シングルスレッド アプリケーションや、呼び出し元のスコープで既にスレッドの隔離が処理されている場合などの、スレッド セーフなコンテキストだけで使用します。
ストリームが ANSI モードで開かれている場合、この 2 つの関数の動作は同じになります。_fputc_nolock では、現在、UNICODE ストリームへの出力がサポートされていません。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_fputtc_nolock |
_fputc_nolock |
_fputc_nolock |
_fputwc_nolock |
必要条件
関数 |
必須ヘッダー |
---|---|
_fputc_nolock |
<stdio.h> |
_fputwc_nolock |
<stdio.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_fputc_nolock.c
// This program uses _fputc_nolock
// to send a character array to stdout.
#include <stdio.h>
int main( void )
{
char strptr1[] = "This is a test of _fputc_nolock!!\n";
char *p;
// Print line to stream using fputc.
p = strptr1;
while( (*p != '\0') && _fputc_nolock( *(p++), stdout ) != EOF ) ;
}
This is a test of _fputc_nolock!!