io_hex_str_to_int(3K) DG/UX R4.11MU05 io_hex_str_to_int(3K)
NAME
iohexstrtoint - return the integer value of a hexadecimal string
SYNOPSIS
#include "/usr/src/uts/aviion/ii/iio.h"
booleantype iohexstrtoint (strptr, intvalueptr)
charptrtype strptr; /*READ ONLY*/
uint32ptrtype intvalueptr; /*WRITE ONLY*/
where:
intvalueptr A pointer to the location where the integer value is
to be returned.
strptr A pointer to the beginning of the string to convert.
DESCRIPTION
This routine returns the integer value of the null-terminated
hexadecimal string at strptr.
The routine scans a string strptr consisting only of the characters
0-9, a-f, and A-F, and terminated with a null character, returning
its unsigned 32-bit value at intvalueptr. If any other characters
are encountered or the value exceeds what can be expressed in a
32-bit unsigned value then intvalueptr is unchanged and an error is
returned.
DIAGNOSTICS
Return Value
FALSE Successful conversion occurred.
TRUE The string conversion failed.
SEE ALSO
ishex(3C).
Programming in the DG/UX Kernel Environment.
Licensed material--property of copyright holder(s)