X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=draft%2Fman3%2Ffgetws.3;h=241e7c7d3370dd84f1af7020b31dacfce2e11d0d;hb=c1dfa2f6ab1bbed84992d3c59ee9925f4d453668;hp=f8af5042ebc7b02096fc80abab069cf0ed1457f2;hpb=ce024239a1d8e74a7a44f7c24cee4375cb13b3ef;p=linuxjm%2FLDP_man-pages.git diff --git a/draft/man3/fgetws.3 b/draft/man3/fgetws.3 index f8af5042..241e7c7d 100644 --- a/draft/man3/fgetws.3 +++ b/draft/man3/fgetws.3 @@ -1,9 +1,11 @@ .\" Copyright (c) Bruno Haible .\" +.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA) .\" This is free documentation; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as .\" published by the Free Software Foundation; either version 2 of .\" the License, or (at your option) any later version. +.\" %%%LICENSE_END .\" .\" References consulted: .\" GNU glibc-2 source code and manual @@ -13,106 +15,42 @@ .\" ISO/IEC 9899:1999 .\" .\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon +.\"******************************************************************* .\" -.\" About this Japanese page, please contact to JM Project -.\" Translated Sun Aug 29 15:03:42 JST 1999 -.\" by FUJIWARA Teruyoshi -.\" Updated Sat Oct 27 09:01:41 JST 2001 -.\" by Yuichi SATO +.\" This file was generated with po4a. Translate the source file. .\" -.\" WORD: null wide characters ナルワイド文字 -.\" -.TH FGETWS 3 2011-09-28 "GNU" "Linux Programmer's Manual" -.\"O .SH NAME +.\"******************************************************************* +.TH FGETWS 3 2011\-09\-28 GNU "Linux Programmer's Manual" .SH 名前 -.\"O fgetws \- read a wide-character string from a FILE stream fgetws \- ワイド文字の文字列を FILE ストリームから読み込む -.\"O .SH SYNOPSIS .SH 書式 .nf -.B #include +\fB#include \fP .sp -.BI "wchar_t *fgetws(wchar_t *" ws ", int " n ", FILE *" stream ); +\fBwchar_t *fgetws(wchar_t *\fP\fIws\fP\fB, int \fP\fIn\fP\fB, FILE *\fP\fIstream\fP\fB);\fP .fi -.\"O .SH DESCRIPTION .SH 説明 -.\"O The -.\"O .BR fgetws () -.\"O function is the wide-character equivalent -.\"O of the -.\"O .BR fgets (3) -.\"O function. -.\"O It reads a string of at most \fIn\-1\fP wide characters into the -.\"O wide-character array pointed to by \fIws\fP, -.\"O and adds a terminating null wide character (L\(aq\\0\(aq). -.\"O It stops reading wide characters after it has encountered and -.\"O stored a newline wide character. -.\"O It also stops when end of stream is reached. -.BR fgetws () -関数は -.BR fgets (3) -に対応するワイド文字関数である。 -この関数は、最大 \fIn\-1\fP 文字のワイド文字を -\fIws\fP が示すワイド文字の配列に読み込み、 -終端の NULL ワイド文字 (L\(aq\\0\(aq) を追加する。 -この関数は、ワイド文字の改行文字を見つけ、これを格納すると読み込むのを止める。 -この関数はストリームの終わりに達した場合も読み込みを止める。 +\fBfgetws\fP() 関数は \fBfgets\fP(3) に対応するワイド文字関数である。 この関数は、最大 \fIn\-1\fP 文字のワイド文字を +\fIws\fP が示すワイド文字の配列に読み込み、 終端の NULL ワイド文字 (L\(aq\e0\(aq) を追加する。 +この関数は、ワイド文字の改行文字を見つけ、これを格納すると読み込むのを止める。 この関数はストリームの終わりに達した場合も読み込みを止める。 .PP -.\"O The programmer must ensure that there is room for at least \fIn\fP wide -.\"O characters at \fIws\fP. -プログラマは、\fIws\fP には少なくとも \fIn\fP 文字のワイド文字を -格納できる領域を必ず確保していなければならない。 +プログラマは、\fIws\fP には少なくとも \fIn\fP 文字のワイド文字を 格納できる領域を必ず確保していなければならない。 .PP -.\"O For a nonlocking counterpart, see -.\"O .BR unlocked_stdio (3). -これらの処理をロックせずに行いたいときは、 -.BR unlocked_stdio (3) -を参照すること。 -.\"O .SH "RETURN VALUE" +これらの処理を停止せずに行いたいときは、 \fBunlocked_stdio\fP(3) を参照のこと。 .SH 返り値 -.\"O The -.\"O .BR fgetws () -.\"O function, if successful, returns \fIws\fP. -.\"O If end of stream -.\"O was already reached or if an error occurred, it returns NULL. -.BR fgetws () -は成功すると \fIws\fP を返す。 -既にストリームの終わりに達しているか、エラーが起きた場合には NULL を返す。 -.\"O .SH "CONFORMING TO" +\fBfgetws\fP() は成功すると \fIws\fP を返す。 既にストリームの終わりに達しているか、エラーが起きた場合には NULL を返す。 .SH 準拠 -C99, POSIX.1-2001. -.\"O .SH NOTES +C99, POSIX.1\-2001. .SH 注意 -.\"O The behavior of -.\"O .BR fgetws () -.\"O depends on the -.\"O .B LC_CTYPE -.\"O category of the -.\"O current locale. -.BR fgetws () -の動作は、現在のロケールの -.B LC_CTYPE -カテゴリに依存する。 +\fBfgetws\fP() の動作は、現在のロケールの \fBLC_CTYPE\fP カテゴリに依存する。 .PP -.\"O In the absence of additional information passed to the -.\"O .BR fopen (3) -.\"O call, it is -.\"O reasonable to expect that -.\"O .BR fgetws () -.\"O will actually read a multibyte string -.\"O from the stream and then convert it to a wide-character string. -.BR fopen (3) -システムコールに渡す追加の情報がない場合には、 -.BR fgetws () -が実際にはマルチバイトシーケンスをストリームから読み込み、 -これをワイド文字に変換すると期待することは適切である。 +\fBfopen\fP(3) システムコールに渡す追加の情報がない場合には、 \fBfgetws\fP() +が実際にはマルチバイトシーケンスをストリームから読み込み、 これをワイド文字に変換すると期待することは適切である。 .PP -.\"O This function is unreliable, -.\"O because it does not permit to deal properly with -.\"O null wide characters that may be present in the input. -この関数は信頼できない。なぜなら、入力に含まれるかもしれない -ナルワイド文字を適切に処理することができないからである。 -.\"O .SH "SEE ALSO" +この関数は信頼できない。なぜなら、入力に含まれるかもしれない ナルワイド文字を適切に処理することができないからである。 .SH 関連項目 -.BR fgetwc (3), -.BR unlocked_stdio (3) +\fBfgetwc\fP(3), \fBunlocked_stdio\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。