QHostAddress Class

멤버 함수 문서

QHostAddress::QHostAddress()

널 호스트 주소 객체, 즉 어떤 호스트나 인터페이스에도 유효하지 않은 주소를 생성합니다.

clear()도 참조하세요 .

QHostAddress::QHostAddress(QHostAddress::SpecialAddress address)

address 에 대한 QHostAddress 객체를 생성합니다.

[explicit] QHostAddress::QHostAddress(const QString &address)

address 문자열(예: "127.0.0.1")을 기반으로 IPv4 또는 IPv6 주소를 생성합니다.

setAddress()도 참조하세요 .

[explicit] QHostAddress::QHostAddress(const Q_IPV6ADDR &ip6Addr)

IPv6 주소 ip6Addr 로 호스트 주소 객체를 생성합니다.

[explicit] QHostAddress::QHostAddress(const quint8 *ip6Addr)

IPv6 주소 ip6Addr 로 호스트 주소 객체를 생성합니다.

ip6Addr 네트워크 바이트 순서(빅 엔디안)의 16바이트 배열이어야 합니다.

[explicit] QHostAddress::QHostAddress(const sockaddr *sockaddr)

네이티브 구조에 지정된 주소를 사용하여 IPv4 또는 IPv6 주소를 구축합니다 sockaddr.

setAddress()도 참조하세요 .

[explicit] QHostAddress::QHostAddress(quint32 ip4Addr)

IPv4 주소 ip4Addr 로 호스트 주소 객체를 생성합니다.

QHostAddress::QHostAddress(const QHostAddress &address)

주어진 address 의 복사본을 생성합니다.

[noexcept, since 6.8] QHostAddress::QHostAddress(QHostAddress &&other)

Move는 other 에서 새 QHostAddress를 생성합니다.

이 함수는 Qt 6.8에 도입되었습니다.

[noexcept] QHostAddress::~QHostAddress()

호스트 주소 객체를 삭제합니다.

void QHostAddress::clear()

호스트 주소를 null로 설정하고 프로토콜을 QAbstractSocket::UnknownNetworkLayerProtocol 로 설정합니다.

QHostAddress::Null도 참조하세요 .

bool QHostAddress::isBroadcast() const

주소가 IPv4 브로드캐스트 주소인 경우 true, 그렇지 않으면 false 을 반환합니다. IPv4 브로드캐스트 주소는 255.255.255.255입니다.

이 함수는 IPv4 네트워크의 로컬 브로드캐스트 주소에 대해서는 참을 반환하지 않는다는 점에 유의하세요. 이 경우 QNetworkInterface 을 사용하여 로컬 컴퓨터의 브로드캐스트 주소를 얻으세요.

isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast() 및 isPrivateUse()도 참조하세요 .

bool QHostAddress::isEqual(const QHostAddress &other, QHostAddress::ConversionMode mode = TolerantConversion) const

이 호스트 주소가 지정된 other 주소와 같으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

mode 매개변수는 서로 다른 프로토콜의 주소 간에 수행되는 변환을 제어합니다. mode 을 지정하지 않으면 기본적으로 TolerantConversion 이 수행됩니다.

ConversionMode 및 operator==()도 참조하세요 .

bool QHostAddress::isGlobal() const

주소가 IPv4 또는 IPv6 글로벌 주소인 경우 true, 그렇지 않은 경우 false 을 반환합니다. 글로벌 주소는 루프백이나 멀티캐스트와 같은 특수 목적이나 향후 사용을 위해 예약되지 않은 주소입니다.

IPv6 고유 로컬 유니캐스트 주소는 글로벌 주소로 간주되며( isUniqueLocalUnicast() 참조), RFC 1918에 의해 로컬 네트워크용으로 예약된 IPv4 주소도 마찬가지입니다.

또한 IPv6 사이트-로컬 주소는 더 이상 사용되지 않으므로 새 애플리케이션에서는 글로벌 주소로 간주해야 합니다. 이 함수는 사이트-로컬 주소에 대해서도 참을 반환합니다.

isLoopback(), isSiteLocal(), isUniqueLocalUnicast() 및 isPrivateUse()도 참조하세요 .

bool QHostAddress::isInSubnet(const QHostAddress &subnet, int netmask) const

