draft/man3/a64l.3

   1 .\" Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"
   3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   4 .\" Distributed under GPL
   5 .\" %%%LICENSE_END
   6 .\"
   7 .\" Corrected, aeb, 2002-05-30
   8 .\"
   9 .\"*******************************************************************
  10 .\"
  11 .\" This file was generated with po4a. Translate the source file.
  12 .\"
  13 .\"*******************************************************************
  14 .\"
  15 .\" Japanese Version Copyright (c) 2002-2003 Yuichi SATO
  16 .\"         all rights reserved.
  17 .\" Translated Tue Aug  6 04:34:20 JST 2002
  18 .\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
  19 .\" Updated & Modified Thu Nov 27 01:02:55 JST 2003
  20 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  21 .\"
  22 .TH A64L 3 2013\-06\-21 "" "Linux Programmer's Manual"
  23 .SH 名前
  24 a64l, l64a \- long と base\-64 を変換する
  25 .SH 書式
  26 \fB#include <stdlib.h>\fP
  27 .sp
  28 \fBlong a64l(char *\fP\fIstr64\fP\fB);\fP
  29 .sp
  30 \fBchar *l64a(long \fP\fIvalue\fP\fB);\fP
  31 .sp
  32 .in -4n
  33 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  34 .in
  35 .sp
  36 \fBa64l\fP(), \fBl64a\fP():
  37 .br
  38 .RS 4
  39 .ad l
  40 _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
  41 .RE
  42 .ad
  43 .SH 説明
  44 これらの関数は 32 ビット long 整数と リトルエンディアン base\-64 ASCII 文字列 (長さ 0 〜 6) の間の変換を行う。
  45 \fBa64l\fP()  の引き数の文字列が 7 文字以上の場合、 最初の 6 バイトが使われる。 \fIlong\fP 型が 32 ビットより大きい場合、
  46 \fBl64a\fP()  は \fIvalue\fP の下位 32 ビットのみを使い、 \fBa64l\fP()  は 32 ビットの結果を符号拡張
  47 (sign\-extend) する。
  48 .LP
  49 base\-64 システムで使われる 64 個の文字は以下の通りである:
  50 .RS
  51 .nf
  52
  53 \&\(aq.\(aq     は 0 を表す。
  54 \&\(aq/\(aq     は 1 を表す。
  55 0\-9    は 2\-11 を表す。
  56 A\-Z    は 12\-37 を表す。
  57 a\-z    は 38\-63 を表す。
  58
  59 .fi
  60 .RE
  61 よって 123 = 59*64^0 + 1*64^1 = "v/" である。
  62 .SH 属性
  63 .SS "マルチスレッディング (pthreads(7) 参照)"
  64 \fBl64a\fP() 関数はスレッドセーフではない。
  65 .LP
  66 \fBa64l\fP() 関数はスレッドセーフである。
  67 .SH 準拠
  68 POSIX.1\-2001.
  69 .SH 注意
  70 \fBl64a\fP()  で返される値は静的バッファへのポインタかもしれないので、 以降の呼び出しで上書きされる可能性がある。
  71 .LP
  72 \fIvalue\fP が負の場合、 \fBl64a\fP()  の動作は定義されていない。 \fIvalue\fP が 0 の場合は空文字列を返す。
  73 .LP
  74 これらの関数は glibc 2.2.5 以前では間違っている (最上位デジットを最初にしている)。
  75 .LP
  76 これは \fBuuencode\fP(1)  で使われるエンコーディングではない。
  77 .SH 関連項目
  78 .\" .BR itoa (3),
  79 \fBuuencode\fP(1), \fBstrtoul\fP(3)
  80 .SH この文書について
  81 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
  82 である。プロジェクトの説明とバグ報告に関する情報は
  83 http://www.kernel.org/doc/man\-pages/ に書かれている。