AWTK API

# path

# 概述

路径接口。

# 函数

函数名称 说明
path_abs 返回绝对路径。
path_app_root 获取app所在目录。
path_basename 返回文件名。
path_build 构造路径。
path_cwd 获取当前所在目录。
path_dirname 返回目录。
path_exe 获取可执行文件所在目录。
path_exist 判断目录是否存在。
path_extname 返回文件扩展名。
path_normalize 规范路径字符形式。
path_replace_basename 替换文件名。

# path_abs 函数

  • 函数功能：

返回绝对路径。

  • 函数原型：
ret_t path_abs (const char* path* path, char* result, uint32_t size);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功，否则表示失败。
path const char* path* 路径。
result char* 用于返回绝对路径。
size uint32_t 缓冲区大小。

# path_app_root 函数

  • 函数功能：

获取app所在目录。

  • 函数原型：
ret_t path_app_root (char* path);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功，否则表示失败。
path char* 保存app所在目录。

# path_basename 函数

  • 函数功能：

返回文件名。

  • 函数原型：
ret_t path_basename (const char* path* path, char* result, uint32_t size);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功，否则表示失败。
path const char* path* 路径。
result char* 用于返回文件名。
size uint32_t 缓冲区大小。

# path_build 函数

  • 函数功能：

构造路径。

  • 函数原型：
ret_t path_build (char* result, uint32_t size);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功，否则表示失败。
result char* 用于返回路径。
size uint32_t 缓冲区大小。

# path_cwd 函数

  • 函数功能：

获取当前所在目录。

  • 函数原型：
ret_t path_cwd (char* path);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功，否则表示失败。
path char* 保存当前所在目录的路径。

# path_dirname 函数

  • 函数功能：

返回目录。

  • 函数原型：
ret_t path_dirname (const char* path* path, char* result, uint32_t size);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功，否则表示失败。
path const char* path* 路径。
result char* 用于返回目录。
size uint32_t 缓冲区大小。

# path_exe 函数

  • 函数功能：

获取可执行文件所在目录。

  • 函数原型：
ret_t path_exe (char* path);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功，否则表示失败。
path char* 保存可执行文件所在目录。

# path_exist 函数

  • 函数功能：

判断目录是否存在。

  • 函数原型：
ret_t path_exist (const char* path);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回TRUE表示成功，否则表示失败。
path const char* 目录。

# path_extname 函数

  • 函数功能：

返回文件扩展名。

  • 函数原型：
ret_t path_extname (const char* path* path, char* result, uint32_t size);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功，否则表示失败。
path const char* path* 路径。
result char* 用于返回文件扩展名。
size uint32_t 缓冲区大小。

# path_normalize 函数

  • 函数功能：

规范路径字符形式。

  • 函数原型：
ret_t path_normalize (const char* path* path, char* result, uint32_t size);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功，否则表示失败。
path const char* path* 路径。
result char* 用于返回规范后的路径。
size uint32_t 缓冲区大小。

# path_replace_basename 函数

  • 函数功能：

替换文件名。

  • 函数原型：
ret_t path_replace_basename (char* result, uint32_t size, char* filename, char* basename);
  • 参数说明：
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功，否则表示失败。
result char* 用于返回结果。
size uint32_t 缓冲区大小。
filename char* 原始文件路径。
basename char* 替换后的文件名。

← path_t →