forked
LocalFileSystem Class Reference
[Platform]
A filesystem for accessing the local mbed Microcontroller USB disk drive. More...
#include <LocalFileSystem.h>
Inherits mbed::FileSystemLike, and NonCopyable< LocalFileSystem >.
Public Member Functions | |
virtual int | open (FileHandle **file, const char *path, int flags) |
Open a file on the filesystem. | |
virtual int | open (DirHandle **dir, const char *name) |
Open a directory on the filesystem. | |
virtual int | remove (const char *filename) |
Remove a file from the filesystem. | |
MBED_DEPRECATED_SINCE ("mbed-os-5.5","Replaced by `int open(FileHandle **, ...)` for propagating error codes") FileHandle *open(const char *path | |
Open a file on the filesystem. | |
virtual int | rename (const char *path, const char *newpath) |
Rename a file in the filesystem. | |
virtual int | stat (const char *path, struct stat *st) |
Store information about the file in a stat structure. | |
virtual int | mkdir (const char *path, mode_t mode) |
Create a directory in the filesystem. |
Detailed Description
A filesystem for accessing the local mbed Microcontroller USB disk drive.
This allows programs to read and write files on the same disk drive that is used to program the mbed Microcontroller. Once created, the standard C file access functions are used to open, read and write files.
- Note:
- Synchronization level: Thread safe
Example:
#include "mbed.h" LocalFileSystem local("local"); // Create the local filesystem under the name "local" int main() { FILE *fp = fopen("/local/out.txt", "w"); // Open "out.txt" on the local file system for writing fprintf(fp, "Hello World!"); fclose(fp); remove("/local/out.txt"); // Removes the file "out.txt" from the local file system DIR *d = opendir("/local"); // Opens the root directory of the local file system struct dirent *p; while((p = readdir(d)) != NULL) { // Print the names of the files in the local file system printf("%s\n", p->d_name); // to stdout. } closedir(d); }
- Note:
- If the microcontroller program makes an access to the local drive, it will be marked as "removed" on the Host computer. This means it is no longer accessible from the Host Computer.
The drive will only re-appear when the microcontroller program exists. Note that if the program does not exit, you will need to hold down reset on the mbed Microcontroller to be able to see the drive again!
Definition at line 102 of file LocalFileSystem.h.
Member Function Documentation
MBED_DEPRECATED_SINCE | ( | "mbed-os-5.5" | , |
"Replaced by `int open(FileHandle **, ...)` for propagating error codes" | |||
) | const [inherited] |
Open a file on the filesystem.
- Parameters:
-
path The name of the file to open flags The flags to open the file in, one of O_RDONLY, O_WRONLY, O_RDWR, bitwise or'd with one of O_CREAT, O_TRUNC, O_APPEND
- Returns:
- A file handle on success, NULL on failure
int open | ( | DirHandle ** | dir, |
const char * | path | ||
) | [virtual] |
Open a directory on the filesystem.
- Parameters:
-
dir Destination for the handle to the directory path Name of the directory to open
- Returns:
- 0 on success, negative error code on failure
Reimplemented from FileSystemHandle.
Definition at line 269 of file LocalFileSystem.cpp.
int open | ( | FileHandle ** | file, |
const char * | filename, | ||
int | flags | ||
) | [virtual] |
Open a file on the filesystem.
- Parameters:
-
file Destination for the handle to a newly created file filename The name of the file to open flags The flags to open the file in, one of O_RDONLY, O_WRONLY, O_RDWR, bitwise or'd with one of O_CREAT, O_TRUNC, O_APPEND
- Returns:
- 0 on success, negative error code on failure
Implements FileSystemHandle.
Definition at line 239 of file LocalFileSystem.cpp.
int remove | ( | const char * | path ) | [virtual] |
Remove a file from the filesystem.
- Parameters:
-
path The name of the file to remove.
- Returns:
- 0 on success, negative error code on failure
Reimplemented from FileSystemHandle.
Definition at line 263 of file LocalFileSystem.cpp.
Generated on Tue Jul 12 2022 16:02:36 by 1.7.2