esp_vfs_fat_create_contiguous_file() function

Create a file with contiguous space at given path

Syntax

Show:

Summary

Declaration

Definition

from esp_vfs_fat.h:420

esp_err_t esp_vfs_fat_create_contiguous_file(const char* base_path, const char* full_path, uint64_t size, bool alloc_now);

Implemented in vfs_fat.c:1390

Arguments

Argument

Description

base_path

Base path of the partition examined (e.g. "/spiflash")

full_path

Full path of the file (e.g. "/spiflash/ABC.TXT")

size

File size expanded to, number of bytes in size to prepare or allocate for the file

alloc_now

True == allocate space now, false == prepare to allocate -- see `f_expand` from FATFS

Return value

- ESP_OK on success - ESP_ERR_INVALID_ARG if invalid arguments (e.g. any of arguments are NULL or size lower or equal to 0) - ESP_ERR_INVALID_STATE if partition not found - ESP_FAIL if another FRESULT error (saved in errno)

Notes

The file cannot exist before calling this function (or the file size has to be 0) For more information see documentation for `f_expand` from FATFS library

Examples

References

from examples

esp_vfs_fat_create_contiguous_file() function

Syntax

Arguments

Return value

Notes

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle