QNetworkInterface Class

멤버 함수 문서

QNetworkInterface::QNetworkInterface()

빈 네트워크 인터페이스 객체를 생성합니다.

QNetworkInterface::QNetworkInterface(const QNetworkInterface &other)

other 에 포함된 QNetworkInterface 객체의 복사본을 생성합니다.

[noexcept] QNetworkInterface::~QNetworkInterface()

QNetworkInterface 객체와 관련된 리소스를 해제합니다.

QList<QNetworkAddressEntry> QNetworkInterface::addressEntries() const

이 인터페이스가 보유한 IP 주소 목록과 해당 넷마스크 및 브로드캐스트 주소를 반환합니다.

넷마스크나 브로드캐스트 주소, 기타 정보가 필요하지 않은 경우, ` allAddresses()` 함수를 호출하여 활성 인터페이스의 IP 주소만 얻을 수 있습니다.

[static] QList<QHostAddress> QNetworkInterface::allAddresses()

이 편의 함수는 호스트 컴퓨터에서 발견된 모든 IP 주소를 반환합니다. 이는 ` allInterfaces()`가 반환한 객체 중 ` QNetworkInterface::IsUp ` 상태에 있는 모든 객체에 대해 ` addressEntries()`를 호출하여 ` QNetworkAddressEntry ` 객체 목록을 얻은 다음, 이 목록에 포함된 각 객체에 대해 ` QNetworkAddressEntry::ip()`를 호출하는 것과 동일합니다.

[static] QList<QNetworkInterface> QNetworkInterface::allInterfaces()

호스트 컴퓨터에서 발견된 모든 네트워크 인터페이스의 목록을 반환합니다. 실패할 경우 요소가 없는 목록을 반환합니다.

QNetworkInterface::InterfaceFlags QNetworkInterface::flags() const

이 네트워크 인터페이스와 관련된 플래그를 반환합니다.

QString QNetworkInterface::hardwareAddress() const

이 인터페이스의 저수준 하드웨어 주소를 반환합니다. 이더넷 인터페이스의 경우, 이 값은 콜론으로 구분된 문자열 형식의 MAC 주소가 됩니다.

다른 인터페이스 유형의 경우 다른 유형의 하드웨어 주소를 가질 수 있습니다. 구현에서는 이 함수가 유효한 MAC 주소를 반환한다고 가정해서는 안 됩니다.

type()함수도 참조하십시오 .

QString QNetworkInterface::humanReadableName() const

Windows에서 이 네트워크 인터페이스의 사람이 읽기 쉬운 이름(예: “Local Area Connection”)을 확인할 수 있는 경우 해당 이름을 반환합니다. 이름을 확인할 수 없는 경우, 이 함수는 ` name()`와 동일한 결과를 반환합니다. 사람이 읽기 쉬운 이름은 사용자가 Windows 제어판에서 수정할 수 있는 이름이므로, 프로그램 실행 중에 변경될 수 있습니다.

유닉스에서는 유닉스 시스템이 사람이 읽기 쉬운 이름에 대한 설정을 저장하지 않기 때문에, 이 함수는 현재 항상 name()과 동일한 결과를 반환합니다.

int QNetworkInterface::index() const

알려져 있는 경우, 인터페이스 시스템 인덱스를 반환합니다. 이는 운영 체제가 해당 인터페이스를 식별하기 위해 할당하는 정수이며, 일반적으로 변경되지 않습니다. 이 값은 IPv6 주소의 범위 ID 필드와 일치합니다.

인덱스를 알 수 없는 경우, 이 함수는 0을 반환합니다.

[static] QNetworkInterface QNetworkInterface::interfaceFromIndex(int index)

내부 ID가 index 인 인터페이스에 대한 ` QNetworkInterface ` 객체를 반환합니다. 네트워크 인터페이스에는 시스템 내의 다른 인터페이스와 구별하기 위해 “인터페이스 인덱스”라고 하는 고유 식별자가 있습니다. 대개 이 값은 순차적으로 할당되며, 제거되었다가 다시 추가되는 인터페이스는 매번 다른 값을 받게 됩니다.

