wow-hfile文件操作说明

wow-hfile文件说明

• 项目地址：https://gitee.com/wow-iot/wow-iot7
• 本文件的的功能主要用于处理文件相关操作，主要涉及文件打开、关闭、读写、同步、跳转；
• 支持fio与io内部选定操作

一、fopen和open区别:

虽然open()和fopen()都用于打开文件，但它们的应用场景有一些区别，取决于你的需求和程序的特点。

open的使用场景：

• 低层文件操作：open() 是一个系统调用，提供了对文件的底层操作。因此，它更适合于需要直接访问文件描述符的低层文件操作。
• 文件描述符操作：如果你需要对文件描述符进行一些特殊的操作，比如使用 dup() 复制文件描述符，或者使用 fcntl() 进行文件控制，那么你需要使用 open() 打开文件以获取文件描述符。
• 特殊文件操作：open() 可以用于打开各种类型的文件，包括设备文件、管道、套接字等。因此，如果你需要打开这些特殊类型的文件，open() 是更合适的选择。

fopen的使用场景：

• 标准IO操作：fopen() 是C标准库提供的函数，提供了更高级别的文件操作接口，包括使用 fprintf()、fscanf() 等函数进行格式化的输入输出操作。
• 缓冲操作：fopen() 打开的文件默认是带有缓冲的，这意味着数据会先被缓存到内存中，然后再被写入到文件中。这对于需要频繁进行IO操作的程序来说，可以提高性能。
• 移植性和易用性：由于 fopen() 是C标准库的一部分，因此它具有很好的移植性，可以在不同的平台上使用，并且使用起来比较方便。
• 高级文件操作：fopen() 提供了一系列高级文件操作函数，比如 fseek()、ftell()、rewind() 等，可以更方便地对文件进行定位和操作。

综合考虑：

• 如果你的程序需要进行低层次的文件操作，或者需要处理特殊类型的文件，那么 open() 更适合。
• 如果你的程序主要是进行标准IO操作，或者需要高级的文件操作功能，那么 fopen() 更适合。
  在实际开发中，通常会根据具体需求和习惯选择使用合适的函数来打开文件。

二、文件接口说明

/*brief    打开文件*/
File_T* wow_hfile_open(FileCtx_E eCtx,const char *pcPath, FileOpenMode_E eMode);

/*brief    关闭文件*/
void wow_hfile_close(File_T*       ptFile);

/*brief    文件读操作*/
int wow_hfile_read(File_T* ptFile, void *pData, size_t snSize);

/*brief    读文件一行操作*/
int wow_hfile_readLine(File_T* ptFile, void *pData, size_t snSize);

/*brief    获取文件大小*/
int wow_hfile_size(File_T* ptFile);

/*brief    文件写操作*/
int wow_hfile_write(File_T* ptFile, const void *pData, size_t snSize);

/*brief    文件同步*/
int wow_hfile_sync(File_T* ptFile);

/*brief    文件跳转*/
int wow_hfile_seek(File_T* ptFile, size_t snOffset, int nWhence);