read
- 接口定义
ssize_t read(int fd,void *buf,size_t count)
- 接口描述
- 接口约束
- fd必须为打开且可读的文件描述符(不能为目录)。
- count不能大于SSIZE_MAX,否则结果未定义。
- count为0时返回0,不执行任何操作。
- 参数说明
表1 参数说明 输入参数
输入/输出
范围
数据类型
含义
版本
“fd”
I
>=0
int
打开的文件描述符
1.0.0
“buf”
O
valid mem
void*
存放读取数据的输出缓冲区
1.0.0
“count”
I
0..SSIZE_MAX
size_t
请求读取的最大字节数
1.0.0
- 接口返回值
表2 接口返回值 返回码
返回值
描述
HLC_ERR
“-1”
失败,并设置errno
READ_SIZE
“>=0”
成功:实际读取到的字节数(包含0表示EOF)
父主题: 对外接口