이 IP가 네트워크 접두사 subnet 및 넷마스크 netmask 로 설명되는 서브넷에 있는 경우 true 를 반환합니다.

IP가 해당 서브넷의 가장 낮은 주소와 가장 높은 주소 사이에 포함되어 있으면 서브넷에 속한 것으로 간주합니다. IP 버전 4의 경우 가장 낮은 주소가 네트워크 주소이고 가장 높은 주소가 브로드캐스트 주소입니다.

subnet 인수는 실제 네트워크 주소(서브넷에서 가장 낮은 주소)일 필요는 없습니다. 해당 서브넷에 속한 모든 유효한 IP가 될 수 있습니다. 특히 이 객체가 보유한 IP 주소와 같으면 이 함수는 항상 참을 반환합니다(넷마스크가 유효한 값인 경우).

parseSubnet()도 참조하세요 .

bool QHostAddress::isInSubnet(const QPair<QHostAddress, int> &subnet) const

이 함수는 오버로드된 함수입니다.

이 IP가 subnet 에 설명된 서브넷에 있는 경우 true 를 반환합니다. subnet 의 QHostAddress 멤버에는 네트워크 접두사가 포함되고 int(두 번째) 멤버에는 넷마스크(접두사 길이)가 포함됩니다.

bool QHostAddress::isLinkLocal() const

주소가 IPv4 또는 IPv6 링크-로컬 주소인 경우 true, 그렇지 않은 경우 false 을 반환합니다.

IPv4 링크-로컬 주소는 네트워크 169.254.0.0/16에 있는 주소입니다. IPv6 링크-로컬 주소는 네트워크 fe80::/10에 있는 주소입니다. 자세한 내용은 IANA IPv6 주소 공간 레지스트리를 참조하세요.

isLoopback(), isGlobal(), isMulticast(), isSiteLocal(), isUniqueLocalUnicast() 및 isPrivateUse()도 참조하세요 .

bool QHostAddress::isLoopback() const

주소가 IPv6 루프백 주소인 경우 true, 또는 IPv4 루프백 주소 중 하나라도 반환합니다.

bool QHostAddress::isMulticast() const

주소가 IPv4 또는 IPv6 멀티캐스트 주소인 경우 true, 그렇지 않으면 false 을 반환합니다.

isLoopback(), isGlobal(), isLinkLocal(), isSiteLocal(), isUniqueLocalUnicast() 및 isPrivateUse()도 참조하세요 .

bool QHostAddress::isNull() const

이 호스트 주소가 호스트 또는 인터페이스에 유효하지 않은 경우 true 을 반환합니다.

기본 생성자는 널 주소를 생성합니다.

QHostAddress::Null 를참조하세요 .

[since 6.6] bool QHostAddress::isPrivateUse() const

주소가 IPv6 고유 로컬 유니캐스트 주소이거나 RFC 1918에 의해 로컬 네트워크용으로 예약된 IPv4 주소인 경우 true, 그렇지 않으면 false 을 반환합니다.

이 함수는 Qt 6.6에 도입되었습니다.

isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast() 및 isBroadcast()도 참조하십시오 .

bool QHostAddress::isSiteLocal() const

주소가 IPv6 사이트-로컬 주소인 경우 true, 그렇지 않으면 false 을 반환합니다.

IPv6 사이트-로컬 주소는 네트워크 fec0::/10에 있는 주소입니다. 자세한 내용은 IANA IPv6 주소 공간 레지스트리를 참조하세요.

IPv6 사이트-로컬 주소는 더 이상 사용되지 않으므로 새 애플리케이션에 의존해서는 안 됩니다. 새 애플리케이션은 이 함수에 의존해서는 안 되며 사이트-로컬 주소를 글로벌 주소와 동일하게 간주해야 합니다( isGlobal()도 참을 반환하는 이유입니다). 사이트-로컬 주소는 ULA(고유 로컬 주소)로 대체되었습니다.

isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast() 및 isPrivateUse()도 참조하세요 .

bool QHostAddress::isUniqueLocalUnicast() const

주소가 IPv6 고유 로컬 유니캐스트 주소인 경우 true, 그렇지 않은 경우 false 을 반환합니다.

IPv6 고유 로컬 유니캐스트 주소는 네트워크 fc00::/7에 있는 주소입니다. 자세한 내용은 IANA IPv6 주소 공간 레지스트리를 참조하세요.

