.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Updated, aeb, 980809
+.\"*******************************************************************
.\"
-.\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
-.\" all rights reserved.
-.\" Translated Tue Dec 16 19:43:01 JST 1997
-.\" by HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
-.\" Updated & Modified Mon Mar 1 1999
-.\" by NAKANO Takeo <nakano@apm.seikei.ac.jp>
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH CATGETS 3 1998-08-09 "" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH CATGETS 3 1998\-08\-09 "" "Linux Programmer's Manual"
.SH 名前
catgets \- メッセージカタログからメッセージを取り出す
.SH 書式
.nf
-.B #include <nl_types.h>
+\fB#include <nl_types.h>\fP
-.BI "char *catgets(nl_catd " catalog ", int " set_number \
-", int " message_number ,
-.BI " const char *" message );
+\fBchar *catgets(nl_catd \fP\fIcatalog\fP\fB, int \fP\fIset_number\fP\fB, int \fP\fImessage_number\fP\fB,\fP
+\fB const char *\fP\fImessage\fP\fB);\fP
.fi
.SH 説明
-.BR catgets ()
-は catalog で指定されたメッセージカタログから、
-セット
-.I set_number
-のメッセージ
-.I message_number
-を読み取る。
-.I catalog
-は、
-.BR catopen (3)
-の呼び出しによって得られたカタログ
-ディスクリプタを指定する。
-4番目の引数
-.I message
-は、指定のメッセージカタログが現在利用できない
-場合に
-.BR catgets ()
-が返すデフォルトのメッセージを指す。
-メッセージテキストは内部のバッファ領域に格納されており、
-保存や変更を行う場合にはアプリケーション側でコピーする必要がある。
-返される文字列は常にヌル文字で終端される。
+\fBcatgets\fP() は catalog で指定されたメッセージカタログから、 セット \fIset_number\fP のメッセージ
+\fImessage_number\fP を読み取る。 \fIcatalog\fP は、 \fBcatopen\fP(3) の呼び出しによって得られたカタログ
+ディスクリプタを指定する。 4番目の引数 \fImessage\fP は、指定のメッセージカタログが現在利用できない 場合に \fBcatgets\fP()
+が返すデフォルトのメッセージを指す。 メッセージテキストは内部のバッファ領域に格納されており、
+保存や変更を行う場合にはアプリケーション側でコピーする必要がある。 返される文字列は常にヌル文字で終端される。
.SH 返り値
.LP
-成功した場合、
-.BR catgets ()
-は内部のバッファ領域へのポインタを返す。
-ここにはヌル文字で終端されたメッセージ文字列が格納されている。
-失敗した場合は
-.I message
-を返す。
+成功した場合、 \fBcatgets\fP() は内部のバッファ領域へのポインタを返す。 ここにはヌル文字で終端されたメッセージ文字列が格納されている。
+失敗した場合は \fImessage\fP を返す。
.SH 準拠
-POSIX.1-2001.
+POSIX.1\-2001.
.SH 注意
-これらの関数は libc.so.4.4.4c 以降でしか使えない。
-Jan 1987 X/Open Portability Guide では、エラーの時に
-返される値により微妙な指定をしている。
-.I catalog
-で指定されたメッセージカタログが利用できない場合は
-.I message
-を返し、一方メッセージカタログはあるが指定したメッセージがない場合は
-空の文字列が返される。
-SUSv2 ではこの二種類のエラーリターンは廃止され、
-常に
-.I message
-を返すことにしたようである。
+これらの関数は libc.so.4.4.4c 以降でしか使えない。 Jan 1987 X/Open Portability Guide
+では、エラーの時に 返される値により微妙な指定をしている。 \fIcatalog\fP で指定されたメッセージカタログが利用できない場合は
+\fImessage\fP を返し、一方メッセージカタログはあるが指定したメッセージがない場合は 空の文字列が返される。 SUSv2
+ではこの二種類のエラーリターンは廃止され、 常に \fImessage\fP を返すことにしたようである。
.SH 関連項目
-.BR catopen (3),
-.BR setlocale (3)
+\fBcatopen\fP(3), \fBsetlocale\fP(3)
OSDN Git Service
