1 Star 0 Fork 340

seasky100 / awtk

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
path_t.md 7.28 KB
一键复制 编辑 原始数据 按行查看 历史
xianjimli 提交于 2020-03-17 10:48 . update docs

path_t

概述

路径相关的工具函数。

函数

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

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 函数


  • 函数功能:

构造路径。

可变参数为字符串,以NULL参数结束。

  • 函数原型:
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_is_abs 函数


  • 函数功能:

判断路径是否为绝对路径。

  • 函数原型:
ret_t path_is_abs (const char* path* path);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回FALSE表示不是绝对路径,否则表示是绝对路径。
path const char* path* 路径。

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_replace_extname 函数


  • 函数功能:

替换文件扩展名。

  • 函数原型:
ret_t path_replace_extname (char* result, uint32_t size, char* filename, char* extname);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
result char* 用于返回结果。
size uint32_t 缓冲区大小。
filename char* 原始文件路径。
extname char* 替换后的文件扩展名。
C
1
https://gitee.com/seasky100/awtk.git
git@gitee.com:seasky100/awtk.git
seasky100
awtk
awtk
master

搜索帮助