Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

a64l(3) Guardian Native C Library Calls Reference Manual
NAME
a64l - Converts a radix-64 ASCII string to a 32-bit integer
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL
G-series native OSS processes: /G/system/sysnn/zstfnsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll
SYNOPSIS
#include <stdlib.h>
long a64l(const char *s);
PARAMETERS
s Is a pointer to a string in radix-64
ASCII
notation.
DESCRIPTION
The a64l() function allows you to convert numbers from being radix-64
ASCII notation to 32-bit
integers. Radix-64
ASCII is a notation which uses up to six characters to represent a 32-bit
integer. Each of these six characters represents a radix-64 digit as shown in the following list:
Radix-64 Digit Character
0.
1/
2-11 0-9
12-37 A-Z
38-63 a-z
If the type long is longer than 32 bits, these functions only use the low-order 32 bits.
The a64l() function takes a radix-64 string pointed to by the s parameter and returns a
corresponding long value. It scans the string pointed to by s from left (the least significant digit)
to right, decoding each character as a 6-bit radix-64 number. If the string pointed to by s is
longer than six characters, only the first six characters are used. If a null terminator character is
found within these six characters, only those characters which precede the terminator are used. If
the type long is longer than 32 bits, the value returned is sign-extended.
The a64l() function can be called by native processes only.
RETURN VALUES
On successful completion, the a64l() function returns the long value that results from the conver-
sion of the string pointed to by s.Ifs is a null pointer or it points to an empty string, a64l()
returns 0 (zero).
ERRORS
None.
RELATED INFORMATION
Functions: l64a(3).
STANDARDS CONFORMANCE
The a64l() function is defined in the XPG4 Version 2 specification.
1−2 Hewlett-Packard Company 527192-018