OpenVMS マニュアル

fgetc_unlocked (Integrity, Alpha)

fgetc関数と同様ですが， flockfileと funlockfileで保護された範囲内だけで使用します。

形式

#include <stdio.h>

int fgetc_unlocked (FILE *file_ptr);

引数

file_ptr

ファイル・ポインタ。

説明

リエントラント版である fgetc関数は，複数スレッドからの同時呼び出しに対してロックされます。その結果，ストリームの一貫性を保証するためのオーバヘッドが生じます。アンロック版である fgetc_unlockedを使用すると，このオーバヘッドを避けることができます。 fgetc_unlocked関数は fgetc関数と機能的に同じですが， fgetc_unlockedは flockfile関数と funlockfile関数を対で使用して保護された範囲内でだけ安全に使用することができる点で異なります。呼び出し元は， fgetc_unlockedを使用する前に，ストリームを確実にロックする必要があります。

__UNIX_PUTC マクロを定義してコンパイルすれば，この関数の高速インライン版を使用して，最適化できます。

getc_unlocked， flockfile， ftrylockfile，および funlockfileも参照してください。

戻り値

n	返された文字。
EOF	ファイルの終端 (EOF) またはエラーを示します。