OSDN Git Service

(split) LDP: Update draft pages
[linuxjm/LDP_man-pages.git] / draft / man3 / a64l.3
index c00ecb3..40a15fd 100644 (file)
 .\" Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
+.\"
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
 .\" Distributed under GPL
+.\" %%%LICENSE_END
 .\"
 .\" Corrected, aeb, 2002-05-30
 .\"
-.\" Japanese Version Copyright (c) 2002-2003 Yuichi SATO
-.\"         all rights reserved.
-.\" Translated Tue Aug  6 04:34:20 JST 2002
-.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
-.\" Updated & Modified Thu Nov 27 01:02:55 JST 2003
-.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
+.\"*******************************************************************
 .\"
-.\"WORD:       sign-extend     Éä¹æ³ÈÄ¥
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH A64L 3 2010-09-20 "" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O a64l, l64a \- convert between long and base-64
-a64l, l64a \- long ¤È base-64 ¤òÊÑ´¹¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
-.B #include <stdlib.h>
+.\"*******************************************************************
+.TH A64L 3 2013\-06\-21 "" "Linux Programmer's Manual"
+.SH 名前
+a64l, l64a \- long と base\-64 を変換する
+.SH 書式
+\fB#include <stdlib.h>\fP
 .sp
-.BI "long a64l(char *" str64 );
+\fBlong a64l(char *\fP\fIstr64\fP\fB);\fP
 .sp
-.BI "char *l64a(long " value );
+\fBchar *l64a(long \fP\fIvalue\fP\fB);\fP
 .sp
 .in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
-.BR a64l (),
-.BR l64a ():
+\fBa64l\fP(), \fBl64a\fP():
 .br
 .RS 4
 .ad l
-_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
 .RE
 .ad
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O These functions provide a conversion between 32-bit long integers
-.\"O and little-endian base-64 ASCII strings (of length zero to six).
-¤³¤ì¤é¤Î´Ø¿ô¤Ï 32 ¥Ó¥Ã¥È long À°¿ô¤È
-¥ê¥È¥ë¥¨¥ó¥Ç¥£¥¢¥ó base-64 ASCII Ê¸»úÎó (Ťµ 0 ¡Á 6) ¤Î´Ö¤ÎÊÑ´¹¤ò¹Ô¤¦¡£
-.\"O If the string used as argument for
-.\"O .BR a64l ()
-.\"O has length greater than six, only the first six bytes are used.
-.BR a64l ()
-¤Î°ú¤­¿ô¤Îʸ»úÎ󤬠7 Ê¸»ú°Ê¾å¤Î¾ì¹ç¡¢
-ºÇ½é¤Î 6 ¥Ð¥¤¥È¤¬»È¤ï¤ì¤ë¡£
-.\"O If the type
-.\"O .I long
-.\"O has more than 32 bits, then
-.\"O .BR l64a ()
-.\"O uses only the low order 32 bits of
-.\"O .IR value ,
-.\"O and
-.\"O .BR a64l ()
-.\"O sign-extends its 32-bit result.
-.I long
-·¿¤¬ 32 ¥Ó¥Ã¥È¤è¤êÂ礭¤¤¾ì¹ç¡¢
-.BR l64a ()
-¤Ï
-.I value
-¤Î²¼°Ì 32 ¥Ó¥Ã¥È¤Î¤ß¤ò»È¤¤¡¢
-.BR a64l ()
-¤Ï 32 ¥Ó¥Ã¥È¤Î·ë²Ì¤òÉä¹æ³ÈÄ¥ (sign-extend) ¤¹¤ë¡£
+.SH 説明
+これらの関数は 32 ビット long 整数と リトルエンディアン base\-64 ASCII 文字列 (長さ 0 〜 6) の間の変換を行う。
+\fBa64l\fP()  の引き数の文字列が 7 文字以上の場合、 最初の 6 バイトが使われる。 \fIlong\fP 型が 32 ビットより大きい場合、
+\fBl64a\fP()  は \fIvalue\fP の下位 32 ビットのみを使い、 \fBa64l\fP()  は 32 ビットの結果を符号拡張
+(sign\-extend) する。
 .LP
-.\"O The 64 digits in the base-64 system are:
-base-64 ¥·¥¹¥Æ¥à¤Ç»È¤ï¤ì¤ë 64 ¸Ä¤Îʸ»ú¤Ï°Ê²¼¤ÎÄ̤ê¤Ç¤¢¤ë:
+base\-64 システムで使われる 64 個の文字は以下の通りである:
 .RS
 .nf
 
