a64l(3C)                       DG/UX R4.11MU05                      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 are used to maintain numbers stored in base-64 ASCII
       characters.  These characters 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.  Like normal numerals, the
       digits are arranged from right to left.

       The characters used to represent ``digits'' are:

       .    for 0

       /    for 1

       0-9  for 2-11

       A-Z  for 12-37

       a-z  for 38-63

       a64l 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 will use the first six.

       a64l 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.

       l64a 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.

   Considerations for Threads Programming
                     +---------+-----------------------------+
                     |         |                      async- |
                     |function | reentrant   cancel   cancel |
                     |         |             point     safe  |
                     +---------+-----------------------------+
                     |a64l     |     Y         N        N    |
                     |l64a     |     N         -        -    |
                     +---------+-----------------------------+
SEE ALSO
       reentrant(3), l3tol(3C).

CAVEATS
       The value returned by l64a is a pointer into a static buffer, the
       contents of which are overwritten by each call.


Licensed material--property of copyright holder(s)