socket_addrinfo_lookup

Get array with contents of getaddrinfo about the given hostname

&reftitle.description; ``array``false```socket_addrinfo_lookup` `string` `host` ``string``null```service`&null; `array` `hints`[]

Lookup different ways we can connect to `host`. The returned array contains a set of `AddressInfo` instances that we can bind to using `socket_addrinfo_bind`.

&reftitle.parameters;

`host`

- Hostname to search.

`service`

- The service to connect to. If service is a numeric string, it designates the port. Otherwise it designates a network service name, which is mapped to a port by the operating system.

`hints`

- Hints provide criteria for selecting addresses returned. You may specify the hints as defined by getaddrinfo.

&reftitle.returnvalues;

Returns an array of `AddressInfo` instances that can be used with the other socket_addrinfo functions. On failure, &false; is returned.

&reftitle.changelog;

&Version; | &Description;
8.0.0 | On success, this function returns a array of `AddressInfo` instances now; previously, an array of `resource`s was returned.
8.0.0 | `service` is nullable now.

&reftitle.seealso;

- `socket_addrinfo_bind`
- `socket_addrinfo_connect`
- `socket_addrinfo_explain`