Класс QAbstractSocket

Класс QAbstractSocket предоставляет базовые функции, общие для всех типов сокетов. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются реентерабельными.

Типы публичного доступа

Публичные функции

Реализованные публичные функции

Сигналы

Защищенные функции

Переопределённые защищенные функции

Подробное описание

QAbstractSocket — базовый класс для QTcpSocket и QUdpSocket и содержит всю общую функциональность этих двух классов. Если вам нужен сокет, у вас есть два варианта:

• Создайте экземпляр QTcpSocket или QUdpSocket.
• Создайте дескриптор сокета, создайте экземпляр QAbstractSocket и вызовите setSocketDescriptor() для обертывания сокета.

TCP (Transmission Control Protocol) — надёжный, потоковый, ориентированный на соединение транспортный протокол. UDP (User Datagram Protocol) — ненадежный, ориентированный на датаграммы, бессоединительный протокол. На практике это означает, что TCP лучше подходит для непрерывной передачи данных, а более лёгкий UDP может использоваться, когда надёжность не важна.

API QAbstractSocket объединяет большинство различий между двумя протоколами. Например, хотя UDP бессоединительный, connectToHost() устанавливает виртуальное соединение для UDP-сокетов, позволяя использовать QAbstractSocket более или менее одинаковым образом независимо от базового протокола. Внутренне QAbstractSocket запоминает адрес и порт, переданные в connectToHost(), а функции, такие как read() и write(), используют эти значения.

В любой момент QAbstractSocket имеет состояние (возвращаемое state()). Начальное состояние — UnconnectedState. После вызова connectToHost() сокет сначала переходит в состояние HostLookupState. Если хост найден, QAbstractSocket переходит в состояние ConnectingState и генерирует сигнал hostFound(). Когда соединение установлено, оно переходит в состояние ConnectedState и генерирует сигнал connected(). Если на любом этапе возникает ошибка, генерируется errorOccurred(). Всякий раз, когда состояние меняется, генерируется stateChanged(). Для удобства isValid() возвращает true, если сокет готов для чтения и записи, но обратите внимание, что состояние сокета должно быть ConnectedState перед началом чтения и записи.

Чтение или запись данных осуществляется путём вызова read() или write(), или используйте удобные функции readLine() и readAll(). QAbstractSocket также наследует getChar(), putChar() и ungetChar() от QIODevice, которые работают с отдельными байтами. Сигнал bytesWritten() генерируется при записи данных в сокет. Обратите внимание, что Qt не ограничивает размер буфера записи. Вы можете отслеживать его размер, прослушивая этот сигнал.

Сигнал readyRead() генерируется каждый раз, когда прибывает новый фрагмент данных. количествоДоступныхБайтов() возвращает количество байтов, доступных для чтения. Обычно вы подключаете сигнал readyRead() к слоту и читаете все доступные данные там. Если вы не читаете все данные сразу, оставшиеся данные всё ещё будут доступны позже, а любые новые входящие данные будут добавлены в внутренний буфер чтения QAbstractSocket. Для ограничения размера буфера чтения вызовите setReadBufferSize().

Чтобы закрыть сокет, вызовите disconnectFromHost(). QAbstractSocket переходит в состояние QAbstractSocket::ClosingState. После записи всех ожидающих данных в сокет, QAbstractSocket фактически закрывает сокет, переходит в состояние QAbstractSocket::UnconnectedState и генерирует сигнал disconnected(). Если вы хотите немедленно прервать соединение, удалив все ожидающие данные, вызовите abort() вместо этого. Если удалённый хост закрывает соединение, QAbstractSocket сгенерирует errorOccurred(QAbstractSocket::RemoteHostClosedError), при этом состояние сокета останется ConnectedState, а затем сгенерируется сигнал disconnected().

Порт и адрес подключённого узла получаются путём вызова peerPort() и peerAddress(). peerName() возвращает имя хоста узла, как переданное в connectToHost(). localPort() и localAddress() возвращают порт и адрес локального сокета.

QAbstractSocket предоставляет набор функций, которые приостанавливают вызывающую нить до тех пор, пока не будут сгенерированы определённые сигналы. Эти функции могут быть использованы для реализации блокирующих сокетов:

• подождатьПодключение() блокирует до тех пор, пока соединение не будет установлено.
• подождатьГотовностьКЧтению() блокирует до тех пор, пока доступны новые данные для чтения.
• подождатьЗаписьБайтов() блокирует до тех пор, пока один фрагмент данных не будет записан в сокет.
• подождатьОтключение() блокирует до тех пор, пока соединение не будет закрыто.

