QAbstractSocket Class

멤버 함수 문서

QAbstractSocket::QAbstractSocket(QAbstractSocket::SocketType socketType, QObject *parent)

socketType 유형의 새 추상 소켓을 생성합니다. parent 인자는 QObject 의 생성자에게 전달됩니다.

socketType(), QTcpSocket, QUdpSocket도 참조하세요 .

[virtual noexcept] QAbstractSocket::~QAbstractSocket()

소켓을 파괴합니다.

void QAbstractSocket::abort()

현재 연결을 중단하고 소켓을 재설정합니다. disconnectFromHost ()와 달리 이 함수는 즉시 소켓을 닫고 쓰기 버퍼의 보류 중인 데이터를 모두 삭제합니다.

disconnectFromHost() 및 close()도 참조하세요 .

[virtual] bool QAbstractSocket::bind(const QHostAddress &address, quint16 port = 0, QAbstractSocket::BindMode mode = DefaultForPlatform)

BindMode mode 을 사용하여 포트 port 의 address 에 바인딩합니다.

UDP 소켓의 경우, 바인딩 후 지정된 주소와 포트에 UDP 데이터그램이 도착할 때마다 QUdpSocket::readyRead() 신호가 전송됩니다. 따라서 이 함수는 UDP 서버를 작성하는 데 유용합니다.

TCP 소켓의 경우 이 함수는 나가는 연결에 사용할 인터페이스를 지정하는 데 사용할 수 있으며, 네트워크 인터페이스가 여러 개인 경우에 유용합니다.

기본적으로 소켓은 DefaultForPlatform BindMode 을 사용하여 바인딩됩니다. 포트를 지정하지 않으면 임의의 포트가 선택됩니다.

성공하면 함수는 true 을 반환하고 소켓은 BoundState 으로 들어가고, 그렇지 않으면 false 을 반환합니다.

bool QAbstractSocket::bind(quint16 port = 0, QAbstractSocket::BindMode mode = DefaultForPlatform)

이것은 과부하된 함수입니다.

port 포트에 BindMode mode 을 사용하여 QHostAddress:아무것이나 바인딩합니다.

기본적으로 소켓은 DefaultForPlatform BindMode 을 사용하여 바인딩됩니다. 포트를 지정하지 않으면 임의의 포트가 선택됩니다.

[since 6.2] bool QAbstractSocket::bind(QHostAddress::SpecialAddress addr, quint16 port = 0, QAbstractSocket::BindMode mode = DefaultForPlatform)

이것은 과부하된 함수입니다.

BindMode mode 을 사용하여 포트 port 의 특수 주소 addr 에 바인딩합니다.

기본적으로 소켓은 DefaultForPlatform BindMode 을 사용하여 바인딩됩니다. 포트를 지정하지 않으면 임의의 포트가 선택됩니다.

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

[override virtual] qint64 QAbstractSocket::bytesAvailable() const

재구현합니다: QIODevice::bytesAvailable() const.

읽기를 기다리는 수신 바이트 수를 반환합니다.

bytesToWrite() 및 read()도 참조하세요 .

[override virtual] qint64 QAbstractSocket::bytesToWrite() const

재구현합니다: QIODevice::bytesToWrite() const.

쓰기를 기다리는 바이트 수를 반환합니다. 바이트는 제어가 이벤트 루프로 돌아가거나 flush()가 호출될 때 기록됩니다.

bytesAvailable() 및 flush()도 참조하세요 .

[override virtual] void QAbstractSocket::close()

다시 구현합니다: QIODevice::close().

소켓에 대한 I/O 장치를 닫고 disconnectFromHost()를 호출하여 소켓의 연결을 닫습니다.

I/O 장치가 닫힐 때 발생하는 동작에 대한 설명은 QIODevice::close()를 참조하세요.

abort()도 참조하세요 .

[virtual] void QAbstractSocket::connectToHost(const QString &hostName, quint16 port, QIODeviceBase::OpenMode openMode = ReadWrite, QAbstractSocket::NetworkLayerProtocol protocol = AnyIPProtocol)

주어진 port 에서 hostName 로 연결을 시도합니다. protocol 매개변수는 사용할 네트워크 프로토콜(예: IPv4 또는 IPv6)을 지정하는 데 사용할 수 있습니다.

