OSDN Git Service

Update README
[linuxjm/LDP_man-pages.git] / release / man3 / stdio_ext.3
index 571b3fd..f851668 100644 (file)
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH STDIO_EXT 3 2001\-12\-16 "" "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI all rights reserved.
+.\" Translated Nov 2 2002 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\"O .SH NAME
+.\"O __fbufsize, __flbf, __fpending, __fpurge, __freadable,
+.\"O __freading, __fsetlocking, __fwritable, __fwriting, _flushlbf \-
+.\"O interfaces to stdio FILE structure
+.\"O .SH SYNOPSIS
+.\"O .SH DESCRIPTION
+.\"O Solaris introduced routines to allow portable access to the
+.\"O internals of the
+.\"O .I FILE
+.\"O structure, and glibc also implemented these.
+.\"O The
+.\"O .BR __fbufsize ()
+.\"O function returns the size of the buffer currently used
+.\"O by the given stream.
+.\"O The
+.\"O .BR __fpending ()
+.\"O function returns the number of bytes in the output buffer.
+.\"O For wide-oriented streams the unit is wide characters.
+.\"O This function is undefined on buffers in reading mode,
+.\"O or opened read-only.
+.\"O The
+.\"O .BR __flbf ()
+.\"O function returns a nonzero value if the stream is line-buffered,
+.\"O and zero otherwise.
+.\"O The
+.\"O .BR __freadable ()
+.\"O function returns a nonzero value if the stream allows reading,
+.\"O and zero otherwise.
+.\"O The
+.\"O .BR __fwritable ()
+.\"O function returns a nonzero value if the stream allows writing,
+.\"O and zero otherwise.
+.\"O The
+.\"O .BR __freading ()
+.\"O function returns a nonzero value if the stream is read-only, or
+.\"O if the last operation on the stream was a read operation,
+.\"O and zero otherwise.
+.\"O The
+.\"O .BR __fwriting ()
+.\"O function returns a nonzero value if the stream is write-only (or
+.\"O append-only), or if the last operation on the stream was a write
+.\"O operation, and zero otherwise.
+.\"O The
+.\"O .BR __fsetlocking ()
+.\"O function can be used to select the desired type of locking on the stream.
+.\"O It returns the current type.
+.\"O The
+.\"O .I type
+.\"O argument can take the following three values:
+.\"O Perform implicit locking around every operation on the given stream
+.\"O (except for the *_unlocked ones).
+.\"O This is the default.
+.\"O The caller will take care of the locking (possibly using
+.\"O .BR flockfile (3)
+.\"O in case there is more than one thread), and the stdio routines
+.\"O will not do locking until the state is reset to
+.\"O .BR FSETLOCKING_INTERNAL .
+.\"O Don't change the type of locking.
+.\"O (Only return it.)
+.\"O The
+.\"O .BR _flushlbf ()
+.\"O function flushes all line-buffered streams.
+.\"O (Presumably so that
+.\"O output to a terminal is forced out, say before reading keyboard input.)
+.\"O The
+.\"O .BR __fpurge ()
+.\"O function discards the contents of the stream's buffer.
+.\"O .SH "SEE ALSO"
+.\"
+.TH STDIO_EXT 3 2013\-06\-21 "" "Linux Programmer's Manual"
 .SH 名前
 __fbufsize, __flbf, __fpending, __fpurge, __freadable, __freading,
-__fsetlocking, __fwritable, __fwriting, _flushlbf \- 標準入出力ファイル構造体へのインタフェース
+__fsetlocking, __fwritable, __fwriting, _flushlbf \- æ¨\99æº\96å\85¥å\87ºå\8a\9bã\83\95ã\82¡ã\82¤ã\83«æ§\8bé\80 ä½\93ã\81¸ã\81®ã\82¤ã\83³ã\82¿ã\83¼ã\83\95ã\82§ã\83¼ã\82¹
 .SH 書式
 \fB#include <stdio.h>\fP
 .br
@@ -59,13 +131,13 @@ __fsetlocking, __fwritable, __fwriting, _flushlbf \- 標準入出力ファイル
 Solaris では、 \fIFILE\fP 構造体の内部へポータブルなかたちで アクセスできる手段が導入されており、これらは glibc
 でも実装されている。
 .LP
