a64l(3)a64l(3)NAME
a64l, l64a - convert long integer and base-64 ASCII string
SYNOPSIS
#include <stdlib.h>
long a64l(
const char *s ); char *l64a(
long l );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
a64l(), l64a(): XSH4.2
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Specifies a pointer to a character string that is to be converted to a
long integer. Specifies a long integer that is to be converted to a
character string.
DESCRIPTION
These functions are used to maintain numbers stored in base-64 ASCII
characters. The a64l() function converts a character string to a long
integer. The l64a() function converts a long integer to a character
string.
On Tru64 UNIX systems, for which the data type long contains 64 bits,
only the low-order 32 bits are used for these operations.
Each character used to store a long integer represents a numeric value
from 0 through 63. Up to six characters may be used to represent a long
integer.
The characters are translated as follows: A period (.) represents 0. A
slash (/) represents 1. The numbers 0 through 9 represent 2 through
11. Uppercase letters A through Z represent 12 through 37. Lowercase
letters a through z represent 38 through 63.
The a64l() function takes a pointer to a base-64 representation, in
which the first digit is the least significant, and returns a corre‐
sponding long value. If the string pointed to by the s parameter
exceeds six characters, a64l() uses only the first six. If the first
six characters of the string contain a null terminator, a64l() uses
only characters preceding the null terminator. A character string is
translated from left to right with the least significant number on the
left and each character is translated as a 6-bit base-64 number. The
resulting value is sign-extended.
The l64a() function takes a long integer and returns a pointer to a
corresponding base-64 notation of the least significant 32 bits.
[Tru64 UNIX] In applications that are compiled in an environment that
excludes the _XOPEN_SOURCE_EXTENDED standard definitions, the behavior
of the l64a() and a64l() functions differs from that described in this
section as follows: Conversion operations use 64 bits. Up to 12 char‐
acters can be used to represent a long integer.
NOTES
The value returned by l64a() is a pointer to a thread-specific buffer
whose contents will be overwritten on subsequent calls from the same
thread.
[Tru64 UNIX] The a64l() and l64a() functions belong to a small set of
libc functions that are handled differently when compiled in the X/Open
UNIX environment. In the X/Open UNIX environment, calls to these func‐
tions are internally renamed by prepending _E to the function name. The
renaming is done only when there is an incompatible conflict between an
existing version of the function and the version that conforms to the
X/Open UNIX standard. The renaming strategy supports binary compatibil‐
ity by allowing applications to compile in the X/Open UNIX environment
and also link with site-specific and third-party libraries that use the
old versions of the same libc interfaces. However, internal renaming of
the calls affects how these calls are identified during debugging ses‐
sions. Therefore, when you are debugging a module that includes the
a64l() and/or l64a() functions and for which _XOPEN_SOURCE_EXTENDED has
been defined, use _Ea64l to refer to the a64l() call and _El64a to
refer to the l64a() call. See standards(5) for information on when the
_XOPEN_SOURCE_EXTENDED macro is defined.
RETURN VALUES
On successful completion, the a64l() function returns the long value
resulting from conversion of the input string. If a string pointed to
by the s parameter is an empty string, a64l() returns zero (0).
The l64a() function returns a pointer to the corresponding base-64
notation. If the l parameter is zero (0), l64a() returns a pointer to
an empty string.
ERRORS
No errors are defined for this function.
SEE ALSO
Standards: standards(5)a64l(3)