소켓은 지정된 openMode 에서 열리고 먼저 HostLookupState 으로 들어간 다음 hostName 의 호스트 이름 조회를 수행합니다. 조회가 성공하면 hostFound()가 출력되고 QAbstractSocket 는 ConnectingState 로 들어갑니다. 그런 다음 조회에서 반환된 주소에 연결을 시도합니다. 마지막으로 연결이 설정되면 QAbstractSocket 은 ConnectedState 을 입력하고 connected()을 내보냅니다.

언제든지 소켓은 errorOccurred()를 전송하여 오류가 발생했음을 알릴 수 있습니다.

hostName 는 문자열 형식의 IP 주소(예: "43.195.83.32")이거나 호스트 이름(예: "example.com")일 수 있습니다. QAbstractSocket 은 필요한 경우에만 조회를 수행합니다. port 은 기본 바이트 순서입니다.

state(), peerName(), peerAddress(), peerPort() 및 waitForConnected()도 참조하세요 .

void QAbstractSocket::connectToHost(const QHostAddress &address, quint16 port, QIODeviceBase::OpenMode openMode = ReadWrite)

과부하가 걸린 함수입니다.

포트 port 에서 address 에 연결을 시도합니다.

[signal] void QAbstractSocket::connected()

이 신호는 connectToHost()가 호출되고 연결이 성공적으로 설정된 후에 전송됩니다.

connectToHost() 및 disconnected()도 참조하세요 .

[virtual] void QAbstractSocket::disconnectFromHost()

소켓을 닫으려고 시도합니다. 쓰기를 기다리는 대기 중인 데이터가 있는 경우 QAbstractSocket 은 ClosingState 으로 들어가 모든 데이터가 쓰여질 때까지 기다립니다. 결국 UnconnectedState 으로 들어가 disconnected() 신호를 내보냅니다.

connectToHost()도 참조하세요 .

[signal] void QAbstractSocket::disconnected()

이 신호는 소켓 연결이 끊어졌을 때 방출됩니다.

connectToHost(), disconnectFromHost() 및 abort()도 참조하세요 .

QAbstractSocket::SocketError QAbstractSocket::error() const

마지막으로 발생한 오류 유형을 반환합니다.

state() 및 errorString()도 참조하세요 .

[signal] void QAbstractSocket::errorOccurred(QAbstractSocket::SocketError socketError)

이 신호는 오류가 발생한 후에 전송됩니다. socketError 매개변수는 발생한 오류의 유형을 설명합니다.

이 신호가 발생하면 소켓이 재연결을 시도할 준비가 되지 않은 것일 수 있습니다. 이 경우 이벤트 루프에서 재연결을 시도해야 합니다. 예를 들어, 타임아웃을 0ns로 설정하고 QChronoTimer::singleShot()을 사용합니다.

QAbstractSocket::SocketError 는 등록된 메타타입이 아니므로 대기 중인 연결의 경우 Q_DECLARE_METATYPE() 및 qRegisterMetaType()로 등록해야 합니다.

error(), errorString() 및 사용자 정의 Qt 유형 만들기를참조하십시오 .

bool QAbstractSocket::flush()

이 함수는 내부 쓰기 버퍼에서 기본 네트워크 소켓으로 차단 없이 가능한 한 많이 씁니다. 데이터가 쓰여진 경우 이 함수는 true 을 반환하고, 그렇지 않으면 false를 반환합니다.

버퍼링된 데이터를 즉시 전송하기 위해 QAbstractSocket 이 필요한 경우 이 함수를 호출하세요. 성공적으로 기록되는 바이트 수는 운영 체제에 따라 다릅니다. 대부분의 경우 제어가 이벤트 루프로 돌아가면 QAbstractSocket 이 자동으로 데이터 전송을 시작하므로 이 함수를 호출할 필요가 없습니다. 이벤트 루프가 없는 경우에는 waitForBytesWritten()를 대신 호출하세요.

write() 및 waitForBytesWritten()도 참조하세요 .

[signal] void QAbstractSocket::hostFound()

이 신호는 connectToHost()가 호출되고 호스트 조회가 성공한 후에 발생합니다.

