strtoq()

convert string to 64-bit integer 

Function

SYNOPSIS

#include <sys/types.h>

#include <stdlib.h>

quad_t strtoq(const char *nptr, char **endptr, int base);

DESCRIPTION

The strtoq() function converts the string pointed to by nptr to a 64-bit, long-long integer representation. This function recognizes (in order) an optional string of spaces, an optional sign, an optional base indicator (0 for octal, X or x for hexadecimal), and a string of digits. The first unrecognized character ends the string. A pointer to this unrecognized character is stored in the object addressed by endptr, if endptr is not NULL.

If base is non-zero, its value determines the set of recognized digits and overrides the optional base indicator character. If base is zero, nptr is assumed to be base 10, unless an optional base indicator character is given.

PARAMETERS

nptr 

Points to a character string for strtoq() to convert.

endptr 

Is a result parameter that, if not NULL, returns a string beginning with the first character that strtoq() does not attempt to convert.

base 

Is the base of the string, a value between 0 and 36.

RETURN VALUES

The strtoq() function returns the converted value, if there is any. If no conversion was performed, strtoq() returns a zero. If the converted value overflows, strtoq() returns QUAD_MAX or QUAD_MIN (according to the sign of the value) and sets errno to ERANGE.

CONFORMANCE

4.4BSD.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

None.

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
strtol(), strtoul(), strtouq()

PTC MKS Toolkit 10.0 Documentation Build 6.