Qt 5 . 7 文档翻译：QAbstractSocket类,QAbstractSocket Class

QAbstractSocket 类，实现了所有套接字类型对象公用的基础功能。 详细说明……

注意 ： 这个类中的所有函数都是 可重入的 。

详细说明

QAbstractSocket 类，实现了所有套接字类型对象公用的基础功能。

QAbstractSocket 是 QTcpSocket 和 QUdpSocket 的基类，实现 了这两个类共用的基础功能。如果 妳想使用套接字，那么，妳有两种选项：

• •. 实例 化 QTcpSocket 或 QUdpSocket 。

• •. 创建 一个原生的套接字描述符，实例化 QAbstractSocket ，然后调用 setSocketDescriptor ()以便包装这个原生套接字。

传输控制协议（TCP (Transmission Control Protocol)），是可靠的、面向流的、面向连接的传输层协议。用户数据报协议（UDP (User Datagram Protocol)），是不可靠的、面向数据包的、无连接的协议。从实用角度来说，这就意味着，TCP更适合于连续传输数据，而更轻量级的UDP就可用于可靠性不那么重要的场景。

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 还从 QIODevice 继承了 getChar () 、 putChar () 和 ungetChar ()，这些函数对单个字节进行操作。 当有数据被写入到套接字中去时，会发射 bytesWritten ()信号。注意 ， Qt 并不限制写入缓冲区的大小。 妳可通过监听这个信号来监视缓冲区的大小。

每当 有新的数据块到达时，就会发射 readyRead ()信号。然后 ， bytesAvailable () 会返回可供读取的数据的字节数。典型 的用法中，应当将 readyRead ()信号连接 到某个信号槽，并在那个信号槽中读取所有可用的数据。如果 妳没有一次性将所有数据读取的话，那么，剩下的数据仍然可以在日后读取，并且， 新到达的数据都会被追加到 QAbstractSocket 的内部读取缓冲区中。 要想限制读取缓冲区的大小，则调用 setReadBufferSize ()。

要关闭该套接字，则调用 disconnectFromHost ()。 QAbstractSocket 就会进入 QAbstractSocket::ClosingState 状态。 当队列中所有数据都被写入到套接字之后， QAbstractSocket 才真正关闭该套接字，进入QAbstractSocket::ClosedState 状态，并且发射 disconnected ()信号。如果 妳想要抛弃所有尚未写入 的数据，立即断开连接的话，则应当调用 abort ()。如果对端 主机关闭了连接，那么， QAbstractSocket 会发射 error( QAbstractSocket::RemoteHostClosedError )信号 ，在这个过程中套接字的状态仍然是 ConnectedState ，然后，会发射 disconnected ()信号。

可调用 peerPort ()和 peerAddress ()来获取到当前连接的对端节点的端口和地址。 peerName () ，返回对端节点的主机名，也就是之前传递给 connectToHost ()的名字。 localPort () 和 localAddress () ，返回本地套接字的端口和地址。

QAbstractSocket 提供 了一组函数，它们会阻塞当前线程，直到特定的信号被发射为止。 这些函数，可用来实现阻塞式的套接字功能：

• •. waitForConnected () ，阻塞，直到连接建立成功为止。

• •. waitForReadyRead () ，阻塞，直到 有新的数据可供读取为止。

• •. waitForBytesWritten () ，阻塞，直到有数据被写入到套接字为止。

• •. waitForDisconnected () ，阻塞，直到连接关闭为止。

以下是一个示例：

int numRead = 0, numReadTotal = 0;

char buffer[50];

forever {

numRead  = socket.read(buffer, 50);

// 对刚 读入的数组做该做的事

numReadTotal += numRead;

if (numRead == 0 && !socket.waitForReadyRead())

break;

}

如果 waitForReadyRead() 返回 假（false），则表明，连接已经被关闭，或者发生了错误。

