Класс 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(). Если на каком-либо этапе произойдёт ошибка, излучается error(). Всякий раз, когда состояние изменяется, излучается stateChanged(). Для удобства isValid() возвращает true, если сокет готов для чтения и записи, но обратите внимание, что состояние сокета должно быть ConnectedState перед тем, как можно будет читать и писать.

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

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

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

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

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

• waitForConnected() блокируется до тех пор, пока соединение не будет установлено.
• waitForReadyRead() блокируется до тех пор, пока новые данные не станут доступными для чтения.
• waitForBytesWritten() блокируется до тех пор, пока один пакет данных не будет записан в сокет.
• waitForDisconnected() блокируется до тех пор, пока соединение не закроется.

Мы показываем пример:

    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, соединение было закрыто или произошла ошибка.

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

Примечание: Мы не рекомендуем использовать блокирующие функции вместе с сигналами. Следует использовать один из двух вариантов.

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

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

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

enum QAbstractSocket::BindFlagflags QAbstractSocket::BindMode

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

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

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

enum QAbstractSocket::NetworkLayerProtocol

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

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

enum QAbstractSocket::PauseModeflags QAbstractSocket::PauseModes

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

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

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

enum QAbstractSocket::SocketError

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

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

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

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

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

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

См. также 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() и успешного установления соединения.

Примечание: В некоторых операционных системах сигнал connected() может быть непосредственно излучен из вызова connectToHost() для подключений к хосту localhost.

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

[signal] void QAbstractSocket::disconnected()

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

Предупреждение: Если вам нужно удалить отправителя этого сигнала в слоте, подключённом к нему, используйте функцию deleteLater().

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

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

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

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

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

Примечание: Сигнал error перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:

connect(abstractSocket, QOverload<QAbstractSocket::SocketError>::of(&QAbstractSocket::error),
    [=](QAbstractSocket::SocketError socketError){ /* ... */ });

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

[signal] void QAbstractSocket::hostFound()

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

Примечание: Начиная с Qt 4.6.3, QAbstractSocket может излучать hostFound() непосредственно из вызова connectToHost(), так как результат DNS может быть кэширован.

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

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

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

Примечание: Невозможно использовать QueuedConnection для подключения к этому сигналу, так как подключение потерпит неудачу, если authenticator не был заполнен новой информацией, когда сигнал возвращается.

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

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

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

Переопределяет: QIODevice::atEnd() const.

Возвращает true если больше нет доступных данных для чтения; в противном случае возвращает false.

Эта функция чаще всего используется при чтении данных из сокета в цикле. Например:

 // This slot is connected to QAbstractSocket::readyRead()
 void SocketClass::readyReadSlot()
 {
     while (!socket.atEnd()) {
         QByteArray data = socket.read(100);
         ....
     }
 }

См. также bytesAvailable() и readyRead().

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

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

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

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

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

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

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

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

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

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

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

Эта функция была добавлена в 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] bool QAbstractSocket::canReadLine() const

Переопределяет: QIODevice::canReadLine() const.

Возвращает true если строка данных может быть прочитана из сокета; в противном случае возвращает false.

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

[override virtual] void QAbstractSocket::close()

Переопределяет: QIODevice::close().

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

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

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

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

Попытка установить соединение с hostName по указанному port. Параметр protocol позволяет указать используемый сетевой протокол (например, IPv4 или IPv6).

Сокет открывается с заданным openMode и сначала переходит в состояние HostLookupState, затем выполняет поиск имени хоста hostName. Если поиск успешен, испускается сигнал hostFound(), и QAbstractSocket переходит в состояние ConnectingState. Затем он пытается подключиться к адресу или адресам, возвращенным результатом поиска. Наконец, если соединение установлено, QAbstractSocket переходит в состояние ConnectedState и испускает сигнал connected().

В любой момент сокет может испустить сигнал error(), чтобы указать, что произошла ошибка.

hostName может быть IP-адресом в строковом формате (например, "43.195.83.32") или именем хоста (например, "example.com"). QAbstractSocket выполнит поиск только при необходимости. port задается в родном порядке байтов.

См. также state(), peerName(), peerAddress(), peerPort() и waitForConnected().

