AWTK API

# 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对象。

← tk_ostream_retry_t →