connected()도 참조하세요 .

[override virtual] bool QAbstractSocket::isSequential() const

재구현합니다: QIODevice::isSequential() const.

bool QAbstractSocket::isValid() const

소켓이 유효하고 사용할 준비가 되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

state()도 참조하세요 .

QHostAddress QAbstractSocket::localAddress() const

사용 가능한 경우 로컬 소켓의 호스트 주소를 반환하고, 그렇지 않으면 QHostAddress::Null 을 반환합니다.

일반적으로 호스트의 기본 IP 주소이지만 로컬 호스트에 연결할 경우 QHostAddress::LocalHost (127.0.0.1)일 수 있습니다.

localPort(), peerAddress() 및 setLocalAddress()도 참조하세요 .

quint16 QAbstractSocket::localPort() const

사용 가능한 경우 로컬 소켓의 호스트 포트 번호(기본 바이트 순서)를 반환하고, 그렇지 않으면 0을 반환합니다.

localAddress(), peerPort() 및 setLocalPort()도 참조하세요 .

QAbstractSocket::PauseModes QAbstractSocket::pauseMode() const

이 소켓의 일시 중지 모드를 반환합니다.

setPauseMode() 및 resume()도 참조하세요 .

QHostAddress QAbstractSocket::peerAddress() const

소켓이 ConnectedState 에 있으면 연결된 피어의 주소를 반환하고, 그렇지 않으면 QHostAddress::Null 을 반환합니다.

peerName(), peerPort(), localAddress(), setPeerAddress()도 참조하세요 .

QString QAbstractSocket::peerName() const

connectToHost()에 지정된 대로 피어 이름을 반환하거나 connectToHost()가 호출되지 않은 경우 빈 QString 을 반환합니다.

peerAddress(), peerPort() 및 setPeerName()도 참조하세요 .

quint16 QAbstractSocket::peerPort() const

소켓이 ConnectedState 에 있으면 연결된 피어의 포트를 반환하고, 그렇지 않으면 0을 반환합니다.

peerAddress(), localPort(), setPeerPort()도 참조하세요 .

QString QAbstractSocket::protocolTag() const

이 소켓의 프로토콜 태그를 반환합니다. 프로토콜 태그가 설정되어 있으면 내부적으로 생성될 때 QNetworkProxyQuery 에 전달되어 사용할 프로토콜 태그를 나타냅니다.

setProtocolTag() 및 QNetworkProxyQuery 을참조하세요 .

QNetworkProxy QAbstractSocket::proxy() const

이 소켓의 네트워크 프록시를 반환합니다. 기본적으로 QNetworkProxy::DefaultProxy 이 사용되며, 이는 이 소켓이 애플리케이션의 기본 프록시 설정을 쿼리한다는 의미입니다.

setProxy(), QNetworkProxy, QNetworkProxyFactory도 참조하세요 .

[signal] void QAbstractSocket::proxyAuthenticationRequired(const QNetworkProxy &proxy, QAuthenticator *authenticator)

이 신호는 인증이 필요한 proxy 을 사용할 때 전송될 수 있습니다. 그러면 authenticator 객체에 인증을 허용하고 연결을 계속하는 데 필요한 세부 정보를 채울 수 있습니다.

QAuthenticator 및 QNetworkProxy 을참조하세요 .

qint64 QAbstractSocket::readBufferSize() const

내부 읽기 버퍼의 크기를 반환합니다. 이는 read() 또는 readAll()을 호출하기 전에 클라이언트가 수신할 수 있는 데이터의 양을 제한합니다.

읽기 버퍼 크기가 0(기본값)이면 버퍼에 크기 제한이 없으므로 데이터가 손실되지 않습니다.

setReadBufferSize() 및 read()도 참조하세요 .

[override virtual protected] qint64 QAbstractSocket::readData(char *data, qint64 maxSize)

다시 구현합니다: QIODevice::readData(문자 *데이터, qint64 maxSize).

[override virtual protected] qint64 QAbstractSocket::readLineData(char *data, qint64 maxlen)

다시 구현합니다: QIODevice::readLineData(문자 *데이터, qint64 maxSize).

[virtual] void QAbstractSocket::resume()

