Class Poco::Net::SocketAddress

File Information

Library: Net
Package: NetCore
Header: Poco/Net/SocketAddress.h

Description

This class represents an internet (IP) endpoint/socket address. The address can belong either to the IPv4 or the IPv6 address family and consists of a host address and a port number.

Member Summary

Member Functions: addr, af, family, host, init, length, operator !=, operator <, operator =, operator ==, port, resolveService, toString

Types Aliases

Enumerations

Anonymous

MAX_ADDRESS_LENGTH = sizeof (struct sockaddr_un)

Maximum length in bytes of a socket address.

Constructors

SocketAddress

SocketAddress();

Creates a wildcard (all zero) IPv4 SocketAddress.

SocketAddress

explicit SocketAddress(
Family family
);

Creates a SocketAddress with unspecified (wildcard) IP address of the given family.

SocketAddress

explicit SocketAddress(
Poco::UInt16 port
);

Creates a SocketAddress with unspecified (wildcard) IP address and given port number.

SocketAddress

explicit SocketAddress(
const std::string & hostAndPort
);

Creates a SocketAddress from an IP address or host name and the port number/service name. Host name/address and port number must be separated by a colon. In case of an IPv6 address, the address part must be enclosed in brackets.

Examples:

192.168.1.10:80
[::ffff:192.168.1.120]:2040
www.appinf.com:8080

On POSIX platforms supporting UNIX_LOCAL sockets, hostAndPort can also be the absolute path of a local socket, starting with a slash, e.g. "/tmp/local.socket".

SocketAddress

SocketAddress(
const SocketAddress & addr
);

Creates a SocketAddress by copying another one.

SocketAddress

SocketAddress(
const IPAddress & hostAddress,
Poco::UInt16 portNumber
);

Creates a SocketAddress from an IP address and given port number.

SocketAddress

SocketAddress(
Family family,
Poco::UInt16 port
);

Creates a SocketAddress with unspecified (wildcard) IP address of the given family, and given port number.

SocketAddress

SocketAddress(
const std::string & hostAddress,
Poco::UInt16 portNumber
);

Creates a SocketAddress from an IP address and given port number.

The IP address must either be a domain name, or it must be in dotted decimal (IPv4) or hex string (IPv6) format.

SocketAddress

SocketAddress(
const std::string & hostAddress,
const std::string & portNumber
);

Creates a SocketAddress from an IP address and the service name or port number.

The IP address must either be a domain name, or it must be in dotted decimal (IPv4) or hex string (IPv6) format.

The given port must either be a decimal port number, or a service name.

SocketAddress

SocketAddress(
Family family,
const std::string & addr
);

Creates a SocketAddress of the given family from a string representation of the address, which is either an IP address and port number, separated by a colon for IPv4 or IPv6 addresses, or a path for UNIX_LOCAL sockets.

SocketAddress

SocketAddress(
const struct sockaddr * addr,
socklen_t length
);

Creates a SocketAddress from a native socket address.

SocketAddress

SocketAddress(
    Family family,
    const std::string & hostAddress,
    Poco::UInt16 portNumber
);

Creates a SocketAddress from an IP address and given port number.

The IP address must either be a domain name, or it must be in dotted decimal (IPv4) or hex string (IPv6) format.

If a domain name is given in hostAddress, it is resolved and the address matching the given family is used. If no address matching the given family is found, or the IP address given in hostAddress does not match the given family, an AddressFamilyMismatchException is thrown.