l64a(3) [osx man page]

A64L(3) 						   BSD Library Functions Manual 						   A64L(3)

NAME

     a64l, l64a -- convert between 32-bit integer and radix-64 ASCII string

SYNOPSIS

     #include <stdlib.h>

     long
     a64l(const char *s);

     char *
     l64a(long value);

DESCRIPTION

     The a64l() and l64a() functions are used to maintain numbers stored in radix-64 ASCII characters.	This is a notation by which 32-bit inte-
     gers can be represented by up to six characters; each character represents a ``digit'' in a radix-64 notation.

     The characters used to represent digits are '.' for 0, '/' for 1, '0' through '9' for 2-11, 'A' through 'Z' for 12-37, and 'a' through 'z'
     for 38-63.

     The a64l() function takes a pointer to a null-terminated radix-64 representation and returns a corresponding 32-bit value.  If the string
     pointed to by s contains more than six characters, a64l() will use the first six.	a64l() scans the character string from left to right,
     decoding each character as a 6-bit radix-64 number.  If a long integer is larger than 32 bits, the return value will be sign-extended.

     l64a() takes a long integer argument value and returns a pointer to the corresponding radix-64 representation.

RETURN VALUES

     On success, a64l() returns a 32-bit representation of s.  If s is a null pointer or if it contains digits other than those described above.
     a64l() returns -1 and sets the global variable errno to EINVAL.

     On success, l64a() returns a pointer to a string containing the radix-64 representation of value.	If value is 0, l64a() returns a pointer to
     the empty string.	If value is negative, l64a() returns a null pointer and sets the global variable errno to EINVAL.

WARNINGS

     The value returned by l64a() is a pointer into a static buffer, the contents of which will be overwritten by subsequent calls.

     The value returned by a64l() may be incorrect if the value is too large; for that reason, only strings that resulted from a call to l64a()
     should be used to call a64l().

     If a long integer is larger than 32 bits, only the low-order 32 bits are used.

STANDARDS

     The a64l() and l64a() functions conform to X/Open Portability Guide Issue 4, Version 2 (``XPG4.2'').

BSD
								  August 17, 1997							       BSD

a64l(3C)						   Standard C Library Functions 						  a64l(3C)

NAME

       a64l, l64a - convert between long integer and base-64 ASCII string

SYNOPSIS

       #include <stdlib.h>

       long a64l(const char *s);

       char *l64a(long l);

DESCRIPTION

       These  functions maintain numbers stored in base-64 ASCII characters that define a notation by which long integers can be represented by up
       to six characters. Each character represents a "digit" in a radix-64 notation.

       The characters used to represent "digits" are as follows:

       +-----------------------------+-----------------------------+
       |Character		     | Digit			   |
       +-----------------------------+-----------------------------+
       |.			     | 0			   |
       |/			     | 1			   |
       |0-9			     | 2-11			   |
       |A-Z			     | 12-37			   |
       |a-z			     | 38-63			   |
       +-----------------------------+-----------------------------+

       The a64l() function takes a pointer to a null-terminated base-64 representation and returns a corresponding  long  value.   If  the  string
       pointed to by s contains more than six characters, a64l() uses the first six.

       The  a64l() function scans the character string from left to right with the least significant digit on the left, decoding each character as
       a 6-bit radix-64 number.

       The l64a() function takes a long argument and returns a pointer to the corresponding base-64 representation. If the argument is	0,  l64a()
       returns a pointer to a null string.

       The  value returned by l64a() is a pointer into a static buffer, the contents of which are overwritten by each call.  In the case of multi-
       threaded applications, the return value is a pointer to thread specific data.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       attributes(5), standards(5)

SunOS 5.11							    24 Jul 2002 							  a64l(3C)