HP 3000 Manuals

l64a [ HP C/iX Library Reference Manual ] MPE/iX 5.0 Documentation


HP C/iX Library Reference Manual

l64a 

Converts a long integer to a base-64 ASCII string.

Syntax 

     char *l64a (l)
        long l;

Parameters 

l             A long integer.

Return Values 

x             A pointer to the base-64 ASCII string.

NULL          The argument is 0.

Description 

This function maintains numbers stored in base-64 ASCII characters.  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:

-----------------------------------------------
|                       |                     |
|      Characters       |       Digits        |
|                       |                     |
-----------------------------------------------
|                       |                     |
|           .           |          0          |
|                       |                     |
-----------------------------------------------
|                       |                     |
|           /           |          1          |
|                       |                     |
-----------------------------------------------
|                       |                     |
|      0 through 9      |    2 through 11     |
|                       |                     |
-----------------------------------------------
|                       |                     |
|      A through Z      |    12 through 37    |
|                       |                     |
-----------------------------------------------
|                       |                     |
|      a through z      |    38 through 63    |
|                       |                     |
-----------------------------------------------

The leftmost character is the least significant digit.  For example:

     a0 = (38 x 640) + (2 x 641) = 166

This function takes a long argument and returns a pointer to the
corresponding base-64 representation.  If the argument is zero, 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.

See Also 

a64l()



MPE/iX 5.0 Documentation