tcp协议的套接字操作类更多...

#include <sttnet.h>

类 stt::network::TcpFDHandler 继承关系图:

Public 成员函数
void	setFD (const int &fd, SSL *ssl, const bool &flag1=false, const bool &flag2=false, const int &sec=-1)
	传入套接字初始化对象更多...

int	getFD ()
	获取该对象的套接字更多...

SSL *	getSSL ()
	获取该对象的加密SSL句柄更多...

void	close (const bool &cle=true)
	关闭对象更多...

void	blockSet (const int &sec=-1)
	设置对象中的套接字为阻塞模式更多...

void	unblockSet ()
	设置对象中的套接字为非阻塞模式更多...

bool	multiUseSet ()
	设置对象中的套接字为SO_REUSEADDR模式更多...

bool	isConnect ()
	判断对象是否有套接字绑定更多...

int	sendData (const std::string &data, const bool &block=true)
	向已连接的套接字发送字符串数据。更多...

int	sendData (const char *data, const uint64_t &length, const bool &block=true)
	向已连接的套接字发送指定长度的二进制数据。更多...

int	recvDataByLength (std::string &data, const uint64_t &length, const int &sec=2)
	从已连接的套接字中阻塞接收指定长度的数据到字符串更多...

int	recvDataByLength (char *data, const uint64_t &length, const int &sec=2)
	从已连接的套接字中阻塞接收指定长度的数据到char*容器更多...

int	recvData (std::string &data, const uint64_t &length)
	从已连接的套接字中接收一次数据到string字符串容器更多...

int	recvData (char *data, const uint64_t &length)
	从已连接的套接字中接收一次数据到char*容器更多...

Public 属性
bool	flag3 =false
	如果sendData的block=true，如果发送过程中连接断开，这个标志位会置为true 更多...

Protected 属性
int	fd =-1

bool	flag1 =false

bool	flag2 =false

SSL *	ssl =nullptr

int	sec =-1

详细描述

tcp协议的套接字操作类

成员函数说明

void stt::network::TcpFDHandler::blockSet ( const int & sec = -1 )

设置对象中的套接字为阻塞模式

参数

sec	阻塞超时时间阻塞超过这个时间就不会再阻塞了默认为-1 即无限等待

void stt::network::TcpFDHandler::close ( const bool & cle = true )

关闭对象

参数

cle	true：关闭对象并且关闭原对象句柄的套接字的链接 false：仅关闭对象（默认为ture，关闭对象也关闭连接）

int stt::network::TcpFDHandler::getFD ( )

inline

获取该对象的套接字

返回: 返回该对象的套接字

SSL* stt::network::TcpFDHandler::getSSL ( )

inline

获取该对象的加密SSL句柄

返回: 返回加密SSL句柄。如果没有加密SSL句柄，返回nullptr。

bool stt::network::TcpFDHandler::isConnect ( )

inline

判断对象是否有套接字绑定

返回: true：对象绑定了套接字 false：对象没有绑定套接字

bool stt::network::TcpFDHandler::multiUseSet ( )

设置对象中的套接字为SO_REUSEADDR模式

int stt::network::TcpFDHandler::recvData	(	std::string &	data,
		const uint64_t &	length
	)

从已连接的套接字中接收一次数据到string字符串容器

参数

data	接收数据的数据容器（string类型）
length	最大接收长度

返回

返回值 > 0：成功接收的字节数；
返回值 = 0：连接已关闭；
返回值 < 0：接收失败；
- -99：对象未绑定 socket；
- -100：非阻塞模式且没有数据

注解: 接收是否会阻塞根据fd的阻塞情况决定

int stt::network::TcpFDHandler::recvData	(	char *	data,
		const uint64_t &	length
	)

从已连接的套接字中接收一次数据到char*容器

参数

data	接收数据的数据容器（char*类型）
length	最大接收长度

返回

返回值 > 0：成功接收的字节数；
返回值 = 0：连接已关闭；
返回值 < 0：接收失败；
- -99：对象未绑定 socket；
- -100：非阻塞模式且没有数据

注解: 接收是否会阻塞根据fd的阻塞情况决定

int stt::network::TcpFDHandler::recvDataByLength	(	std::string &	data,
		const uint64_t &	length,
		const int &	sec = `2`
	)

从已连接的套接字中阻塞接收指定长度的数据到字符串

参数

data	接收数据的数据容器（string类型）
length	接收长度
sec	等待时间单位为秒 -1为无限阻塞等待（默认为2s）

返回

返回值 > 0：成功接收的字节数；
返回值 = 0：连接已关闭；
返回值 < 0：接收失败；
- -99：对象未绑定 socket；
- -100：超时

注解: 如果没有接收完指定的数据大小，一定阻塞到超时或者出错

