QHostAddress Class Reference |
enum | SpecialAddress { Null, LocalHost, LocalHostIPv6, Broadcast, Any, AnyIPv6 } |
QHostAddress () | |
QHostAddress ( quint32 ip4Addr ) | |
QHostAddress ( quint8 * ip6Addr ) | |
QHostAddress ( const Q_IPV6ADDR & ip6Addr ) | |
QHostAddress ( const sockaddr * sockaddr ) | |
QHostAddress ( const QString & address ) | |
QHostAddress ( const QHostAddress & address ) | |
QHostAddress ( SpecialAddress address ) | |
~QHostAddress () | |
void | clear () |
bool | isInSubnet ( const QHostAddress & subnet, int netmask ) const |
bool | isInSubnet ( const QPair<QHostAddress, int> & subnet ) const |
bool | isNull () const |
QAbstractSocket::NetworkLayerProtocol | protocol () const |
QString | scopeId () const |
void | setAddress ( quint32 ip4Addr ) |
void | setAddress ( quint8 * ip6Addr ) |
void | setAddress ( const Q_IPV6ADDR & ip6Addr ) |
bool | setAddress ( const QString & address ) |
void | setAddress ( const sockaddr * sockaddr ) |
void | setScopeId ( const QString & id ) |
quint32 | toIPv4Address () const |
Q_IPV6ADDR | toIPv6Address () const |
QString | toString () const |
bool | operator!= ( const QHostAddress & other ) const |
bool | operator!= ( SpecialAddress other ) const |
QHostAddress & | operator= ( const QHostAddress & address ) |
QHostAddress & | operator= ( const QString & address ) |
bool | operator== ( const QHostAddress & other ) const |
bool | operator== ( SpecialAddress other ) const |
QPair<QHostAddress, int> | parseSubnet ( const QString & subnet ) |
QDataStream & | operator<< ( QDataStream & out, const QHostAddress & address ) |
QDataStream & | operator>> ( QDataStream & in, QHostAddress & address ) |
The QHostAddress class provides an IP address.
This class holds an IPv4 or IPv6 address in a platform- and protocol-independent manner.
QHostAddress is normally used with the QTcpSocket, QTcpServer, and QUdpSocket to connect to a host or to set up a server.
A host address is set with setAddress(), checked for its type using isIPv4Address() or isIPv6Address(), and retrieved with toIPv4Address(), toIPv6Address(), or toString().
Note: Please note that QHostAddress does not do DNS lookups. QHostInfo is needed for that.
The class also supports common predefined addresses: Null, LocalHost, LocalHostIPv6, Broadcast, and Any.
See also QHostInfo, QTcpSocket, QTcpServer, and QUdpSocket.
Constant | Value | Description |
---|---|---|
QHostAddress::Null | 0 | The null address object. Equivalent to QHostAddress(). |
QHostAddress::LocalHost | 2 | The IPv4 localhost address. Equivalent to QHostAddress("127.0.0.1"). |
QHostAddress::LocalHostIPv6 | 3 | The IPv6 localhost address. Equivalent to QHostAddress("::1"). |
QHostAddress::Broadcast | 1 | The IPv4 broadcast address. Equivalent to QHostAddress("255.255.255.255"). |
QHostAddress::Any | 4 | The IPv4 any-address. Equivalent to QHostAddress("0.0.0.0"). |
QHostAddress::AnyIPv6 | 5 | The IPv6 any-address. Equivalent to QHostAddress("::"). |
Constructs a host address object with the IP address 0.0.0.0.
See also clear().
Constructs a host address object with the IPv4 address ip4Addr.
Constructs a host address object with the IPv6 address ip6Addr.
ip6Addr must be a 16-byte array in network byte order (big endian).
Constructs a host address object with the IPv6 address ip6Addr.
Constructs an IPv4 or IPv6 address using the address specified by the native structure sockaddr.
See also setAddress().
Constructs an IPv4 or IPv6 address based on the string address (e.g., "127.0.0.1").
See also setAddress().
Constructs a copy of the given address.
Constructs a QHostAddress object for address.
Destroys the host address object.
Sets the host address to 0.0.0.0.
Returns true if this IP is in the subnet described by the network prefix subnet and netmask netmask.
An IP is considered to belong to a subnet if it is contained between the lowest and the highest address in that subnet. In the case of IP version 4, the lowest address is the network address, while the highest address is the broadcast address.
The subnet argument does not have to be the actual network address (the lowest address in the subnet). It can be any valid IP belonging to that subnet. In particular, if it is equal to the IP address held by this object, this function will always return true (provided the netmask is a valid value).
This function was introduced in Qt 4.5.
See also parseSubnet().
This is an overloaded function.
Returns true if this IP is in the subnet described by subnet. The QHostAddress member of subnet contains the network prefix and the int (second) member contains the netmask (prefix length).
This function was introduced in Qt 4.5.
Returns true if this host address is null (INADDR_ANY or in6addr_any). The default constructor creates a null address, and that address is not valid for any host or interface.
Parses the IP and subnet information contained in subnet and returns the network prefix for that network and its prefix length.
The IP address and the netmask must be separated by a slash (/).
This function supports arguments in the form:
For IP version 4, this function accepts as well missing trailing components (i.e., less than 4 octets, like "192.168.1"), followed or not by a dot. If the netmask is also missing in that case, it is set to the number of octets actually passed (in the example above, it would be 24, for 3 octets).
This function was introduced in Qt 4.5.
See also isInSubnet().
Returns the network layer protocol of the host address.
Returns the scope ID of an IPv6 address. For IPv4 addresses, or if the address does not contain a scope ID, an empty QString is returned.
The IPv6 scope ID specifies the scope of reachability for non-global IPv6 addresses, limiting the area in which the address can be used. All IPv6 addresses are associated with such a reachability scope. The scope ID is used to disambiguate addresses that are not guaranteed to be globally unique.
IPv6 specifies the following four levels of reachability:
When using a link-local or site-local address for IPv6 connections, you must specify the scope ID. The scope ID for a link-local address is usually the same as the interface name (e.g., "eth0", "en1") or number (e.g., "1", "2").
This function was introduced in Qt 4.1.
See also setScopeId().
Set the IPv4 address specified by ip4Addr.
This is an overloaded function.
Set the IPv6 address specified by ip6Addr.
ip6Addr must be an array of 16 bytes in network byte order (high-order byte first).
This is an overloaded function.
Set the IPv6 address specified by ip6Addr.
This is an overloaded function.
Sets the IPv4 or IPv6 address specified by the string representation specified by address (e.g. "127.0.0.1"). Returns true and sets the address if the address was successfully parsed; otherwise returns false.
This is an overloaded function.
Sets the IPv4 or IPv6 address specified by the native structure sockaddr. Returns true and sets the address if the address was successfully parsed; otherwise returns false.
Sets the IPv6 scope ID of the address to id. If the address protocol is not IPv6, this function does nothing.
This function was introduced in Qt 4.1.
See also scopeId().
Returns the IPv4 address as a number.
For example, if the address is 127.0.0.1, the returned value is 2130706433 (i.e. 0x7f000001).
This value is only valid if isIp4Addr() returns true.
See also toString().
Returns the IPv6 address as a Q_IPV6ADDR structure. The structure consists of 16 unsigned characters.
Q_IPV6ADDR addr = hostAddr.toIPv6Address(); // addr contains 16 unsigned characters for (int i = 0; i < 16; ++i) { // process addr[i] }
This value is only valid if isIPv6Address() returns true.
See also toString().
Returns the address as a string.
For example, if the address is the IPv4 address 127.0.0.1, the returned string is "127.0.0.1".
See also toIPv4Address().
Returns true if this host address is not the same as the other address given; otherwise returns false.
This function was introduced in Qt 4.2.
Returns true if this host address is not the same as the other address given; otherwise returns false.
Assigns another host address to this object, and returns a reference to this object.
Assigns the host address address to this object, and returns a reference to this object.
See also setAddress().
Returns true if this host address is the same as the other address given; otherwise returns false.
Returns true if this host address is the same as the other address given; otherwise returns false.
Writes host address address to the stream out and returns a reference to the stream.
See also Format of the QDataStream operators.
Reads a host address into address from the stream in and returns a reference to the stream.
See also Format of the QDataStream operators.
Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt 4.6 | |
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! |
Copyright © 2000-2012 - www.developpez.com