开发者
资源
文档评分
获取效率
正确性
完整性
易理解
在线提单
论坛求助

read

  1. 接口定义
    ssize_t read(int fd,void *buf,size_t count)
  2. 接口描述

    从文件描述符fd读取最多count字节数据到buf指向的缓冲区。

  3. 接口约束
    • fd必须为打开且可读的文件描述符(不能为目录)。
    • count不能大于SSIZE_MAX,否则结果未定义。
    • count为0时返回0,不执行任何操作。
  4. 参数说明
    表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

  5. 接口返回值
    表2 接口返回值

    返回码

    返回值

    描述

    HLC_ERR

    “-1”

    失败,并设置errno

    READ_SIZE

    “>=0”

    成功:实际读取到的字节数(包含0表示EOF)