(split) LDP: Update the version to 3.53 in PO files

[linuxjm/LDP_man-pages.git] / release / man3 / strftime.3

diff --git a/release/man3/strftime.3 b/release/man3/strftime.3
index f29a27c..aa61ce3 100644 (file)
--- a/release/man3/strftime.3
+++ b/release/man3/strftime.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
@@ -37,7 +39,7 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH STRFTIME 3 2010\-01\-17 GNU "Linux Programmer's Manual"
+.TH STRFTIME 3 2013\-06\-28 GNU "Linux Programmer's Manual"
 .SH 名前
 strftime \- 日付および時刻の文字列への変換
 .SH 書式
@@ -191,7 +193,7 @@ ISO\ 8601 形式での年の始めからの週番号 (「注意」の節を参
 \fI+hhmm\fP や \fI\-hhmm\fP の形式のタイムゾーン (UTC へのオフセット時間)。(SU)
 .TP 
 \fB%Z\fP
-タイムゾーンまたはゾーン名または省略名。
+タイムゾーン名または省略名。
 .TP 
 \fB%+\fP
 .\" Nov 05 -- Not in Linux/glibc, but is in some BSDs (according to
@@ -211,12 +213,13 @@ UNIX Specification) では \fB%Ec\fP, \fB%EC\fP, \fB%Ex\fP, \fB%EX\fP, \fB%Ey\fP
 .PP
 要素別の時刻構造体 \fItm\fP の詳細は \fI<time.h>\fP に定義されている。 \fBctime\fP(3)  も参照すること。
 .SH 返り値
-\fBstrftime\fP()  関数は文字列 \fIs\fP に格納された文字数を返す。 この文字数に終端の NULL バイトは含まない。 終端の NULL
-ã\83\90ã\82¤ã\83\88ã\82\92æ ¼ç´\8dã\81§ã\81\8dã\82\8bã\81 ã\81\91ã\81®å¤§ã\81\8dã\81\95ã\82\92æ\8c\81ã\81£ã\81\9fæ\96\87å­\97å\88\97ã\82\92渡ã\81\99ã\81\93ã\81¨ã\80\82 ã\81\9dã\82\8c以å¤\96ã\81®å ´å\90\88ã\81¯ 0 ã\82\92è¿\94ã\81\97ã\80\81æ\96\87å­\97å\88\97ã\81®å\86\85容ã\81¯ä¿®æ­£ã\81\95ã\82\8cã\81ªã\81\84ã\80\82 (libc 4.4.4
-以降でこの挙動が適用されている。 libc 4.4.1 などの非常に古いバージョンの libc では 文字列が短か過ぎた場合には \fImax\fP
-が返される。)
+終端の NULL バイトを含めた結果の文字列の長さが \fImax\fP バイトを超えなかった場合、 \fBstrftime\fP() 関数は配列 \fIs\fP
+ã\81«æ ¼ç´\8dã\81\95ã\82\8cã\81\9fã\83\90ã\82¤ã\83\88æ\95°ã\82\92è¿\94ã\81\99 (ã\81\93ã\81®ã\83\90ã\82¤ã\83\88æ\95°ã\81«çµ\82端ã\81® NULL ã\83\90ã\82¤ã\83\88ã\81¯å\90«ã\81¾ã\82\8cã\81ªã\81\84)ã\80\82 çµ\82端ã\81® NULL ã\83\90ã\82¤ã\83\88ã\82\92å\90«ã\82\81ã\81\9fçµ\90æ\9e\9cã\81®æ\96\87å­\97å\88\97ã\81®é\95·ã\81\95ã\81\8c \fImax\fP
+バイトを超える場合には、 \fBstrftime\fP() は 0 を返し、配列の内容は不定となる。 (少なくとも libc 4.4.4
+以降ではこの動作となる。 libc 4.4.1 などの非常に古いバージョンの libc では配列が短かすぎた場合には \fImax\fP が返される。)
 .LP
-返り値 0 は必ずしもエラーを意味している訳ではないので注意すること。 例えば、多くのロケールでは \fB%p\fP は空文字列を返す。
+返り値 0 は必ずしもエラーを意味している訳ではないので注意すること。 例えば、多くのロケールでは \fB%p\fP は空文字列を返す。 同様に、空の
+\fIformat\fP 文字列は空文字列を返す。
 .SH 環境変数
 環境変数 \fBTZ\fP と \fBLC_TIME\fP が使用される。 (訳注: \fBLC_ALL\fP が設定されている場合には \fBLC_TIME\fP
 よりもそちらが優先される。 \fBLC_TIME\fP も \fBLC_ALL\fP も設定されていない場合には \fBLANG\fP が使用される。)
@@ -263,6 +266,10 @@ glibc では変換指定にいくつか拡張を行っている (これらの拡
 オプションの10進数の幅指定子はフラグの後ろに置くことができる (フラグはなくてもよい)。フィールドの本来の大きさが指定された幅よりも
 小さい場合、結果文字列の左側は指定された幅までパディングされる。
 .SH バグ
+出力文字列が \fImax\fP バイトを超えてしまう場合、 \fIerrno\fP は設定「されない」。 このため、このエラーを、 \fIformat\fP
+文字列がきちんと処理されて長さ 0 の出力文字列が生成される場合を区別することができない。 POSIX.1\-2001 では \fBstrftime\fP()
+で \fIerrno\fP に設定する値について一切規定して「いない」。
+
 \fBgcc\fP(1)  のいくつかのバージョンにはおかしなところがあり、 \fB%c\fP の使用法について以下のような警告を出す: \fIwarning:
 `%c' yields only last 2 digits of year in some locales\fP
 (\fI警告:\fPいくつかのロケールでは\fI`%c'\fPは年の下2桁しか出力しない\fI)。\fP もちろんプログラマが \fB%c\fP
@@ -342,6 +349,6 @@ main(int argc, char *argv[])
 \fBdate\fP(1), \fBtime\fP(2), \fBctime\fP(3), \fBsetlocale\fP(3), \fBsprintf\fP(3),
 \fBstrptime\fP(3)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。