gethostname() - ホスト・プロセッサー名の取得

標準

標準/拡張機能	C/C++	依存項目
XPG4.2 Single UNIX Specification、バージョン 3	両方

X/Open:

#define _XOPEN_SOURCE_EXTENDED 1
#include <unistd.h>

int gethostname(char *name, size_t namelen);

バークレー・ソケット:

#define _OE_SOCKETS
#include <unistd.h>

int gethostname(char *name, int namelen);

gethostname() 呼び出しは、プログラムが実行中のホスト・プロセッサーの名前を戻します。namelen 文字までを name 配列へコピーします。戻された name は、name 配列に十分なスペースがある限り、NULL 終了になります。

C++ の特殊な動作: C++ でこの関数を使用するには、_XOPEN_SOURCE_EXTENDED 1 フィーチャー・テスト・マクロを使用する必要があります。

正常に実行された場合、gethostname() は 0 を戻します。

正常に実行されなかった場合、gethostname() は -1 を戻して、errno を次のいずれかの値に設定します。

エラー・コード: 説明
EFAULT: name と namelen を使用した結果、呼び出し元のアドレス・スペース内のデータを書き込むことができない部分にアドレスをコピーすることになります。
EMVSPARM: 無効なパラメーターがサービスに渡されました。