getws または fgetws サブルーチン

目的

ストリームから文字列を取得します。

ライブラリー

標準入出力ライブラリー (libc.a)

構文

#include <stdio.h>

wchar_t *fgetws ( WString, Number, Stream) wchar_t *WString; int Number; FILE *Stream;

wchar_t *getws (WString)
wchar_t *WString;

説明

fgetws サブルーチンは、入力ストリームから文字を読み取り、それらを対応するワイド文字コードに変換して、 WString パラメーターが指す配列に入れます。サブルーチンは、 Number パラメーターで指定された文字数から 1 を引いた文字数が読み取られるか、サブルーチンが改行文字またはファイル終了文字を検出するまで継続します。 fgetws サブルーチンは、 WString パラメーターで指定されたワイド文字ストリングをヌル・ワイド文字で終了します。

getws サブルーチンは、標準入力ストリーム (stdin) によって指し示される入力ストリームから、 WString パラメーターによって指し示される配列にワイド文字を読み取ります。サブルーチンは、改行文字またはファイルの終わり文字を検出するまで継続し、その後、改行文字を破棄し、配列に読み込まれた最後の文字の後に NULL ワイド文字を配置します。

パラメーター

項目	説明
wstring	文字を受け取るストリングを指します。
stream	オープン・ファイルの FILE 構造体を指します。
Number	読み取る文字の最大数を指定します。

戻り値

getws または fgetws サブルーチンは、文字を読み取らずにファイルの終わりに達すると、文字を String パラメーターに転送せず、NULL ポインターを戻します。読み取りエラーが発生した場合、 getws または fgetws サブルーチンは NULL ポインターを戻し、エラーを示すために errno グローバル変数を設定します。

エラー・コード

ストリームがバッファーに入れられていないか、データをストリームのバッファーに読み取る必要があるために、 getws または fgetws サブルーチンが失敗した場合は、以下のエラー・コードの 1 つ以上が戻されます。

項目	説明
EAGAIN	Stream パラメーターの基礎となるファイル・ディスクリプターに対して O_NONBLOCK フラグが設定され、プロセスが fgetws サブルーチン内で遅延されることを示します。
EBADF	Stream パラメーターを指定するファイル記述子が読み取りアクセス・ファイルではないことを示します。
EINTR	シグナルを受信したために読み取り操作が終了し、データが転送されなかったか、または実装がこのファイルの部分的な転送を報告しないことを示します。
EIO	使用可能なストレージ・スペースが不足していることを示します。
ENOMEM	使用可能なストレージ・スペースが不足していることを示します。
EILSEQ	入力ストリームから読み取られたデータが有効な文字を形成しないことを示します。