与えられたホスト名に関する getaddrinfo の内容を配列で取得する

# socket_addrinfo_lookup

(PHP 7 >= 7.2.0, PHP 8)

socket_addrinfo_lookup — 与えられたホスト名に関する getaddrinfo の内容を配列で取得する

### 説明

function socket_addrinfo_lookup(string `$host`, ?string `$service` = `null`, array `$hints` = []): array|false

`host` に接続できる別のやり方を探します。 この関数が返す配列は socket_addrinfo_bind() を使ってバインドできる AddressInfo クラスのインスタンスが含まれています。

### パラメータ

`host`

  探す対象のホスト名

`service`

  接続するサービス。service が数値形式の文字列の場合、 ポート番号を指します。 それ以外の場合、ネットワークサービス名を指します。 これは、オペレーティングシステムによってポート番号にマップされます。

`hints`

  アドレスを選択する条件を与えるヒント。 getaddrinfo によって定義されるヒントを指定できます。

### 戻り値

socket_addrinfo_* 関数で使える AddressInfo クラスのインスタンスの配列を返します。 失敗した場合、`false` を返します。

### 変更履歴

バージョン | 説明
--- | ---
8.5.0 | `hints` 配列のいずれかの値が int にキャストできない場合は、TypeError をスローするようになりました。また、これらの値のいずれかがオーバーフローする場合は、 ValueError をスローすることがあります。
8.0.0 | 成功した場合に、この関数は AddressInfo クラスのインスタンスの配列を返すようになりました。 これより前のバージョンでは、リソースの配列を返していました。
8.0.0 | `service` は、nullable になりました。

### 参考

- socket_addrinfo_bind() - 与えられた addrinfo から、ソケットを作成してバインドする
- socket_addrinfo_connect() - 与えられた addrinfo から、ソケットを作って接続する
- socket_addrinfo_explain() - addrinfo に関する情報を取得する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open