Мы покажем пример:

    int numRead = 0, numReadTotal = 0;
    char buffer[50];

    forever {
        numRead  = socket.read(buffer, 50);

        // do whatever with array

        numReadTotal += numRead;
        if (numRead == 0 && !socket.waitForReadyRead())
            break;
    }

Если waitForReadyRead() возвращает false, соединение было закрыто или произошла ошибка.

Программирование с блокирующим сокетом радикально отличается от программирования с неблокирующим сокетом. Блокирующий сокет не требует цикла событий и обычно приводит к более простому коду. Однако в приложении с графическим интерфейсом блокирующие сокеты следует использовать только в потоках, не связанных с графическим интерфейсом, чтобы избежать зависания интерфейса пользователя. См. примеры fortuneclient и blockingfortuneclient для обзора обоих подходов.

QAbstractSocket можно использовать с QTextStream и QDataStream операторами потока (operator<<() и operator>>()). Однако есть одна проблема, о которой следует помнить: необходимо убедиться, что достаточно данных доступно перед попыткой их чтения с помощью operator>>().

См. также QNetworkAccessManager и QTcpServer.

Документация по типам членов

[since 5.0] перечисление QAbstractSocket::BindFlagфлаги QAbstractSocket::BindMode

Это перечисление описывает различные флаги, которые можно передать для изменения поведения QAbstractSocket::bind().

Это перечисление было добавлено или изменено в Qt 5.0.

Тип BindMode является псевдонимом для QFlags<BindFlag>. Он хранит объединение значений BindFlag по оператору ИЛИ.

перечисление QAbstractSocket::NetworkLayerProtocol

Это перечисление описывает значения протокола сетевого уровня, используемые в Qt.

См. также QHostAddress::protocol().

[since 5.0] перечисление QAbstractSocket::PauseModeфлаги QAbstractSocket::PauseModes

Это перечисление описывает поведение, когда сокет должен приостановить передачу данных. В настоящее время поддерживается только уведомление QSslSocket::sslErrors().

Это перечисление было добавлено или изменено в Qt 5.0.

Тип PauseModes является псевдонимом для QFlags<PauseMode>. Он хранит объединение значений PauseMode по оператору ИЛИ.

перечисление QAbstractSocket::SocketError

Это перечисление описывает ошибки сокета, которые могут возникнуть.

См. также QAbstractSocket::error() и QAbstractSocket::errorOccurred().

перечисление QAbstractSocket::SocketOption

Это перечисление представляет параметры, которые могут быть установлены для сокета. При необходимости они могут быть установлены после получения сигнала connected() от сокета или после получения нового сокета от QTcpServer.

Возможные значения для TypeOfServiceOption:

См. также QAbstractSocket::setSocketOption() и QAbstractSocket::socketOption().

перечисление QAbstractSocket::SocketState

Это перечисление описывает различные состояния, в которых может находиться сокет.

См. также QAbstractSocket::state().

enum QAbstractSocket::SocketType

Этот перечисление описывает протокол транспортного уровня.

См. также QAbstractSocket::socketType().

Документация по функциям-членам

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

Создаёт новый абстрактный сокет типа socketType. Аргумент parent передаётся в конструктор QObject.

См. также socketType(), QTcpSocket и QUdpSocket.

[signal] void QAbstractSocket::connected()

Этот сигнал генерируется после вызова connectToHost() и успешного установления соединения.

См. также connectToHost() и disconnected().

[signal] void QAbstractSocket::disconnected()

Этот сигнал генерируется, когда сокет отключён.

См. также connectToHost(), disconnectFromHost() и abort().

[signal, since 5.15] void QAbstractSocket::errorOccurred(QAbstractSocket::SocketError socketError)

Этот сигнал генерируется после возникновения ошибки. Параметр socketError описывает тип возникшей ошибки.

При генерации этого сигнала сокет может быть не готов к попытке повторного подключения. В таком случае попытки повторного подключения следует выполнять из цикла обработки событий. Например, используйте QTimer::singleShot() с 0 в качестве таймаута.

QAbstractSocket::SocketError — не зарегистрированный метатип, поэтому для очереди соединений вам нужно зарегистрировать его с помощью Q_DECLARE_METATYPE() и qRegisterMetaType().

Эта функция была добавлена в Qt 5.15.

См. также error(), errorString() и Создание пользовательских типов Qt.