소켓에서 데이터 전송을 계속합니다. 이 방법은 알림 시 일시 중지하도록 소켓을 설정하고 알림을 수신한 후에만 사용해야 합니다. 현재 지원되는 유일한 알림은 QSslSocket::sslErrors()입니다. 소켓이 일시 중지되지 않은 상태에서 이 메서드를 호출하면 정의되지 않은 동작이 발생합니다.

pauseMode() 및 setPauseMode()도 참조하세요 .

[protected] void QAbstractSocket::setLocalAddress(const QHostAddress &address)

연결의 로컬 측 주소를 address 로 설정합니다.

QAbstractSocket 의 서브클래스에서 이 함수를 호출하여 연결이 설정된 후 localAddress() 함수의 반환값을 변경할 수 있습니다. 이 기능은 일반적으로 가상 연결 설정을 위한 프록시 연결에서 사용됩니다.

이 함수는 연결 전 소켓의 로컬 주소(예: QAbstractSocket::bind())를 바인딩하지 않는다는 점에 유의하세요.

localAddress(), setLocalPort() 및 setPeerAddress()도 참조하세요 .

[protected] void QAbstractSocket::setLocalPort(quint16 port)

연결의 로컬 측 포트를 port 로 설정합니다.

QAbstractSocket 의 서브클래스에서 이 함수를 호출하여 연결이 설정된 후 localPort() 함수의 반환값을 변경할 수 있습니다. 이 기능은 일반적으로 가상 연결 설정을 위한 프록시 연결에서 사용됩니다.

이 함수는 연결 전에는 소켓의 로컬 포트를 바인딩하지 않습니다(예: QAbstractSocket::bind()).

localPort(), localAddress(), setLocalAddress() 및 setPeerPort()도 참조하세요 .

void QAbstractSocket::setPauseMode(QAbstractSocket::PauseModes pauseMode)

알림 수신 시 일시 중지할지 여부를 제어합니다. pauseMode 매개 변수는 소켓을 일시 중지해야 하는 조건을 지정합니다. 현재 지원되는 유일한 알림은 QSslSocket::sslErrors()입니다. PauseOnSslErrors 로 설정하면 소켓의 데이터 전송이 일시 중지되며 resume()를 호출하여 명시적으로 다시 사용하도록 설정해야 합니다. 기본적으로 이 옵션은 PauseNever 으로 설정되어 있습니다. 이 옵션은 서버에 연결하기 전에 호출해야 하며, 그렇지 않으면 정의되지 않은 동작이 발생합니다.

pauseMode() 및 resume()도 참조하세요 .

[protected] void QAbstractSocket::setPeerAddress(const QHostAddress &address)

연결의 원격 측 주소를 address 로 설정합니다.

QAbstractSocket 의 서브클래스에서 이 함수를 호출하여 연결이 설정된 후 peerAddress() 함수의 반환값을 변경할 수 있습니다. 이 기능은 일반적으로 가상 연결 설정을 위한 프록시 연결에서 사용됩니다.

peerAddress(), setPeerPort() 및 setLocalAddress()도 참조하세요 .

[protected] void QAbstractSocket::setPeerName(const QString &name)

원격 피어의 호스트 이름을 name 로 설정합니다.

QAbstractSocket 의 서브클래스에서 이 함수를 호출하여 연결이 설정된 후 peerName() 함수의 반환값을 변경할 수 있습니다. 이 기능은 일반적으로 가상 연결 설정을 위한 프록시 연결에서 사용됩니다.

peerName()도 참조하세요 .

[protected] void QAbstractSocket::setPeerPort(quint16 port)

연결의 원격 측 포트를 port 로 설정합니다.

QAbstractSocket 의 서브클래스에서 이 함수를 호출하여 연결이 설정된 후 peerPort() 함수의 반환값을 변경할 수 있습니다. 이 기능은 일반적으로 가상 연결 설정을 위한 프록시 연결에서 사용됩니다.

peerPort(), setPeerAddress() 및 setLocalPort()도 참조하세요 .

void QAbstractSocket::setProtocolTag(const QString &tag)

이 소켓의 프로토콜 태그를 tag 로 설정합니다.

protocolTag()도 참조하세요 .

