Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Returned Value

None.

Notes/Warnings

  • The access mode should be the logical OR of one or more flags :

    FS_FILE_ACCESS_MODE_RDFile opened for reads.
    FS_FILE_ACCESS_MODE_WRFile opened for writes.
    FS_FILE_ACCESS_MODE_CREATEFile will be created, if necessary.
    FS_FILE_ACCESS_MODE_TRUNCFile length will be truncated to 0.
    FS_FILE_ACCESS_MODE_APPENDAll writes will be performed at EOF.
    FS_FILE_ACCESS_MODE_EXCLFile will be opened if and only if it does not already exist.
    FS_FILE_ACCESS_MODE_CACHEDFile data will be cached.
  • If FS_FILE_ACCESS_MODE_TRUNC is set, then FS_FILE_ACCESS_MODE_WR must also be set.
  • If FS_FILE_ACCESS_MODE_EXCL is set, then FS_FILE_ACCESS_MODE_CREATE must also be set.
  • FS_FILE_ACCESS_MODE_RD and/or FS_FILE_ACCESS_MODE_WR must be set.
  • The mode string argument of fs_fopen() function can specify a subset of the possible valid modes for this function. The equivalent modes of fs_fopen() mode strings are shown in the table below.

    fopen() Mode String

    mode Equivalent

    “r” or “rb”

    FS_FILE_ACCESS_MODE_RD

    “w” or “wb”

    FS_FILE_ACCESS_MODE_WR |
    FS_FILE_ACCESS_MODE_CREATE |
    FS_FILE_ACCESS_MODE_TRUNC

    “a” or “ab”

    FS_FILE_ACCESS_MODE_WR |
    FS_FILE_ACCESS_MODE_CREATE |
    FS_FILE_ACCESS_MODE_APPEND

    “r+” or “rb+” or “r+b”

    FS_FILE_ACCESS_MODE_RD |
    FS_FILE_ACCESS_MODE_WR

    “w+” or “wb+” or “w+b”

    FS_FILE_ACCESS_MODE_RD |
    FS_FILE_ACCESS_MODE_WR |
    FS_FILE_ACCESS_MODE_CREATE |
    FS_FILE_ACCESS_MODE_TRUNC

    “a+” or “ab+” or “a+b”

    FS_FILE_ACCESS_MODE_RD |

    FS_FILE_ACCESS_MODE_WR |
    FS_FILE_ACCESS_MODE_CREATE |

    FS_FILE_ACCESS_MODE_APPEND