Inside Macintosh: Open Transport /

Chapter 8 - TCP/IP Services / TCP/IP Services Reference

Functions / Address Utilities

OTInetStringToHost

Converts an IP address string from dotted-decimal notation or hexadecimal notation to an InetHost data type.

C INTERFACE

OSStatus OTInetStringToHost (char *str,
                             InetHost *host);

C++ INTERFACE

None. C++ clients use the C interface to this function.

PARAMETERS

str

A pointer to a character string containing an IP address in either dotted-decimal notation (for example, "12.13.14.15") or hexadecimal notation (for example, "0x0c0d0e0f").

host

A pointer to the address as an InetHost data type. The function allocates storage for this address and returns the pointer to you.

SPECIAL CONSIDERATIONS

The OTInetStringToHost function cannot block and always runs synchronously. It does not use the services of the DNR.

SEE ALSO

The InetHost data type is defined in "Basic Types and Constants" on page 8-20.

To convert an InetHost address into dotted-decimal format, use the OTInetHostToString function (described next).