mirror of
https://gitee.com/zlgopen/awtk.git
synced 2024-12-10 16:46:14 +08:00
4.9 KiB
4.9 KiB
tk_ostream_process_t
概述
基于串口实现的输出流。
input stream base on fd
函数
函数名称 | 说明 |
---|---|
process_create | 创建子进程。 |
process_destroy | 释放子进程。 |
process_handle_get_fd | 获取文件描述符。 |
process_is_broken | 子进程是否断开 |
process_read | 读子进程的数据(StdIntput 的方式) |
process_wait_for_data | 等待数据。 |
process_write | 给子进程写数据(StdOutput 的方式) |
tk_ostream_process_create | 创建ostream对象。 |
process_create 函数
- 函数功能:
创建子进程。
- 函数原型:
process_handle_t process_create (const char* file_path, const char** args, uint32_t argc);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | process_handle_t | 返回子进程句柄。 |
file_path | const char* | 子进程程序路径。(如果为空的话,使用命令行来执行参数的内容) |
args | const char** | 子进程参数。 |
argc | uint32_t | 子进程参数长度。 |
process_destroy 函数
- 函数功能:
释放子进程。
- 函数原型:
ret_t process_destroy (process_handle_t handle);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
handle | process_handle_t | 子进程句柄。 |
process_handle_get_fd 函数
- 函数功能:
获取文件描述符。
- 函数原型:
int process_handle_get_fd (process_handle_t handle);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | int | 返回文件描述符。 |
handle | process_handle_t | 子进程句柄。 |
process_is_broken 函数
- 函数功能:
子进程是否断开
- 函数原型:
bool_t process_is_broken (process_handle_t handle);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | bool_t | 断开返回 true。 |
handle | process_handle_t | 子进程句柄。 |
process_read 函数
- 函数功能:
读子进程的数据(StdIntput 的方式)
- 函数原型:
int32_t process_read (process_handle_t handle, uint8_t* buff, uint32_t max_size);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | int32_t | 返回实际读取的字节数。 |
handle | process_handle_t | 子进程句柄。 |
buff | uint8_t* | 数据缓冲区。 |
max_size | uint32_t | 数据长度。 |
process_wait_for_data 函数
- 函数功能:
等待数据。
- 函数原型:
ret_t process_wait_for_data (process_handle_t handle, uint32_t timeout_ms);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
handle | process_handle_t | 子进程句柄。 |
timeout_ms | uint32_t | 等待时间(ms)。 |
process_write 函数
- 函数功能:
给子进程写数据(StdOutput 的方式)
- 函数原型:
int32_t process_write (process_handle_t handle, const uint8_t* buff, uint32_t max_size);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | int32_t | 返回实际写入的字节数。 |
handle | process_handle_t | 子进程句柄。 |
buff | const uint8_t* | 数据缓冲区。 |
max_size | uint32_t | 数据长度。 |
tk_ostream_process_create 函数
- 函数功能:
创建ostream对象。
- 函数原型:
tk_ostream_t* tk_ostream_process_create ();
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | tk_ostream_t* | 返回ostream对象。 |