ntohs()--Convert Short Integer to Host Byte Order


  BSD 4.3 Syntax
  #include <sys/types.h>
  #include <netinet/in.h>

 unsigned short ntohs(unsigned short network_short)

  Threadsafe: Yes



  UNIX® 98 Compatible Syntax
  #define _XOPEN_SOURCE 520
  #include <netinet/in.h>

 uint16_t ntohs(uint16_t network_short)

  Threadsafe: Yes


The ntohs() function is used to convert a short (2-byte) integer from the standard network byte order to the local host byte order.

There are two versions of the API, as shown above. The base IBM® i API uses BSD 4.3 structures and syntax. The other uses syntax and structures compatible with the UNIX 98 programming interface specifications. You can select the UNIX 98 compatible interface with the _XOPEN_SOURCE macro.


Parameters

network_short
(Input) The 2-byte integer in standard network byte order that is to be converted to local host byte order.

Authorities

No authorization is required.


Return Value

ntohs() returns an integer. Possible values are:


Usage Notes

On the System i® platform, the value returned to the caller is the same as the value that was passed to ntohs(), since the standard network byte order does not differ from the local host byte order.


Related Information



API introduced: V3R1

[ Back to top | UNIX-Type APIs | APIs by category ]