-.\"O \&\(aq.\(aq       represents a 0
-\&\(aq.\(aq    ¤Ï 0 ¤òɽ¤¹¡£
-.\"O \&\(aq/\(aq\&     represents a 1
-\&\(aq/\(aq    ¤Ï 1 ¤òɽ¤¹¡£
-.\"O 0-9       represent  2-11
-0-9    ¤Ï 2-11 ¤òɽ¤¹¡£
-.\"O A-Z       represent 12-37
-A-Z    ¤Ï 12-37 ¤òɽ¤¹¡£
-.\"O a-z       represent 38-63
-a-z    ¤Ï 38-63 ¤òɽ¤¹¡£
+\&\(aq.\(aq    は 0 を表す。
+\&\(aq/\(aq    は 1 を表す。
+0\-9   は 2\-11 を表す。
+A\-Z   は 12\-37 を表す。
+a\-z   は 38\-63 を表す。
 
 .fi
 .RE
-.\"O So 123 = 59*64^0 + 1*64^1 = "v/".
-¤è¤Ã¤Æ 123 = 59*64^0 + 1*64^1 = "v/" ¤Ç¤¢¤ë¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-POSIX.1-2001.
-.\"O .SH NOTES
-.SH Ãí°Õ
-.\"O The value returned by
-.\"O .BR l64a ()
-.\"O may be a pointer to a static buffer, possibly overwritten
-.\"O by later calls.
-.BR l64a ()
-¤ÇÊÖ¤µ¤ì¤ëÃͤÏÀÅŪ¥Ð¥Ã¥Õ¥¡¤Ø¤Î¥Ý¥¤¥ó¥¿¤«¤â¤·¤ì¤Ê¤¤¤Î¤Ç¡¢
-°Ê¹ß¤Î¸Æ¤Ó½Ð¤·¤Ç¾å½ñ¤­¤µ¤ì¤ë²ÄǽÀ­¤¬¤¢¤ë¡£
+よって 123 = 59*64^0 + 1*64^1 = "v/" である。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+\fBl64a\fP() 関数はスレッドセーフではない。
+.LP
+\fBa64l\fP() 関数はスレッドセーフである。
+.SH 準拠
+POSIX.1\-2001.
+.SH 注意
+\fBl64a\fP()  で返される値は静的バッファへのポインタかもしれないので、 以降の呼び出しで上書きされる可能性がある。
 .LP
-.\"O The behavior of
-.\"O .BR l64a ()
-.\"O is undefined when
-.\"O .I value
-.\"O is negative.
-.\"O If
-.\"O .I value
-.\"O is zero, it returns an empty string.
-.I value
-¤¬Éé¤Î¾ì¹ç¡¢
-.BR l64a ()
-¤ÎÆ°ºî¤ÏÄêµÁ¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
-.I value
-¤¬ 0 ¤Î¾ì¹ç¤Ï¶õʸ»úÎó¤òÊÖ¤¹¡£
+\fIvalue\fP が負の場合、 \fBl64a\fP()  の動作は定義されていない。 \fIvalue\fP が 0 の場合は空文字列を返す。
 .LP
-.\"O These functions are broken in glibc before 2.2.5
-.\"O (puts most significant digit first).
-¤³¤ì¤é¤Î´Ø¿ô¤Ï glibc 2.2.5 °ÊÁ°¤Ç¤Ï´Ö°ã¤Ã¤Æ¤¤¤ë
-(ºÇ¾å°Ì¥Ç¥¸¥Ã¥È¤òºÇ½é¤Ë¤·¤Æ¤¤¤ë)¡£
+これらの関数は glibc 2.2.5 以前では間違っている (最上位デジットを最初にしている)。
 .LP
-.\"O This is not the encoding used by
-.\"O .BR uuencode (1).
-¤³¤ì¤Ï
-.BR uuencode (1)
-¤Ç»È¤ï¤ì¤ë¥¨¥ó¥³¡¼¥Ç¥£¥ó¥°¤Ç¤Ï¤Ê¤¤¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR uuencode (1),
+これは \fBuuencode\fP(1)  で使われるエンコーディングではない。
+.SH 関連項目
 .\" .BR itoa (3),
-.BR strtoul (3)
+\fBuuencode\fP(1), \fBstrtoul\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。