FIO40-C. fgets() が失敗したときは引数に渡した配列の内容をリセットする

C99 によれば、fgets() 関数が読み取りに失敗すると、引数に渡した配列の内容は不定となる。したがって、それ以降に呼び出す文字列操作関数でエラーが発生するのを避けるために、配列の内容を既知の値にリセットしなければならない。

fgetws() 関数にも同様の問題がある。

以下のコード例では、fgets() が読み取りに失敗するとエラーフラグを設定する。

char buf[BUFSIZ];
FILE *file;
/* file を初期化する */

if (fgets(buf, sizeof(buf), file) == NULL) {
  /* エラーフラグを設定し、処理を続行する */
}

しかし、buf はリセットされておらず、その内容は不定である。

以下の解決法では、fgets が読み取りに失敗した場合 buf は空の文字列に設定される。fgetws() の場合も同様に、buf に空のワイド文字列を設定することで問題を解決できる。

char buf[BUFSIZ];
FILE *file;
/* file を初期化する */

if (fgets(buf, sizeof(buf), file) == NULL) {
  /* エラーフラグを設定し、処理を続行する */
  *buf = '\0';
}

FIO40-EX1: fgets() や fgetws() を呼び出した直後に配列がスコープ外になる場合や、読み取りに失敗した後に配列が参照されないのであれば、配列の内容をリセットする必要はない。

fgets や fgetws() が変更する配列の内容について誤った想定をすると、未定義の動作が発生したりプログラムが異常終了する可能性がある。

ルール	深刻度	可能性	修正コスト	優先度	レベル
FIO40-C	低	中	中	P4	L3

[ISO/IEC 9899:1999] Section 7.19.7.2, "The fgets Function" and Section 7.24.3.2, "the fgetws Function"

これは以下のページを翻訳したものです。