draft/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 .\"O .SH NAME
  17 .SH Ì¾Á°
  18 .\"O a64l, l64a \- convert between long and base-64
  19 a64l, l64a \- long ¤È base-64 ¤òÊÑ´¹¤¹¤ë
  20 .\"O .SH SYNOPSIS
  21 .SH ½ñ¼°
  22 .B #include <stdlib.h>
  23 .sp
  24 .BI "long a64l(char *" str64 );
  25 .sp
  26 .BI "char *l64a(long " value );
  27 .sp
  28 .in -4n
  29 .\"O Feature Test Macro Requirements for glibc (see
  30 .\"O .BR feature_test_macros (7)):
  31 glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
  32 .RB ( feature_test_macros (7)
  33 »²¾È):
  34 .in
  35 .sp
  36 .BR a64l (),
  37 .BR l64a ():
  38 .br
  39 .RS 4
  40 .ad l
  41 _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
  42 _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
  43 .RE
  44 .ad
  45 .\"O .SH DESCRIPTION
  46 .SH ÀâÌÀ
  47 .\"O These functions provide a conversion between 32-bit long integers
  48 .\"O and little-endian base-64 ASCII strings (of length zero to six).
  49 ¤³¤ì¤é¤Î´Ø¿ô¤Ï 32 ¥Ó¥Ã¥È long À°¿ô¤È
  50 ¥ê¥È¥ë¥¨¥ó¥Ç¥£¥¢¥ó base-64 ASCII Ê¸»úÎó (Ä¹¤µ 0 ¡Á 6) ¤Î´Ö¤ÎÊÑ´¹¤ò¹Ô¤¦¡£
  51 .\"O If the string used as argument for
  52 .\"O .BR a64l ()
  53 .\"O has length greater than six, only the first six bytes are used.
  54 .BR a64l ()
  55 ¤Î°ú¤¿ô¤ÎÊ¸»úÎó¤¬ 7 Ê¸»ú°Ê¾å¤Î¾ì¹ç¡¢
  56 ºÇ½é¤Î 6 ¥Ð¥¤¥È¤¬»È¤ï¤ì¤ë¡£
  57 .\"O If the type
  58 .\"O .I long
  59 .\"O has more than 32 bits, then
  60 .\"O .BR l64a ()
  61 .\"O uses only the low order 32 bits of
  62 .\"O .IR value ,
  63 .\"O and
  64 .\"O .BR a64l ()
  65 .\"O sign-extends its 32-bit result.
  66 .I long
  67 ·¿¤¬ 32 ¥Ó¥Ã¥È¤è¤êÂç¤¤¤¾ì¹ç¡¢
  68 .BR l64a ()
  69 ¤Ï
  70 .I value
  71 ¤Î²¼°Ì 32 ¥Ó¥Ã¥È¤Î¤ß¤ò»È¤¤¡¢
  72 .BR a64l ()
  73 ¤Ï 32 ¥Ó¥Ã¥È¤Î·ë²Ì¤òÉä¹æ³ÈÄ¥ (sign-extend) ¤¹¤ë¡£
  74 .LP
  75 .\"O The 64 digits in the base-64 system are:
  76 base-64 ¥·¥¹¥Æ¥à¤Ç»È¤ï¤ì¤ë 64 ¸Ä¤ÎÊ¸»ú¤Ï°Ê²¼¤ÎÄÌ¤ê¤Ç¤¢¤ë:
  77 .RS
  78 .nf
  79
  80 .\"O \&\(aq.\(aq        represents a 0
  81 \&\(aq.\(aq     ¤Ï 0 ¤òÉ½¤¹¡£
  82 .\"O \&\(aq/\(aq\&      represents a 1
  83 \&\(aq/\(aq     ¤Ï 1 ¤òÉ½¤¹¡£
  84 .\"O 0-9        represent  2-11
  85 0-9     ¤Ï 2-11 ¤òÉ½¤¹¡£
  86 .\"O A-Z        represent 12-37
  87 A-Z     ¤Ï 12-37 ¤òÉ½¤¹¡£
  88 .\"O a-z        represent 38-63
  89 a-z     ¤Ï 38-63 ¤òÉ½¤¹¡£
  90
  91 .fi
  92 .RE
  93 .\"O So 123 = 59*64^0 + 1*64^1 = "v/".
  94 ¤è¤Ã¤Æ 123 = 59*64^0 + 1*64^1 = "v/" ¤Ç¤¢¤ë¡£
  95 .\"O .SH "CONFORMING TO"
  96 .SH ½àµò
  97 POSIX.1-2001.
  98 .\"O .SH NOTES
  99 .SH Ãí°Õ
 100 .\"O The value returned by
 101 .\"O .BR l64a ()
 102 .\"O may be a pointer to a static buffer, possibly overwritten
 103 .\"O by later calls.
 104 .BR l64a ()
 105 ¤ÇÊÖ¤µ¤ì¤ëÃÍ¤ÏÀÅÅª¥Ð¥Ã¥Õ¥¡¤Ø¤Î¥Ý¥¤¥ó¥¿¤«¤â¤·¤ì¤Ê¤¤¤Î¤Ç¡¢
 106 °Ê¹ß¤Î¸Æ¤Ó½Ð¤·¤Ç¾å½ñ¤¤µ¤ì¤ë²ÄÇ½À¤¬¤¢¤ë¡£
 107 .LP
 108 .\"O The behavior of
 109 .\"O .BR l64a ()
 110 .\"O is undefined when
 111 .\"O .I value
 112 .\"O is negative.
 113 .\"O If
 114 .\"O .I value
 115 .\"O is zero, it returns an empty string.
 116 .I value
 117 ¤¬Éé¤Î¾ì¹ç¡¢
 118 .BR l64a ()
 119 ¤ÎÆ°ºî¤ÏÄêµÁ¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
 120 .I value
 121 ¤¬ 0 ¤Î¾ì¹ç¤Ï¶õÊ¸»úÎó¤òÊÖ¤¹¡£
 122 .LP
 123 .\"O These functions are broken in glibc before 2.2.5
 124 .\"O (puts most significant digit first).
 125 ¤³¤ì¤é¤Î´Ø¿ô¤Ï glibc 2.2.5 °ÊÁ°¤Ç¤Ï´Ö°ã¤Ã¤Æ¤¤¤ë
 126 (ºÇ¾å°Ì¥Ç¥¸¥Ã¥È¤òºÇ½é¤Ë¤·¤Æ¤¤¤ë)¡£
 127 .LP
 128 .\"O This is not the encoding used by
 129 .\"O .BR uuencode (1).
 130 ¤³¤ì¤Ï
 131 .BR uuencode (1)
 132 ¤Ç»È¤ï¤ì¤ë¥¨¥ó¥³¡¼¥Ç¥£¥ó¥°¤Ç¤Ï¤Ê¤¤¡£
 133 .\"O .SH "SEE ALSO"
 134 .SH ´ØÏ¢¹àÌÜ
 135 .BR uuencode (1),
 136 .\" .BR itoa (3),
 137 .BR strtoul (3)