Versions Compared

Key

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

...

mode

Buffer mode:

FS__IONBR

Unbuffered.

FS__IOFBF

Fully buffered.

size

Size of buffer, in octets.

Returned Value

-1, if an error occurs.

0, if no error occurs.

Notes/Warnings

  • fs_setvbuf() must be used after a stream is opened but before any other operation is performed on stream.
  • size must be more than or equal to the size of one sector; it will be rounded DOWN to the nearest size of a multiple of full sectors.
  • Once a buffer is assigned to a file, a new buffer may not be assigned nor may the assigned buffer be removed. To change the buffer, the file should be closed and re-opened.
  • Upon power loss, any data stored in file buffers will be lost.