-\fB__fbufsize\fP()  関数は、指定されたストリームが使用しているバッファサイズを返す。
+\fB__fbufsize\fP()  é\96¢æ\95°ã\81¯ã\80\81æ\8c\87å®\9aã\81\95ã\82\8cã\81\9fã\82¹ã\83\88ã\83ªã\83¼ã\83 ã\81\8c使ç\94¨ã\81\97ã\81¦ã\81\84ã\82\8bã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\82µã\82¤ã\82ºã\82\92è¿\94ã\81\99ã\80\82
 .LP
-\fB__fpending\fP()  関数は、出力バッファに入っているデータのバイト数を返す。
\83¯ã\82¤ã\83\89ã\82­ã\83£ã\83©ã\82¯ã\82¿ã\82\92æ\89±ã\81\86ã\82¹ã\83\88ã\83ªã\83¼ã\83 ã\81®å ´å\90\88ã\80\81ã\83¯ã\82¤ã\83\89ã\82­ã\83£ã\83©ã\82¯ã\82¿å\8d\98ä½\8dã\81§è¨\88ç®\97ã\81\95ã\82\8cã\82\8bã\80\82 ã\83\90ã\83\83ã\83\95ã\82¡が読み出しモードの場合や読み出し専用で開かれている場合の
+\fB__fpending\fP()  é\96¢æ\95°ã\81¯ã\80\81å\87ºå\8a\9bã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81«å\85¥ã\81£ã\81¦ã\81\84ã\82\8bã\83\87ã\83¼ã\82¿ã\81®ã\83\90ã\82¤ã\83\88æ\95°ã\82\92è¿\94ã\81\99ã\80\82
\83¯ã\82¤ã\83\89ã\82­ã\83£ã\83©ã\82¯ã\82¿ã\83¼ã\82\92æ\89±ã\81\86ã\82¹ã\83\88ã\83ªã\83¼ã\83 ã\81®å ´å\90\88ã\80\81ã\83¯ã\82¤ã\83\89ã\82­ã\83£ã\83©ã\82¯ã\82¿ã\83¼å\8d\98ä½\8dã\81§è¨\88ç®\97ã\81\95ã\82\8cã\82\8bã\80\82 ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼が読み出しモードの場合や読み出し専用で開かれている場合の
 この関数の振舞いは未定義である。
 .LP
-\fB__flbf\fP()  関数は、ストリームがラインバッファの場合は 0 以外を、 それ以外の場合は 0 を返す。
+\fB__flbf\fP()  é\96¢æ\95°ã\81¯ã\80\81ã\82¹ã\83\88ã\83ªã\83¼ã\83 ã\81\8cã\83©ã\82¤ã\83³ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81®å ´å\90\88ã\81¯ 0 ä»¥å¤\96ã\82\92ã\80\81 ã\81\9dã\82\8c以å¤\96ã\81®å ´å\90\88ã\81¯ 0 ã\82\92è¿\94ã\81\99ã\80\82
 .LP
 \fB__freadable\fP()  関数は、ストリームが読み出し可能な場合は 0 以外を、 それ以外の場合は 0 を返す。
 .LP
@@ -91,13 +163,20 @@ Solaris では、 \fIFILE\fP 構造体の内部へポータブルなかたちで
 \fBFSETLOCKING_QUERY\fP
 ロック形式の変更を行わない。(現在の形式を返すだけである)
 .LP
-\fB_flushlbf\fP()  関数は、すべてのラインバッファ (line\-buffered) タイプのストリームの 内容を出力(フラッシュ)する。
+\fB_flushlbf\fP()  関数は、すべてのラインバッファ (line\-buffered) タイプのストリームの 内容を出力(フラッシュ)する。
 (当然ながら、端末への出力が強制的に行われることになるので、 キーボードからの入力を読みこむ前にこの関数を呼んだ方がいいだろう)
 .LP
-\fB__fpurge\fP()  関数は、ストリームのバッファの内容を廃棄する。
+\fB__fpurge\fP()  関数は、ストリームのバッファーの内容を廃棄する。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+関数 \fB__fbufsize\fP(), \fB__fpending\fP(), \fB__fpurge\fP(), \fB__fsetlocking\fP() は、
+ストリームのロックを行わない。 そのため、スレッドセーフではない。
+.LP
+関数 \fB__flbf\fP(), \fB__freadable\fP(), \fB__freading\fP(), \fB__fwritable\fP(),
+\fB__fwriting\fP(), \fB_flushlbf\fP() はスレッドセーフである。
 .SH 関連項目
 \fBflockfile\fP(3), \fBfpurge\fP(3)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.51 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。