日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
STDIO(3) FreeBSD ライブラリ関数マニュアル STDIO(3) 名称 stdio -- 標準入力/出力ライブラリ関数 ライブラリ 標準 C ライブラリ (libc, -lc) 書式 #include <stdio.h> FILE *stdin; FILE *stdout; FILE *stderr; 解説 標準 I/O ライブラリは、簡単で、効率的なバッファリングされたストリームの I/O インタフェースを提供しています。入力と出力は、論理的なデータストリー ムにマップされ、物理的な I/O 特性は、隠されます。関数とマクロは、以下にリ ストされています。より多くの情報は、個別のマニュアルページで利用可能で す。 ストリームは、新しいファイルを作成することを含んで、ファイルをオープンす ることによって (物理的なデバイスであるかもしれない) 外部のファイルと関連 付けられます。既存のファイルを作成することによって、その以前の内容は、破 棄されます。ファイルが、(端末と反対のディスクファイルのように) 位置づけ要 求をサポートできるなら、ストリームに関連付けられたファイル位置指示子は、 ファイルが追加モードでオープンされていないなら、ファイルの先頭 (バイト 0) に位置付けられます。追加モードが使用されるなら、位置指示子は、ファイルの 終りに置かれます。位置指定子は、その後の読み込み、書き込みと位置付け要求 によって維持されます。すべての入力は、あたかも文字が、fgetc(3) 関数への次 に続く呼び出しによって読み込まれたかのように起こります。すべての出力は、 あたかもすべての文字が、fputc(3) 関数への次に続く呼び出しによって書き込ま れたかのように起こります。 ファイルは、ファイルをクローズすることによってストリームから分離されま す。出力ストリームは、ストリームがファイルから分離される前に、(少しも書き 込まれなかったバッファ内容がホスト環境に転送され) フラッシュされます。 FILE オブジェクトへのポインタの値は、ファイルがクローズされた後に、確定さ れない (ごみ) です。 ファイルは、同じか、または別のプログラムの実行によって、その後に再オープ ンされ、(最初に再位置付けすることができるなら) その内容は、再要求される か、または修正されます。main 関数がそのオリジナルの呼び出し側に返るか、ま たは exit(3) 関数が呼び出されるなら、すべてのオープンしているファイルは、 プログラム終了の前に、クローズされます (従って、すべての出力ストリーム は、フラッシュされます)。プログラム終了の他の方法は、ファイルを適切にク ローズせず、そのために、バッファリングされた出力は、失われるかもしれませ ん。特に、_exit(2) は、stdio ファイルをフラッシュしません。どちらもシグナ ルのために終了しません。バッファは、POSIX によって要求されるように abort(3) によってフラッシュされますが、以前の実装は、行いませんでした。 この実装は、``text'' と ``binary'' ストリームを区別しません。実際に、すべ てのストリームは、バイナリです。あらゆるストリームで、変換は、実行され ず、特別なパディングは、現れません。 プログラムのスタートアップで、3 つのストリームが、あらかじめ定義され、明 示的にオープンされる必要は、ありません: • 標準入力 (標準となった入力を読み込むために)、 • 標準出力 (標準となった出力を書き込むために) と • 標準エラー (診断の出力を書き込むために)。 これらのストリームは、stdin, stdout と stderr と短縮されます。始めに、標 準エラーストリームは、バッファリングされていません。標準入力と出力スト リームは、ストリームが isatty(3) 関数によって決定されるように対話型または ``terminal'' デバイスを参照しない時かつその時に限り、完全にバッファリング されます。実際に、端末デバイスを参照するすべての新しくオープンされるスト リームは、行単位のバッファリングをデフォルトとし、そのようなストリームへ の保留中の出力は、そのような入力ストリームが読み込まれるときはいつでも、 自動的に書き込まれます。これは、``true reads'' (本当の読み込み) のためだ け適用することに注意してください。既存のバッファリングされたデータによっ て、読み込み要求を、満たすことができるなら、自動的なフラッシュは、起こり ません。これらの場合に、または出力端末の行の印刷部分の後で大量の計算が行 われるとき、それは、終了する前に、出力が現れることができるように計算し て、標準出力を fflush(3) (フラッシュ) する必要があります。代わりに、これ らのデフォルトは、setvbuf(3) 関数によって修正されます。 stdio ライブラリは、ライブラリ libc の一部であり、ルーチンは、C コンパイ ラによって必要に応じて自動的にロードされます。次のマニュアルページの「書 式」セクションは、どのインクルードファイルが使用されるか、関数のためのコ ンパイラ宣言がどのように見えるか、そして、どの外部変数が関係しているかを 示しています。 次は、マクロとして定義されます。これらの名前は、最初に #undef で、それら の現在の定義を削除せずに再使用できません: BUFSIZ, EOF, FILENAME_MAX, FOPEN_MAX, L_ctermid, L_cuserid, L_tmpnam, NULL, P_tmpdir, SEEK_CUR, SEEK_END, SEEK_SET, TMP_MAX, clearerr, clearerr_unlocked, feof, feof_unlocked, ferror, ferror_unlocked, fileno, fileno_unlocked, fropen, fwopen, getc, getc_unlocked, getchar, getchar_unlocked, putc, putc_unlocked, putchar, putchar_unlocked, stderr, stdin と stdout。マクロ 関数 clearerr, clearerr_unlocked, feof, feof_unlocked, ferror, ferror_unlocked, fileno, fileno_unlocked, getc, getc_unlocked, getchar, getchar_unlocked, putc, putc_unlocked, putchar と putchar_unlocked の関数 バージョンは、存在し、マクロの定義が明示的に削除されるなら、使用されま す。 関連項目 close(2), open(2), read(2), write(2) 規格 stdio ライブラリは、ISO/IEC 9899:1999 (``ISO C99'') に適合しています。 関数一覧 関数 説明 asprintf 書式付き出力変換 clearerr ストリーム状態をチェックして、リセットする dprintf 書式付き出力変換 fclose ストリームをクローズする fdopen ストリームをオープンする関数 feof ストリーム状態をチェックして、リセットする ferror ストリーム状態をチェックして、リセットする fflush ストリームをフラッシュする fgetc 入力ストリームから次の文字またはワードを取得する fgetln ストリームから 1 行を取得する fgetpos ストリームの再位置付け fgets ストリームから 1 行を取得する fgetwc 入力ストリームから次のワイド文字を取得する fgetws ストリームからワイド文字の 1 行を取得する fileno ストリーム状態をチェックして、リセットする fopen ストリームをオープンする関数 fprintf 書式付き出力変換 fpurge ストリームをフラッシュする fputc 1 文字または 1 ワードをストリームに出力する fputs 1 行をストリームに出力する fputwc ワイド文字をストリームに出力する fputws ワイド文字の 1 行をストリームに出力する fread バイナリストリームの入力/出力 freopen ストリームをオープン関数 fropen ストリームをオープンする fscanf 書式付き入力変換する fseek ストリームを再位置付ける fsetpos ストリームを再位置付ける ftell ストリームを再位置付ける funopen ストリームをオープンする fwide ストリームのオリエンテーションを設定/取得する fwopen ストリームをオープンする fwprintf 書式付きワイド文字出力変換 fwrite バイナリストリームの入力/出力 getc 入力ストリームから次の文字またはワードを取得する getchar 入力ストリームから次の文字またはワードを取得する getdelim ストリームから 1 行を取得する getline ストリームから 1 行を取得する gets ストリームから 1 行を取得する getw 入力ストリームから次の文字またはワードを取得する getwc 入力ストリームから次のワイド文字を取得する getwchar 入力ストリームから次のワイド文字を取得する mkdtemp ユニークなテンポラリディレクトリを作成する mkstemp ユニークなテンポラリファイルを作成する mktemp ユニークなテンポラリファイルを作成する perror システムエラーメッセージ printf 書式付き出力変換 putc 1 文字またはワードをストリームに出力する putchar 1 文字またはワードをストリームに出力する puts 1 行をストリームに出力する putw 1 文字またはワードをストリームに出力する putwc 1 つのワイド文字をストリームに出力する putwchar 1 つのワイド文字をストリームに出力する remove ディレクトリエントリを削除する rewind ストリームの再位置付ける scanf 書式付き入力変換 setbuf ストリームのバッファリング操作 setbuffer ストリームのバッファリング操作 setlinebuf ストリームのバッファリング操作 setvbuf ストリームのバッファリング操作 snprintf 書式付き出力変換 sprintf 書式付き出力変換 sscanf 入力書式変換 strerror システムエラーメッセージ swprintf 書式付きワイド文字出力変換 sys_errlist システムエラーメッセージ sys_nerr システムエラーメッセージ tempnam テンポラリファイルルーチン tmpfile テンポラリファイルルーチン tmpnam テンポラリファイルルーチン ungetc 入力ストリームに文字を戻す ungetwc 入力ストリームにワイド文字を戻す vasprintf 書式付き出力変換 vdprintf 書式付き出力変換 vfprintf 書式付き出力変換 vfscanf 入力書式変換 vfwprintf 書式付きワイド文字出力変換 vprintf 書式付き出力変換 vscanf 書式変換の入力 vsnprintf 書式付き出力変換 vsprintf 書式付き出力変換 vsscanf 入力書式変換 vswprintf 書式付きワイド文字出力変換 vwprintf 書式付きワイド文字出力変換 wprintf 書式付きワイド文字出力変換 バグ 標準のバッファリングされた関数は、特定の他のライブラリとシステム関数、特 に vfork(2) とうまく交信されません。 FreeBSD 11.4 March 3, 2009 FreeBSD 11.4