[signal] void QAbstractSocket::hostFound()

Этот сигнал генерируется после вызова connectToHost() и успешного поиска хоста.

См. также connected().

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

Этот сигнал может быть сгенерирован при использовании proxy, требующей аутентификации. Объект authenticator затем может быть заполнен необходимыми данными для аутентификации и продолжения соединения.

См. также QAuthenticator и QNetworkProxy.

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

Этот сигнал генерируется всякий раз, когда состояние QAbstractSocket изменяется. Параметр socketState — новое состояние.

QAbstractSocket::SocketState — не зарегистрированный метатип, поэтому для очереди соединений вам нужно зарегистрировать его с помощью Q_DECLARE_METATYPE() и qRegisterMetaType().

См. также state() и Создание пользовательских типов Qt.

[virtual] QAbstractSocket::~QAbstractSocket()

Удаляет сокет.

void QAbstractSocket::abort()

Прерывает текущее соединение и сбрасывает сокет. В отличие от disconnectFromHost(), эта функция немедленно закрывает сокет, отбрасывая любые ожидающие данные в буфере записи.

См. также disconnectFromHost() и close().

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

Привязывает сокет к address на порту port, используя режим mode BindMode.

Для UDP-сокетов после привязки сигнал QUdpSocket::readyRead() генерируется всякий раз, когда на указанный адрес и порт приходит UDP-датаграмма. Таким образом, эта функция полезна для написания UDP-серверов.

Для TCP-сокетов эта функция может использоваться для указания интерфейса, который следует использовать для исходящего соединения, что полезно в случае нескольких сетевых интерфейсов.

По умолчанию сокет привязывается с помощью режима BindMode DefaultForPlatform. Если порт не указан, выбирается случайный порт.

При успехе функция возвращает true и сокет переходит в состояние BoundState; в противном случае она возвращает false.

Эта функция была добавлена в Qt 5.0.

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

Это перегруженная функция.

Привязывает сокет к специальному адресу addr на порту port, используя режим BindMode mode.

По умолчанию сокет привязывается с помощью режима BindMode DefaultForPlatform. Если порт не указан, выбирается случайный порт.

Эта функция была добавлена в Qt 6.2.

[since 5.0] bool QAbstractSocket::bind(quint16 port = 0, QAbstractSocket::BindMode mode = DefaultForPlatform)

Это перегруженная функция.

Привязывает сокет к QHostAddress:Any на порту port, используя режим BindMode mode.

По умолчанию сокет привязывается с помощью режима BindMode DefaultForPlatform. Если порт не указан, выбирается случайный порт.

Эта функция была добавлена в Qt 5.0.

[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().

Закрывает устройство ввода-вывода для сокета и вызывает disconnectFromHost() для закрытия соединения сокета.

См. QIODevice::close() для описания действий, которые происходят при закрытии устройства ввода-вывода.

См. также abort().

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

Попытка установить соединение с hostName на заданном port. Параметр 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)

Это перегруженный метод.

Попытка установить соединение с address на порту port.

[virtual] void QAbstractSocket::disconnectFromHost()

Попытка закрыть сокет. Если есть ожидающие записи данные, QAbstractSocket перейдет в состояние ClosingState и подождет, пока все данные не будут записаны. В конечном итоге, он перейдет в состояние UnconnectedState и испустит сигнал disconnected().

См. также connectToHost().

QAbstractSocket::SocketError QAbstractSocket::error() const

Возвращает тип последней произошедшей ошибки.

См. также state() и errorString().

bool QAbstractSocket::flush()

Этот метод записывает как можно больше данных из внутреннего буфера записи в базовый сетевой сокет, не блокируясь. Если какие-либо данные были записаны, этот метод возвращает true; в противном случае возвращается false.

Вызовите этот метод, если вам нужно, чтобы QAbstractSocket начал отправлять буферизованные данные немедленно. Количество успешно записанных байтов зависит от операционной системы. В большинстве случаев вызывать этот метод не нужно, потому что QAbstractSocket начнёт отправлять данные автоматически, когда управление вернется в цикл событий. В отсутствии цикла событий используйте waitForBytesWritten() вместо этого.

См. также write() и waitForBytesWritten().