이 인덱스는 IPv6 주소의 범위 ID(scope ID) 필드에서도 확인할 수 있습니다.

[static] QNetworkInterface QNetworkInterface::interfaceFromName(const QString &name)

name 라는 이름의 인터페이스에 대한 QNetworkInterface 객체를 반환합니다. 해당 인터페이스가 존재하지 않는 경우, 이 함수는 유효하지 않은 QNetworkInterface 객체를 반환합니다.

문자열 name 은 실제 인터페이스 이름(예: "eth0" 또는 "en1")이거나 문자열 형식의 인터페이스 인덱스("1", "2" 등)일 수 있습니다.

name() 및 isValid()도 참조하십시오 .

[static] int QNetworkInterface::interfaceIndexFromName(const QString &name)

name 라는 이름의 인터페이스 인덱스를 반환하며, 해당 이름의 인터페이스가 없는 경우에는 0을 반환합니다. 이 함수는 다음 코드와 동일한 결과를 산출해야 하지만, 실행 속도는 더 빠를 것입니다.

    QNetworkInterface::interfaceFromName(name).index()

interfaceFromName(), interfaceNameFromIndex(), QNetworkDatagram::interfaceIndex()도 참조하십시오 .

[static] QString QNetworkInterface::interfaceNameFromIndex(int index)

인덱스가 index 인 인터페이스의 이름을 반환하며, 해당 인덱스의 인터페이스가 없는 경우 빈 문자열을 반환합니다. 이 함수는 다음 코드와 동일한 결과를 산출해야 하지만, 실행 속도는 더 빠를 것입니다.

    QNetworkInterface::interfaceFromIndex(index).name()

interfaceFromIndex(), interfaceIndexFromName(), QNetworkDatagram::interfaceIndex()도 참조하십시오 .

bool QNetworkInterface::isValid() const

이 QNetworkInterface 객체가 네트워크 인터페이스에 대한 유효한 정보를 포함하고 있는 경우, true 를 반환합니다.

int QNetworkInterface::maximumTransmissionUnit() const

이 인터페이스의 최대 전송 단위(MTU)를 알고 있는 경우 해당 값을 반환하고, 그렇지 않은 경우 0을 반환합니다.

최대 전송 단위(MTU)는 링크 계층에서 조각화(fragmentation)가 발생하지 않고 이 인터페이스를 통해 전송할 수 있는 가장 큰 패킷 크기입니다. 애플리케이션은 이 값을 사용하여 조각화되지 않은 UDP 데이터그램에 들어갈 수 있는 페이로드 크기를 계산할 수 있습니다. 전송 가능한 페이로드 크기를 계산할 때는, 해당 인터페이스를 통한 통신에 사용되는 헤더 크기(예: TCP(20바이트) 또는 UDP(12바이트), IPv4(20바이트) 또는 IPv6(헤더 압축 방식이 없는 경우 40바이트))를 반드시 차감해야 합니다. 또한 목적지까지의 전체 경로(경로 MTU)상의 MTU가 인터페이스의 MTU보다 작을 수 있다는 점에 유의하십시오.

QUdpSocket도 참조하십시오 .

QString QNetworkInterface::name() const

이 네트워크 인터페이스의 이름을 반환합니다. 유닉스 시스템에서는 이 이름이 인터페이스 유형과 선택적으로 순서 번호를 포함하는 문자열(예: “eth0”, “lo” 또는 “pcn0”)입니다. 윈도우에서는 사용자가 변경할 수 없는 내부 ID입니다.

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

이 네트워크 인터페이스 인스턴스를 other 로 교체합니다. 이 작업은 매우 빠르게 수행되며 실패하는 일이 없습니다.

QNetworkInterface::InterfaceType QNetworkInterface::type() const

이 인터페이스의 유형을 확인할 수 있는 경우, 해당 유형을 반환합니다. 유형을 확인할 수 없는 경우, 이 함수는 ` QNetworkInterface::Unknown`를 반환합니다.

hardwareAddress()도 참조하십시오 .

QNetworkInterface &QNetworkInterface::operator=(const QNetworkInterface &other)

other 에 포함된 QNetworkInterface 객체의 내용을 이 객체로 복사합니다.