针对阻塞 式套接字编程，相比于针对非阻塞式套接字编程，是完全不同的。阻塞 式套接字，不需要有事件循环的存在，因而一般来说可以写出较简单的代码。然而 ，在图形用户界面的应用程序里，只能 在非图形用户界面的线程中使用阻塞式套接字，以避免冻结住用户界面。 参考 fortuneclient 和 blockingfortuneclient 示例，以同时了解两种不同实现方式。

注意 ： 我们反对将阻塞式函数和信号一起使用。应当使用其中一种。

QAbstractSocket 可与 QTextStream 和 QDataStream 的流式操作符(operator<<() and operator>>())配套使用。 不过，有一个问题需要注意： 妳需要先确保有足够多的数据存在，才能使用operator>>()来读取它。

参考 QNetworkAccessManager 和 QTcpServer 。

成员类型文档

enum QAbstractSocket::SocketError

这个枚举说明的是可能出现的套接字错误。

参考 QAbstractSocket::error () 。

enum QAbstractSocket:: SocketState

这个枚举描述的是一个套接字可能存在的不同状态。

参考 QAbstractSocket::state () 。

成员函数文档

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

使用给定的绑定模式（ BindMode ） mode 来绑定到地址 address 的端口 port 。

将这个套接字绑定到地址 address 的端口 port 。

对于UDP 套接字，当绑定后，每当 有 UDP 数据包到达指定的地址和端口时，就会发射 QUdpSocket::readyRead ()信号。所以 ，这个函数可用于编写UDP 服务器。

对于TCP套接字，可使用这个函数来指定要用哪个网卡发起向外的连接，在多网卡的环境下狠有用。

默认情况 下，该套接字会使用 DefaultForPlatform 这个绑定模式（ BindMode ）来绑定。如果 未指定端口号，则会选择一个随机的端口号。

如果绑定成功， 则这个函数会返回真（ true ），并且该套接字会进入 BoundState 状态；否则 将返回假（ false ）。

此函数是从Qt 5.0 开始引入的。

void  QAbstractSocket:: close  ()  [virtual]

覆盖 了 QIODevice::close ()。

关闭为此套接字打开的输入/输出设备，断开此套接字与对方主机的连接，关闭套接字，重置主机名、地址、端口号和底层的套接字描述符。

参考 QIODevice::close ()，以了解当一个输入/输出设备被关闭时会产生什么动作。

参考 abort () 。

void  QAbstractSocket:: hostFound ()

在调用 connectToHost ()之后，当主机名的域名解析成功之后，会发射这个信号。

注意 ： 从Qt 4.6.3开始， QAbstractSocket 可能会在 connectToHost ()被调用时直接发射出hostFound()信号，因为对应的DNS结果可能已经存在于缓存中了。

参考 connected ()。

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

使用平台原生 的套接字描述符 socketDescriptor 来初始化 QAbstractSocket 。 如果 socketDescriptor 被当成一个有效的套接字描述符接受了，则返回真（ true ）；否则返回 假（ false ）。 该套接字会以 openMode 模式打开，并且进入指定的 socketState 状态。读取 和写入缓冲区会被清空，会忽略掉任何队列数据。

注意 ：无法使用同一个原生套接字描述符来初始化两个抽象套接字对象。

参考 socketDescriptor () 。

SocketState  QAbstractSocket:: state  () const

返回此套接字的状态。

参考 error () 。

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

覆盖 QIODevice::waitForReadyRead ()。

这个函数会阻塞，直到发生这个情况：有新的数据到达，并且发射咯 readyRead() 信号。这个函数会在 msecs 毫秒之后超时；默认的超时时间是30000 毫秒。

如果 readyRead ()信号被发射，并且有新的数据可读的话，则此函数会返回真；否则它会返回假（可能是因为出错，也可能是因为此操作超时）。

参考 waitForBytesWritten () 。

http://item.jd.com/10813343.html

Cute Girls

地铁偷摸

未知美人

未知美人