고유 로컬 유니캐스트 주소도 글로벌 주소로 계산된다는 점에 유의하세요. RFC 4193에 따르면 실제로 "애플리케이션은 이러한 주소를 글로벌 범위 주소처럼 취급할 수 있다"고 명시되어 있습니다. 라우터만 이 구분을 신경 써야 합니다.

isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast() 및 isPrivateUse()도 참조하세요 .

[static] QPair<QHostAddress, int> QHostAddress::parseSubnet(const QString &subnet)

subnet 에 포함된 IP 및 서브넷 정보를 구문 분석하여 해당 네트워크의 네트워크 접두사 및 접두사 길이를 반환합니다.

IP 주소와 넷마스크는 슬래시(/)로 구분해야 합니다.

이 함수는 다음과 같은 형식의 인수를 지원합니다:

• 123.123.123.123/n 여기서 n은 0에서 32 사이의 임의의 값입니다.
• 123.123.123.123/255.255.255.255
• <ipv6-address>/n 여기서 n은 0에서 128 사이의 임의의 값입니다.

IP 버전 4의 경우 이 함수는 누락된 후행 구성 요소(예: "192.168.1"과 같이 4옥텟 미만)에 점이 오거나 오지 않는 것도 허용합니다. 이 경우 넷마스크도 누락된 경우 실제로 전달된 옥텟 수로 설정됩니다(위의 예에서는 3옥텟의 경우 24가 됩니다).

isInSubnet()도 참조하세요 .

int QHostAddress::protocol() const

호스트 주소의 네트워크 계층 프로토콜을 반환합니다.

QString QHostAddress::scopeId() const

IPv6 주소의 범위 ID를 반환합니다. IPv4 주소의 경우 또는 주소에 범위 ID가 포함되지 않은 경우 빈 QString 이 반환됩니다.

IPv6 범위 ID는 비글로벌 IPv6 주소의 도달 가능 범위를 지정하여 해당 주소가 사용될 수 있는 영역을 제한합니다. 모든 IPv6 주소는 이러한 도달 가능성 범위와 연결됩니다. 범위 ID는 전 세계적으로 고유하지 않은 주소를 구분하는 데 사용됩니다.

IPv6는 다음 네 가지 수준의 도달 가능성을 지정합니다:

• 노드-로컬: 동일한 인터페이스의 서비스와 통신하는 데만 사용되는 주소(예: 루프백 인터페이스 "::1").
• 링크-로컬: 네트워크 인터페이스(링크)에 로컬인 주소입니다. 호스트의 각 IPv6 인터페이스에는 항상 링크-로컬 주소가 하나씩 있습니다. 링크-로컬 주소("fe80...")는 로컬 네트워크 어댑터의 MAC 주소에서 생성되며 고유하다는 보장은 없습니다.
• 글로벌: 글로벌: 인터넷의 공용 서버와 같이 전 세계적으로 라우팅 가능한 주소에 사용됩니다.

IPv6 연결에 링크-로컬 또는 사이트-로컬 주소를 사용하는 경우 범위 ID를 지정해야 합니다. 링크-로컬 주소의 범위 ID는 일반적으로 인터페이스 이름(예: "eth0", "en1") 또는 번호(예: "1", "2")와 동일합니다.

setScopeId(), QNetworkInterface, QNetworkInterface::interfaceFromName 를참조하세요 .

void QHostAddress::setAddress(quint32 ip4Addr)

ip4Addr 에서 지정한 IPv4 주소를 설정합니다.

void QHostAddress::setAddress(QHostAddress::SpecialAddress address)

이 함수는 오버로드된 함수입니다.

address 에 지정된 특수 주소를 설정합니다.

bool QHostAddress::setAddress(const QString &address)

이 함수는 오버로드된 함수입니다.

address 에 지정된 문자열 표현(예: "127.0.0.1")으로 지정된 IPv4 또는 IPv6 주소를 설정합니다. 주소가 성공적으로 구문 분석된 경우 true 을 반환하고 주소를 설정하며, 그렇지 않으면 false 을 반환합니다.

void QHostAddress::setAddress(const Q_IPV6ADDR &ip6Addr)

이것은 과부하된 기능입니다.

ip6Addr 에서 지정한 IPv6 주소를 설정합니다.

