release/man3/a64l.3

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