htons サブルーチン

目的

符号なし短整数をホスト・バイト・オーダーからインターネット・ネットワーク・バイト・オーダーに変換します。

ライブラリー

ISODE ライブラリー (libisode.a)

構文

#include <sys/types.h>
#include <netinet/in.h>
uint16_t htons ( HostShort)
uint16_t HostShort;

説明

Hトン サブルーチンは、符号なし短 (16 ビット) 整数をホスト・バイト・オーダーからインターネット・ネットワーク・バイト・オーダーに変換します。

インターネット・ネットワークには、ネットワーク標準バイト・オーダーのポートとアドレスが必要です。 Hトン サブルーチンは、アドレスおよびポートをホスト整数表現からネットワーク標準バイト・オーダーに変換するために使用します。

htons サブルーチンは、ホスト・バイト・オーダーがネットワーク・バイト・オーダーと同じ場合、ヌル・マクロとして net/nh.h ファイルに定義されます。

htons サブルーチンは、ホスト・バイト・オーダーがネットワーク・バイト・オーダーと同じでない場合、関数として net/nh.h ファイルで宣言されます。

Hトン サブルーチンを含むすべてのアプリケーションは、 BSD (_BSD) マクロを特定の値に設定してコンパイルする必要があります。 許容値は 43 および 44 です。 さらに、すべてのソケット・アプリケーションに BSD libbsd.a ライブラリーを組み込む必要があります。

パラメーター

項目 説明
HostShort ホスト・アドレスまたはポートであるホスト・バイト・オーダーの 16 ビット整数を指定します。

戻り値

Hトン サブルーチンは、16 ビットの整数をインターネット・ネットワーク・バイト・オーダー (最上位バイトが先頭) で返します。