[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().

[since 5.0] QAbstractSocket::PauseModes QAbstractSocket::pauseMode() const

Возвращает режим паузы этого сокета.

Этот метод был введен в Qt 5.0.

См. также setPauseMode() и resume().

QHostAddress QAbstractSocket::peerAddress() const

Возвращает адрес подключенного узла, если сокет находится в состоянии ConnectedState; в противном случае возвращает QHostAddress::Null.

См. также peerName(), peerPort(), localAddress() и setPeerAddress().

QString QAbstractSocket::peerName() const

Возвращает имя узла, указанное методом connectToHost, или пустую строку, если connectToHost() не был вызван.

См. также peerAddress(), peerPort() и setPeerName().

quint16 QAbstractSocket::peerPort() const

Возвращает порт подключенного узла, если сокет находится в состоянии ConnectedState; в противном случае возвращает 0.

См. также peerAddress(), localPort() и setPeerPort().

[since 5.13] QString QAbstractSocket::protocolTag() const

Возвращает тег протокола для данного сокета. Если тег протокола установлен, он передаётся в QNetworkProxyQuery при его внутреннем создании, чтобы указать используемый тег протокола.

Этот метод был введен в Qt 5.13.

См. также setProtocolTag() и QNetworkProxyQuery.

QNetworkProxy QAbstractSocket::proxy() const

Возвращает сетевой прокси для данного сокета. По умолчанию используется QNetworkProxy::DefaultProxy, что означает, что этот сокет запросит настройки прокси по умолчанию для приложения.

См. также setProxy(), QNetworkProxy и QNetworkProxyFactory.

qint64 QAbstractSocket::readBufferSize() const

Возвращает размер внутреннего буфера чтения. Это ограничивает количество данных, которые клиент может принять, прежде чем вы вызовете read() или readAll().

Размер буфера чтения 0 (по умолчанию) означает, что буфер не имеет ограничений по размеру, гарантируя, что данные не потеряются.

См. также setReadBufferSize() и read().

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

Переопределяет: QIODevice::readData(char *data, qint64 maxSize).

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

Переопределяет: QIODevice::readLineData(char *data, qint64 maxSize).

[virtual, since 5.0] void QAbstractSocket::resume()

Продолжает передачу данных по сокету. Этот метод следует использовать только после того, как сокет был приостановлен по уведомлениям и было получено уведомление. В настоящее время поддерживается только уведомление QSslSocket::sslErrors(). Вызов этого метода, если сокет не приостановлен, приводит к неопределённому поведению.

Эта функция была введена в Qt 5.0.

См. также 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().

[since 5.0] void QAbstractSocket::setPauseMode(QAbstractSocket::PauseModes pauseMode)

Управляет приостановкой при получении уведомления. Параметр pauseMode указывает условия, при которых сокет должен быть приостановлен. В настоящее время поддерживается только уведомление QSslSocket::sslErrors(). Если установлено значение PauseOnSslErrors, передача данных по сокету будет приостановлена и должна быть снова включена явно, вызвав resume(). По умолчанию этот параметр установлен на PauseNever. Этот параметр должен быть установлен до подключения к серверу, в противном случае это приведёт к неопределённому поведению.

Эта функция была введена в Qt 5.0.

См. также 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().

[since 5.13] void QAbstractSocket::setProtocolTag(const QString &tag)

Устанавливает тег протокола для этого сокета на tag.

Эта функция была введена в Qt 5.13.

См. также 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)

Инициализирует QAbstractSocket с дескриптором нативного сокета socketDescriptor. Возвращает true если socketDescriptor принят как действительный дескриптор сокета; в противном случае возвращает 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().

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

Реализует: QIODevice::waitForBytesWritten(int msecs).

Эта функция блокируется, пока не будет записан хотя бы один байт в сокет и не будет выпущен сигнал bytesWritten(). Функция завершится по истечении msecs миллисекунд; значение по умолчанию — 30000 миллисекунд.

Функция возвращает true если сигнал bytesWritten() был выпущен; в противном случае она возвращает false (если произошла ошибка или операция завершилась по таймауту).

См. также waitForReadyRead().

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

Ожидает подключения сокета в течение msecs миллисекунд. Если подключение установлено, эта функция возвращает true; в противном случае — false. В случае возврата false, можно вызвать error() для определения причины ошибки.

В следующем примере ожидается подключение в течение одного секунды:

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() для определения причины ошибки.

В следующем примере ожидается закрытие соединения в течение одной секунды:

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 миллисекунд.

Функция возвращает true если сигнал readyRead() был выпущен и новые данные доступны для чтения; в противном случае она возвращает false (если произошла ошибка или операция завершилась по таймауту).

См. также waitForBytesWritten().

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

Реализует: QIODevice::writeData(const char *data, qint64 maxSize).