void QHostAddress::setAddress(const quint8 *ip6Addr)

이것은 과부하된 기능입니다.

ip6Addr 에서 지정한 IPv6 주소를 설정합니다.

ip6Addr 네트워크 바이트 순서(고차 바이트 우선)로 16바이트 배열이어야 합니다.

void QHostAddress::setAddress(const sockaddr *sockaddr)

이 함수는 오버로드된 함수입니다.

네이티브 구조체 sockaddr 에 지정된 IPv4 또는 IPv6 주소를 설정합니다. 주소가 성공적으로 구문 분석된 경우 true 을 반환하고 주소를 설정하며, 그렇지 않으면 false 을 반환합니다.

void QHostAddress::setScopeId(const QString &id)

주소의 IPv6 범위 ID를 id 로 설정합니다. 주소 프로토콜이 IPv6가 아닌 경우 이 함수는 아무 작업도 수행하지 않습니다. 범위 ID는 인터페이스 이름(예: "eth0" 또는 "en1")으로 설정하거나 인터페이스 인덱스를 나타내는 정수로 설정할 수 있습니다. id 이 인터페이스 이름인 경우 QtNetwork 은 운영 체제 네트워킹 함수를 호출하기 전에 QNetworkInterface::interfaceIndexFromName()을 사용하여 인터페이스 인덱스로 변환합니다.

scopeId(), QNetworkInterface, QNetworkInterface::interfaceFromName도 참조하세요 .

[noexcept] void QHostAddress::swap(QHostAddress &other)

이 호스트 주소를 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

quint32 QHostAddress::toIPv4Address(bool *ok = nullptr) const

IPv4 주소를 숫자로 반환합니다.

예를 들어 주소가 127.0.0.1인 경우 반환되는 값은 2130706433(즉, 0x7f000001)입니다.

이 값은 protocol()가 IPv4Protocol 이거나 프로토콜이 IPv6Protocol 이고 IPv6 주소가 IPv4 매핑된 주소(RFC4291)인 경우에 유효합니다. 이러한 경우 ok 는 true로 설정됩니다. 그렇지 않으면 false로 설정됩니다.

toString()도 참조하세요 .

Q_IPV6ADDR QHostAddress::toIPv6Address() const

IPv6 주소를 Q_IPV6ADDR 구조체로 반환합니다. 이 구조체는 부호 없는 16개의 문자로 구성됩니다.

Q_IPV6ADDR addr = hostAddr.toIPv6Address();
// addr contains 16 unsigned characters

for (int i = 0; i < 16; ++i) {
    // process addr[i]
}

이 값은 protocol()가 IPv6Protocol 인 경우에 유효합니다. 프로토콜이 IPv4Protocol 인 경우 주소는 IPv4 매핑된 IPv6 주소로 반환됩니다. (RFC4291)

toString()도 참조하세요 .

QString QHostAddress::toString() const

주소를 문자열로 반환합니다.

예를 들어 주소가 IPv4 주소 127.0.0.1인 경우 반환되는 문자열은 "127.0.0.1"입니다. IPv6의 경우 문자열 형식은 RFC5952 권장 사항을 따릅니다. QHostAddress::Any 의 경우 IPv4 주소가 반환됩니다("0.0.0.0").

toIPv4Address()도 참조하세요 .

bool QHostAddress::operator!=(QHostAddress::SpecialAddress other) const

이 호스트 주소가 지정된 other 주소와 같지 않으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QHostAddress::operator!=(const QHostAddress &other) const

이 호스트 주소가 지정된 other 주소와 같지 않으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

QHostAddress &QHostAddress::operator=(QHostAddress::SpecialAddress address)

이 객체에 특수 주소 address 를 할당하고 이 객체에 대한 참조를 반환합니다.

setAddress()도 참조하세요 .

QHostAddress &QHostAddress::operator=(const QHostAddress &address)

이 객체에 다른 호스트 address 를 할당하고 이 객체에 대한 참조를 반환합니다.

bool QHostAddress::operator==(QHostAddress::SpecialAddress other) const

이 호스트 주소가 지정된 other 주소와 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QHostAddress::operator==(const QHostAddress &other) const

이 호스트 주소가 주어진 other 주소와 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 이 연산자는 isEqual(기타, StrictConversion)를 호출합니다.

isEqual()도 참조하세요 .