int stt::network::TcpFDHandler::recvDataByLength	(	char *	data,
		const uint64_t &	length,
		const int &	sec = `2`
	)

从已连接的套接字中阻塞接收指定长度的数据到char*容器

参数

data	接收数据的数据容器（char*类型）
length	接收长度
sec	等待时间单位为秒 -1为无限阻塞等待（默认为2s）

返回

返回值 > 0：成功接收的字节数；
返回值 = 0：连接已关闭；
返回值 < 0：接收失败；
- -99：对象未绑定 socket；
- -100：超时

注解: 如果没有接收完指定的数据大小，一定阻塞到超时或者出错

int stt::network::TcpFDHandler::sendData	(	const std::string &	data,
		const bool &	block = `true`
	)

向已连接的套接字发送字符串数据。

参数

data	要发送的数据内容（std::string 类型）。
block	是否以阻塞模式发送（默认 true）。 true：会阻塞直到全部数据发送成功除非出错了（无论 socket 是阻塞或非阻塞）；如果需要判断是否连接断开了可以检查flag3标志位判断。 false：阻塞与否取决于套接字状态。

返回

返回值 > 0：成功发送的字节数；
返回值 = 0：连接已关闭（block=false）或者发送成功的字节数为0（block=true）；
返回值 < 0（只可能在block=false的情况下）：发送失败；
- -99：对象未绑定 socket；
- -100：非阻塞模式下，发送缓冲区已满。

注解: 若 block 为 true，会持续阻塞直到全部数据发送完毕除非出错了（无论 socket 是阻塞或非阻塞），返回值一定>=0,适合希望确保完整发送的场景。如果需要判断是否连接断开了可以检查flag3标志位判断。若 block 为 false，阻塞与否取决于套接字状态。返回值可能小于希望发送的长度，需手动处理剩余数据。

int stt::network::TcpFDHandler::sendData	(	const char *	data,
		const uint64_t &	length,
		const bool &	block = `true`
	)

向已连接的套接字发送指定长度的二进制数据。

参数

data	指向要发送的数据缓冲区。
length	数据长度（字节）。
block	是否以阻塞模式发送（默认 true）。 true：会阻塞直到全部数据发送成功除非出错了（无论 socket 是阻塞或非阻塞）；如果需要判断是否连接断开了可以检查flag3标志位判断。 false：阻塞与否取决于套接字状态。

返回

返回值 > 0：成功发送的字节数；
返回值 = 0：连接已关闭（block=false）或者发送成功的字节数为0（block=true）；
返回值 < 0（只可能在block=false的情况下）：发送失败；
- -99：对象未绑定 socket；
- -100：非阻塞模式下，发送缓冲区已满。

注解: 若 block 为 true，会持续阻塞直到全部数据发送完毕除非出错了（无论 socket 是阻塞或非阻塞），返回值一定>=0,适合希望确保完整发送的场景。如果需要判断是否连接断开了可以检查flag3标志位判断。若 block 为 false，阻塞与否取决于套接字状态。返回值可能小于 length，需手动处理剩余数据。

void stt::network::TcpFDHandler::setFD	(	const int &	fd,
		SSL *	ssl,
		const bool &	flag1 = `false`,
		const bool &	flag2 = `false`,
		const int &	sec = `-1`
	)

传入套接字初始化对象

注解: 可以选择设置套接字的阻塞和非阻塞，SO_REUSEADDR模式（只可能在服务端socket用到），还能选择该套接字加密后的SSL句柄

参数

fd	套接字
ssl	fd经过TLS加密后的SSL句柄（如果没有可以填nullptr）
flag1	true：启用非阻塞模式 false：启用阻塞模式（默认为false，即启用阻塞模式）
flag2	true：启用SO_REUSEADDR模式 false：不启用SO_REUSEADDR模式（默认为false，即不启用SO_REUSEADDR模式）
sec	阻塞超时时间阻塞超过这个时间就不会再阻塞了默认为-1 即无限等待

void stt::network::TcpFDHandler::unblockSet ( )

设置对象中的套接字为非阻塞模式

类成员变量说明

int stt::network::TcpFDHandler::fd =-1

protected

bool stt::network::TcpFDHandler::flag1 =false

protected

bool stt::network::TcpFDHandler::flag2 =false

protected

bool stt::network::TcpFDHandler::flag3 =false

如果sendData的block=true，如果发送过程中连接断开，这个标志位会置为true

int stt::network::TcpFDHandler::sec =-1

protected

SSL* stt::network::TcpFDHandler::ssl =nullptr

protected

该类的文档由以下文件生成:

include/sttnet.h

Public 成员函数

Public 属性

Protected 属性

详细描述

成员函数说明

类成员变量说明