Editing fflush - FilterMeisterWiki

When saving, enter the following:

  ____      ZZZZ  TTTT               ___  
 |  _ \      ZZ   TT TT             / _ \ 
 | |_) |     ZZ   TT  TT   ######  / /_\ \
 |  __/  ZZ  ZZ   TT  TT   ##      |  _  |
 |_|    ZZ   ZZ   TT  TT   ####    | | | |
        ZZ   ZZ   TT TT    ##      \_| |_/
         ZZZZZ    TTTT     ##             
                           ##

Visit Preferences to set your user name

= fflush =
== Syntax ==
:{{int fflush(int filepointer)}}
== Arguments ==
:'''filepointer'''
::A pointer to a file/stream previously opened with ((fopen)).
== Return ==
:Returns 0 if the file is flushed successfully, and EOF if it encounters any problems.
== Description ==
:Writes all remaining data in the writing buffer of the specified filepointer to the associated file.
:The main use of this function is security; ensuring the data is stored in the file in order to protect against crashes. Use this function if your file format allows processing of the partial file.
== Example ==
<code>
int IMG_FILE;
if (IMG_FILE = fopen("d:\\FM_image0.fmi", "wb")) {
  // Write out the src pixels as raw data
  for (z = 0; z < Z; ++z) {
    for (y = 0; y < Y; ++y) {
      for (x = 0; x < X; ++x) {
        fputc(src(x, y, z), IMG_FILE);
      }
    }
    fflush(IMG_FILE); // ensure complete channel is stored before next channel is written.
  }
}
else
  ErrorOk("Cannot write image file\nDrive is either full or write-protected!");

if (fclose(IMG_FILE))
  ErrorOk("Cannot close image file!");
</code>
== Also see ==
:((flushall))
== Comments ==
:Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.

Summary of change:
Add document to category: