IP

    Inherited By:

    Category: Core

    Internet protocol (IP) support functions like DNS resolution.

    Methods

    • RESOLVER_STATUS_NONE = 0 — DNS hostname resolver status: No status.
    • RESOLVER_STATUS_DONE = 2 — DNS hostname resolver status: Done.
    • RESOLVER_STATUS_ERROR = 3 — DNS hostname resolver status: Error.

    enum Type:

    • TYPE_NONE = 0 — Address type: None.
    • TYPE_IPV4 = 1 — Address type: Internet protocol version 4 (IPv4).
    • TYPE_IPV6 = 2 — Address type: Internet protocol version 6 (IPv6).
    • TYPE_ANY = 3 — Address type: Any.

    Constants

    • RESOLVER_MAX_QUERIES = 32 — Maximum number of concurrent DNS resolver queries allowed, RESOLVER_INVALID_ID is returned if exceeded.

    IP contains support functions for the Internet Protocol (IP). TCP/IP support is in different classes (see and TCP_Server). IP provides DNS hostname resolution support, both blocking and threaded.

    Method Descriptions

    • void clear_cache ( hostname=”” )

    Removes all of a “hostname“‘s cached references. If no “hostname” is given then all cached IP addresses are removed.


    • void erase_resolve_item ( int id )

    • get_local_addresses ( ) const

    Returns all of the user’s current IPv4 and IPv6 addresses as an array.


    • String get_resolve_item_address ( id ) const

    Returns a queued hostname’s IP address, given its queue “id”. Returns an empty string on error or if resolution hasn’t happened yet (see get_resolve_item_status).


    • get_resolve_item_status ( int id ) const

    Returns a queued hostname’s status as a RESOLVER_STATUS_* constant, given its queue “id”.


    • resolve_hostname ( String host, ip_type=3 )

    • int resolve_hostname_queue_item ( host, Type ip_type=3 )

    Creates a queue item to resolve a hostname to an IPv4 or IPv6 address depending on the TYPE_* constant given as “ip_type”. Returns the queue ID if successful, or RESOLVER_INVALID_ID on error.