ff_fprintf()

[FreeRTOS-Plus-FAT 标准 API 引用]

ff_stdio.h

size_t ff_fprintf( FF_FILE * pxStream, const char *pcFormat, ... );

以与 sprintf() 将格式化数据写入缓冲区，或 printf() 将格式化数据写入控制台的相同方式将格式化数据写入文件。

ff_fprintf() 调用 vsnprintf()，该函数必须由您的 C 库提供，用于使用 ff_fprintf() 链接的项目。格式说明符和可用的扩展（例如 “%02D”，“%s” 等）将取决于您的 C 库。

必须将 FreeRTOSFATConfig.h 中的 FF_FPRINTF_SUPPORT 设置为 1 使 ff_fprintf() 可用。

注意： ff_fprintf() 是一个较重的函数，因为它在向文件输出数据之前，将它写入格式化数据的内存进行分配。它还使用 vsnprintf()，这可能会导致大量其他库代码被包含到项目中。

参数：

pxStream	指向要写入格式化数据的文件的指针。该指针与调用 ff_fopen() 返回的指针相同，最初用于打开文件。
pcFormat	格式字符串，其使用方式与格式字符串输入 printf() 调用的方式完全相同。可用的格式说明符将取决于所使用的 C 库。
...	实参值变量列表，其中，格式字符串中的每个说明符均有一个值。

返回：

如果 ff_printf() 无法分配缓冲区，则返回 0。

如果数据被写入文件，则返回写入的字节数。

如果存在写入错误，则返回 -1，并且任务的 errno 设置为指示原因。任务可以使用 stdioGET_ERRNO() API 函数获取其 errno 值。

用法示例：

ff_fgets() 文档页面中提供的示例显示了 ff_fprintf() 的使用方式。