Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ io_hex_str_to_int(3K) — DG/UX R4.11MU05

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ishex(3C)



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)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026