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

NAME
     aa6644ll, ll6644aa - convert between 32-bit integer and radix-64 ASCII string

SYNOPSIS
     ##iinncclluuddee <>

     long
     aa6644ll(const char *s);

     char *
     ll6644aa(long l);

DESCRIPTION
     The aa6644ll() and ll6644aa() functions are used to maintain numbers stored in
     radix-64 ASCII characters.  This is a notation by which 32-bit 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 `.' for 0, `/' for 1, `0'
     through `9' for 2-11, `A' through `Z' for 12-37, and `a' through `z' for
     38-63.

     The aa6644ll() function takes a pointer to a null-terminated radix-64 repre-
     sentation and returns a corresponding 32-bit value.  If the string
     pointed to by s contains more than six characters, aa6644ll() will use the
     first six.  aa6644ll() scans the character string from left to right, decod-
     ing 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.

     ll6644aa() takes a long integer argument l and returns a pointer to the cor-
     responding radix-64 representation.

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

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

WWAARRNNIINNGGSS
     The value returned by ll6644aa() is a pointer into a static buffer, the con-
     tents of which will be overwritten by subsequent calls.

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

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

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

BSD                             August 17, 1997                            BSD