[virtual] void QAbstractSocket::connectToHost(const QHostAddress &address, quint16 port, QIODevice::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.

Примечание: состояние сокета должно быть ConnectedState перед чтением и записью.

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

Возвращает режим приостановки для данного сокета.

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

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

QHostAddress QAbstractSocket::peerAddress() const

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

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

QString QAbstractSocket::peerName() const

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

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

quint16 QAbstractSocket::peerPort() const

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

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

QString QAbstractSocket::protocolTag() const

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

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

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

QNetworkProxy QAbstractSocket::proxy() const

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

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

См. также 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] void QAbstractSocket::resume()

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

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

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

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

Устанавливает адрес на локальной стороне соединения в address.

Вы можете вызвать эту функцию в подклассе QAbstractSocket для изменения возвращаемого значения функции localAddress() после установления соединения. Эта функция обычно используется при прокси-соединениях для виртуальных настроек соединения.

Обратите внимание, что эта функция не привязывает локальный адрес сокета до подключения (например, QAbstractSocket::bind()).

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

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

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

Устанавливает порт на локальной стороне соединения в port.

Вы можете вызвать эту функцию в подклассе QAbstractSocket для изменения возвращаемого значения функции localPort() после установления соединения. Эта функция обычно используется при прокси-соединениях для виртуальных настроек соединения.

Обратите внимание, что эта функция не привязывает локальный порт сокета до подключения (например, QAbstractSocket::bind()).

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

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

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() после установления соединения. Эта функция обычно используется при прокси-соединениях для виртуальных настроек соединения.

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

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

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

Устанавливает имя хоста удалённого узла в name.

Вы можете вызвать эту функцию в подклассе QAbstractSocket для изменения возвращаемого значения функции peerName() после установления соединения. Эта функция обычно используется при прокси-соединениях для виртуальных настроек соединения.

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

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

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

Устанавливает порт удалённой стороны соединения в port.

Вы можете вызвать эту функцию в подклассе QAbstractSocket для изменения возвращаемого значения функции peerPort() после установления соединения. Эта функция обычно используется при прокси-соединениях для виртуальных настроек соединения.

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

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

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.

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

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

Примечание: В Windows Runtime QAbstractSocket::KeepAliveOption должен быть установлен до подключения сокета.

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

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

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

Устанавливает состояние сокета в state.

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

[virtual] qintptr QAbstractSocket::socketDescriptor() const

Возвращает дескриптор сокета в системе (native socket descriptor) объекта QAbstractSocket, если он доступен; иначе возвращает -1.

Если сокет использует QNetworkProxy, возвращённый дескриптор может быть не пригодным для использования с функциями native socket.

Дескриптор сокета недоступен, когда QAbstractSocket находится в состоянии UnconnectedState.

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

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

Возвращает значение опции option.

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

См. также 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, (если произошла ошибка или операция истекла).

Примечание: Эта функция может случайным образом завершиться неудачей в Windows. Вместо неё используйте цикл событий и сигнал bytesWritten() при работе с программным обеспечением на Windows.

См. также 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, функция не будет ожидать.

Примечание: Функция может ожидать немного дольше, чем msecs, в зависимости от времени, необходимого для завершения поиска хоста.

Примечание: Несколько вызовов этой функции не суммируют время. Если функция истечёт, процесс подключения будет прерван.

Примечание: Эта функция может случайным образом завершиться неудачей в Windows. Вместо неё используйте цикл событий и сигнал connected() при работе с программным обеспечением на Windows.

См. также 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, функция не будет ожидать.

Примечание: Эта функция может случайным образом завершиться неудачей в Windows. Вместо неё используйте цикл событий и сигнал disconnected() при работе с программным обеспечением на Windows.

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

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

Переопределяет: QIODevice::waitForReadyRead(int msecs).

Эта функция блокируется, пока доступны новые данные для чтения и не будет выпущен сигнал readyRead(). Функция будет ожидать msecs миллисекунд; по умолчанию ожидание составляет 30000 миллисекунд.

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

Примечание: Эта функция может случайным образом завершиться неудачей в Windows. Вместо неё используйте цикл событий и сигнал readyRead() при работе с программным обеспечением на Windows.

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

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

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