void QAbstractSocket::setProxy(const QNetworkProxy &networkProxy)

이 소켓에 대한 명시적 네트워크 프록시를 networkProxy 로 설정합니다.

이 소켓에 대한 프록시 사용을 사용하지 않으려면 QNetworkProxy::NoProxy 프록시 유형을 사용합니다:

socket->setProxy(QNetworkProxy::NoProxy);

프록시의 기본값은 QNetworkProxy::DefaultProxy 이며, 이는 소켓이 애플리케이션 설정을 사용한다는 의미입니다: 프록시가 QNetworkProxy::setApplicationProxy 으로 설정된 경우 이를 사용하고, 그렇지 않은 경우 QNetworkProxyFactory::setApplicationProxyFactory 로 설정된 경우 해당 팩토리를 QNetworkProxyQuery::TcpSocket 유형으로 쿼리합니다.

proxy(), QNetworkProxy, QNetworkProxyFactory::queryProxy()도 참조하세요 .

[virtual] void QAbstractSocket::setReadBufferSize(qint64 size)

QAbstractSocket 의 내부 읽기 버퍼 크기를 size 바이트로 설정합니다.

버퍼 크기가 특정 크기로 제한되어 있는 경우 QAbstractSocket 은 이 크기 이상의 데이터를 버퍼링하지 않습니다. 예외적으로 버퍼 크기가 0이면 읽기 버퍼가 무제한이며 들어오는 모든 데이터가 버퍼링됩니다. 이것이 기본값입니다.

이 옵션은 특정 시점(예: 실시간 스트리밍 애플리케이션)에만 데이터를 읽거나 소켓에 너무 많은 데이터가 수신되어 애플리케이션의 메모리가 부족해지는 것을 방지하려는 경우에 유용합니다.

QTcpSocket 만 QAbstractSocket 의 내부 버퍼를 사용하고 QUdpSocket 는 버퍼링을 전혀 사용하지 않고 운영 체제에서 제공하는 암시적 버퍼링에 의존합니다. 따라서 QUdpSocket 에서 이 함수를 호출해도 아무런 효과가 없습니다.

readBufferSize() 및 read()도 참조하세요 .

[virtual] bool QAbstractSocket::setSocketDescriptor(qintptr socketDescriptor, QAbstractSocket::SocketState socketState = ConnectedState, QIODeviceBase::OpenMode openMode = ReadWrite)

네이티브 소켓 기술자 socketDescriptor 를 사용하여 QAbstractSocket 를 초기화합니다. socketDescriptor 이 유효한 소켓 기술자로 받아들여지면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 소켓은 openMode 에 지정된 모드로 열리고 socketState 에 지정된 소켓 상태로 들어갑니다. 읽기 및 쓰기 버퍼가 지워지고 보류 중인 데이터가 모두 삭제됩니다.

참고: 동일한 네이티브 소켓 설명자로 두 개의 추상 소켓을 초기화할 수 없습니다.

socketDescriptor()도 참조하세요 .

[protected] void QAbstractSocket::setSocketError(QAbstractSocket::SocketError socketError)

마지막으로 발생한 오류 유형을 socketError 로 설정합니다.

setSocketState() 및 setErrorString()도 참조하세요 .

[virtual] void QAbstractSocket::setSocketOption(QAbstractSocket::SocketOption option, const QVariant &value)

주어진 option 을 value 에 설명된 값으로 설정합니다.

socketOption()도 참조하세요 .

[protected] void QAbstractSocket::setSocketState(QAbstractSocket::SocketState state)

소켓의 상태를 state 로 설정합니다.

state()도 참조하세요 .

[override virtual protected] qint64 QAbstractSocket::skipData(qint64 maxSize)

다시 구현합니다: QIODevice::skipData(qint64 maxSize).

[virtual] qintptr QAbstractSocket::socketDescriptor() const

사용 가능한 경우 QAbstractSocket 객체의 네이티브 소켓 기술자를 반환하고, 그렇지 않으면 -1을 반환합니다.

소켓이 QNetworkProxy 을 사용하는 경우 반환된 기술자는 네이티브 소켓 함수에서 사용할 수 없을 수 있습니다.

