Reference   Language | Libraries | Comparison | Changes

Bridge : FileIO Class

FileSystem.open()

Description

Opens a file on the SD card. If the file is opened for writing, it will be created if it doesn't already exist (but the directory containing it must already exist).

This communicates with the Linux distribution through Bridge. While functionally similar to the SD library, the underlying code and connections are different.

Note: only one file can be open at a time.

Syntax

• FileSystem.open(filename)
• FileSystem.open(filename, mode)

Parameters

• filename: the name the file to open, which can:include directories (delimited by forward slashes, /) - char
• mode (optional): the mode in which to open the file, defaults to FILE_READ. Can be either "
  • FILE_READ: open the file for reading, starting at the beginning of the file.
  • FILE_WRITE: open the file for reading and writing, starting at the end of the file.

Returns

a File object referring to the opened file; if the file couldn't be opened, this object will evaluate to false in a boolean context, i.e. you can test the return value with "if (f)".

See also

• FileSystem.begin()

Reference Home

Corrections, suggestions, and new documentation should be posted to the Forum.

The text of the Arduino reference is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.