QHostAddress Class

멤버 함수 문서

QHostAddress::QHostAddress()

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

clear()도 참조하십시오 .

QHostAddress::QHostAddress(QHostAddress::SpecialAddress address)

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

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

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

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)

sockaddr 네이티브 구조체에서 지정한 주소를 사용하여 IPv4 또는 IPv6 주소를 생성합니다.

setAddress()도 참조하십시오 .

[explicit] QHostAddress::QHostAddress(quint32 ip4Addr)

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

QHostAddress::QHostAddress(const QHostAddress &address)

지정된 ` address`의 복사본을 생성합니다.

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

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 네트워크의 로컬 브로드캐스트 주소에 대해서는 true를 반환하지 않는다는 점에 유의하십시오. 로컬 머신의 브로드캐스트 주소를 얻으려면 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 사이트 로컬 주소는 더 이상 권장되지 않으며, 새로운 애플리케이션에서는 이를 전역 주소로 간주해야 합니다. 이 함수는 사이트 로컬 주소에 대해서도 true를 반환합니다.

isLoopback(), isSiteLocal(), isUniqueLocalUnicast() 및 isPrivateUse()도 참조하십시오 .

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

이 IP가 네트워크 접두사 subnet 및 넷마스크 netmask 로 정의된 서브넷에 속할 경우, true 를 반환합니다.

netmask 매개변수는 접두사 길이, 즉 주소의 네트워크 부분을 식별하는 데 사용되는 선행 비트 수를 나타냅니다. IPv4의 경우 유효한 값은 0에서 32까지이며, IPv6의 경우 0에서 128까지입니다.

IP 주소가 특정 서브넷의 최저 주소와 최고 주소 사이에 포함될 경우, 해당 서브넷에 속하는 것으로 간주됩니다. IPv4의 경우, 최저 주소는 네트워크 주소이며, 최고 주소는 브로드캐스트 주소입니다.

subnet 인수는 반드시 실제 네트워크 주소(서브넷의 가장 낮은 주소)일 필요는 없습니다. 해당 서브넷에 속하는 유효한 IP 주소라면 무엇이든 가능합니다. 특히, 이 인수가 이 객체가 보유한 IP 주소와 동일한 경우, 이 함수는 항상 true를 반환합니다(접두사 길이가 유효한 값인 경우에 한함).

parseSubnet()도 참조하십시오 .

bool QHostAddress::isInSubnet(const std::pair<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 루프백 주소이거나 IPv4 루프백 주소 중 하나인 경우 ` true `를 반환합니다.

bool QHostAddress::isMulticast() const

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

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

bool QHostAddress::isNull() const

이 호스트 주소가 어떤 호스트나 인터페이스에서도 유효하지 않은 경우 ` true `를 반환합니다.

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

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()도 true를 반환합니다). 사이트 로컬 주소는 고유 로컬 주소(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(), 및 isPrivateUse()도 참조하십시오 .

[static] std::pair<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은 다음과 같은 네 가지 수준의 접근성을 정의합니다:

• 노드 로컬(Node-local): 동일한 인터페이스(예: 루프백 인터페이스 "::1")상의 서비스와 통신하는 데만 사용되는 주소입니다.
• 링크 로컬(Link-local): 네트워크 인터페이스(링크)에 국한된 주소입니다. 호스트의 각 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개의 부호 없는 문자(unsigned character)로 구성됩니다.

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(other, StrictConversion)를 호출합니다.

isEqual()도 참조하십시오 .