NAME

htons - Converts an unsigned short (16-bit) integer from host byte order to network byte order

LIBRARY

Standard C Library (libc.so, libc.a)

SYNOPSIS

#include <arpa/inet.h> in_port_t htons (
in_port_t hostshort) ;

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

htons():  XPG4−UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags. 

PARAMETERS

hostshortSpecifies a 16-bit integer in host byte order. 

DESCRIPTION

The htons() (host-to-network short) function converts an unsigned short (16-bit) integer from host byte order to Internet network-byte order. 

The Internet network requires address and port reference data in network-byte order.  Use the htons() function to convert address and port short integers from host byte order to Internet network-byte order. 

RETURN VALUES

Upon successful completion, the htons() function returns a 16-bit short integer in Internet network-byte order. 

ERRORS

Current industry standards do not define error values for the htons() function. 

RELATED INFORMATION

Functions: endhostent(3), endservent(3), htonl(3), ntohl(3), ntohs(3). 

Standards: standards(5). 

Network Programmer’s Guide