QAbstractSocket 이 UnconnectedState 에 있는 경우 소켓 기술자를 사용할 수 없습니다.

setSocketDescriptor()도 참조하세요 .

[virtual] QVariant QAbstractSocket::socketOption(QAbstractSocket::SocketOption option)

option 옵션의 값을 반환합니다.

setSocketOption()도 참조하세요 .

QAbstractSocket::SocketType QAbstractSocket::socketType() const

소켓 유형(TCP, UDP 또는 기타)을 반환합니다.

QTcpSocket 및 QUdpSocket 을참조하세요 .

QAbstractSocket::SocketState QAbstractSocket::state() const

소켓의 상태를 반환합니다.

error()도 참조하세요 .

[signal] void QAbstractSocket::stateChanged(QAbstractSocket::SocketState socketState)

이 신호는 QAbstractSocket 의 상태가 변경될 때마다 전송됩니다. socketState 매개변수는 새 상태입니다.

QAbstractSocket::SocketState 는 등록된 메타타입이 아니므로 대기 중인 연결의 경우 Q_DECLARE_METATYPE() 및 qRegisterMetaType()로 등록해야 합니다.

state() 및 사용자 정의 Qt 유형 만들기를참조하십시오 .

[override virtual] bool QAbstractSocket::waitForBytesWritten(int msecs = 30000)

다시 구현합니다: QIODevice::waitForBytesWritten(int msecs).

이 함수는 소켓에 최소 1바이트가 쓰여지고 bytesWritten() 신호가 전송될 때까지 차단합니다. 이 함수는 msecs 밀리초 후에 시간 초과되며, 기본 시간 초과 시간은 30000밀리초입니다.

bytesWritten() 신호가 전송되면 true 을 반환하고, 그렇지 않으면 false (오류가 발생했거나 작업이 시간 초과된 경우)을 반환합니다.

waitForReadyRead()도 참조하세요 .

[virtual] bool QAbstractSocket::waitForConnected(int msecs = 30000)

소켓이 연결될 때까지 최대 msecs 밀리초까지 기다립니다. 연결이 설정되면 이 함수는 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. false 을 반환하는 경우 error()을 호출하여 오류의 원인을 확인할 수 있습니다.

다음 예제는 연결이 설정될 때까지 최대 1초 동안 기다립니다:

socket->connectToHost("imap", 143);if (socket->waitForConnected(1000))    qDebug("Connected!");

msecs가 -1이면 이 함수는 시간 초과되지 않습니다.

connectToHost() 및 connected()도 참조하세요 .

[virtual] bool QAbstractSocket::waitForDisconnected(int msecs = 30000)

소켓 연결이 끊어질 때까지 최대 msecs 밀리초까지 기다립니다. 연결이 성공적으로 끊어지면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다(작업 시간이 초과되었거나 오류가 발생했거나 QAbstractSocket 이미 연결이 끊어진 경우). false 을 반환하는 경우 error()을 호출하여 오류의 원인을 확인할 수 있습니다.

다음 예는 연결이 종료될 때까지 최대 1초 동안 기다립니다:

socket->disconnectFromHost();if (socket->state()==. QAbstractSocket::UnconnectedState ||  socket->waitForDisconnected(1000)) {        qDebug("Disconnected!");

msecs가 -1이면 이 함수는 시간 초과되지 않습니다.

disconnectFromHost() 및 close()도 참조하세요 .

[override virtual] bool QAbstractSocket::waitForReadyRead(int msecs = 30000)

다시 구현합니다: QIODevice::waitForReadyRead(int msecs).

이 함수는 새 데이터를 읽을 수 있고 readyRead() 신호가 전송될 때까지 차단합니다. 이 함수는 msecs 밀리초 후에 시간 초과되며, 기본 시간 초과 시간은 30000밀리초입니다.

readyRead() 신호가 전송되고 읽을 수 있는 새 데이터가 있는 경우 true 을 반환하고, 그렇지 않으면 false (오류가 발생했거나 작업 시간이 초과된 경우)을 반환합니다.

waitForBytesWritten()도 참조하세요 .

[override virtual protected] qint64 QAbstractSocket::writeData(const char *data, qint64 size)

재구현합니다: QIODevice::writeData(const char *data, qint64 maxSize).