awtk/docs/manual/fs_t.md

fs_t

概述

文件系统接口。

---

函数

函数名称	说明
file_exist
file_get_size
file_read
file_read_part
file_remove
file_write
fs_dir_exist
fs_dir_rename
fs_file_exist
fs_file_rename
fs_get_cwd
fs_get_exe
fs_get_file_size
fs_open_dir
fs_open_file
fs_remove_dir
fs_remove_file
os_fs	获取缺省的文件系统对象。

file_exist 函数

---

• 函数功能：

判断文件是否存在。

• 函数原型：

ret_t file_exist (const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回TRUE表示成功，否则表示失败。
name	const char*	文件名。

file_get_size 函数

---

• 函数功能：

获取文件大小。

• 函数原型：

ret_t file_get_size (const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回不是-1表示成功，否则表示失败。
name	const char*	文件名。

file_read 函数

---

• 函数功能：

读取文件。

• 函数原型：

int32_t* file_read (const char* name, uint32_t* size);

• 参数说明：

参数	类型	说明
返回值	int32_t*	返回实际读取的字节数。
name	const char*	文件名。
size	uint32_t*	缓冲区大小。

file_read_part 函数

---

• 函数功能：

从某个位置读取文件。

• 函数原型：

int32_t* file_read_part (const char* name, const void* buffer, uint32_t size, uint32_t offset);

• 参数说明：

参数	类型	说明
返回值	int32_t*	返回实际读取的字节数。
name	const char*	文件名。
buffer	const void*	数据缓冲区。
size	uint32_t	数据长度。
offset	uint32_t	偏移量。

file_remove 函数

---

• 函数功能：

刪除文件。

• 函数原型：

ret_t file_remove (const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
name	const char*	文件名。

file_write 函数

---

• 函数功能：

写入文件。

• 函数原型：

int32_t file_write (const char* name, const void* buffer, uint32_t size);

• 参数说明：

参数	类型	说明
返回值	int32_t	返回实际写入的字节数。
name	const char*	文件名。
buffer	const void*	数据缓冲区。
size	uint32_t	数据长度。

fs_dir_exist 函数

---

• 函数功能：

判断目录是否存在。

• 函数原型：

ret_t fs_dir_exist (fs_t* fs, const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回TRUE表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
name	const char*	目录名称。

fs_dir_rename 函数

---

• 函数功能：

目录重命名。

• 函数原型：

ret_t fs_dir_rename (fs_t* fs, const char* name, const char* new_name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回TRUE表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
name	const char*	旧目录名称。
new_name	const char*	新目录名称。

fs_file_exist 函数

---

• 函数功能：

判断文件是否存在。

• 函数原型：

ret_t fs_file_exist (fs_t* fs, const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回TRUE表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
name	const char*	文件名。

fs_file_rename 函数

---

• 函数功能：

文件重命名。

• 函数原型：

ret_t fs_file_rename (fs_t* fs, const char* name, const char* new_name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回TRUE表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
name	const char*	旧文件名。
new_name	const char*	新文件名。

fs_get_cwd 函数

---

• 函数功能：

获取当前所在目录。

• 函数原型：

ret_t fs_get_cwd (fs_t* fs, char* path);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
path	char*	保存当前所在目录的路径。

fs_get_exe 函数

---

• 函数功能：

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

• 函数原型：

ret_t fs_get_exe (fs_t* fs, char* path);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
path	char*	保存可执行文件的路径。

fs_get_file_size 函数

---

• 函数功能：

获取文件大小。

• 函数原型：

ret_t fs_get_file_size (fs_t* fs, const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回不是-1表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
name	const char*	文件名。

fs_open_dir 函数

---

• 函数功能：

打开目录。

• 函数原型：

ret_t fs_open_dir (fs_t* fs, const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回不是NULL表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
name	const char*	目录名称。

fs_open_file 函数

---

• 函数功能：

打开文件。

• 函数原型：

ret_t fs_open_file (fs_t* fs, const char* name, const char* mode);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回不是NULL表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
name	const char*	文件名。
mode	const char*	打开方式。

fs_remove_dir 函数

---

• 函数功能：

刪除目录。

• 函数原型：

ret_t fs_remove_dir (fs_t* fs, const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
name	const char*	目录名称。

fs_remove_file 函数

---

• 函数功能：

刪除文件。

• 函数原型：

ret_t fs_remove_file (fs_t* fs, const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
fs	fs_t*	文件系统对象，一般赋值为os_fs()。
name	const char*	文件名。

os_fs 函数

---

• 函数功能：

获取缺省的文件系统对象。

• 函数原型：

fs_t* os_fs ();

• 参数说明：

参数	类型	说明
返回值	fs_t*	返回文件系统对象。