(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 5ae5c38..aa61ce3 100644 (file)
--- a/release/man3/strftime.3
+++ b/release/man3/strftime.3
@@ -39,7 +39,7 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH STRFTIME 3 2012\-05\-10 GNU "Linux Programmer's Manual"
+.TH STRFTIME 3 2013\-06\-28 GNU "Linux Programmer's Manual"
 .SH 名前
 strftime \- 日付および時刻の文字列への変換
 .SH 書式
@@ -193,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
@@ -213,14 +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 バイトを格納できるだけの
-大きさを持った文字列を渡すこと。それ以外の場合は 0 を返し、文字列の内容
-は修正されない。 (libc 4.4.4 以降でこの挙動が適用されている。 libc
-4.4.1 などの非常に古いバージョンの libc では 文字列が短か過ぎた場合には
-\fImax\fP が返される。)
+終端の NULL バイトを含めた結果の文字列の長さが \fImax\fP バイトを超えなかった場合、 \fBstrftime\fP() 関数は配列 \fIs\fP
+に格納されたバイト数を返す (このバイト数に終端の NULL バイトは含まれない)。 終端の NULL バイトを含めた結果の文字列の長さが \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 が使用される。)
@@ -267,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
@@ -346,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.51 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。