fputs

int fputs( const char* str, FILE* stream );

int fputs( const char* restrict str, FILE* restrict stream );

で定義されています。ヌル終端文字列 str の各文字を出力ストリーム stream に書き込みます。あたかも fputc を繰り返し実行するかのように動作します。

str の終端のヌル文字は書き込まれません。

引数

戻り値

成功した場合は、非負の値を返します。

失敗した場合は、EOF を返し、エラー指示子を設定します (ferror() を参照) 。そのエラー指示子は stream に設定されます。

ノート

関連関数 puts は出力に改行文字を追加しますが、fputs は文字列を変更せずに書き込みます。

実装によって返される非負の数値は異なります。最後に書き込まれた文字を返すもの、書き込まれた文字数を返すもの（文字列がそれより長い場合は INT_MAX を返す）、単に 0 などの非負定数を返すものがあります。

例

#include <stdio.h>
 
int main(void)
{
    int rc = fputs("Hello World", stdout);

    if (rc == EOF)
       perror("fputs()"); // POSIX requires that errno is set
}

Hello World

参考文献

関連項目