fdds_fflush - flush DDS binary stream

SYNOPSIS

#include <fdds.h> (fixed-format sources)
#include <f90dds.h> (free-format sources)

integer function fdds_fflush(bin)

integer bin

DESCRIPTION

fdds_flush flushes all or a selected binary stream. Pipe media only supports forward seeks.

INPUT

bin is a binary tag, previously obtained from fdds_open. It specifies a particular binary stream. If the binary is sliced, then each slice stream is flushed. If the binary tag is negative, then all output streams are flushed.

OUTPUT

The binary buffer(s) is(are) flushed to the operating system.

The return value is zero, or -1 if an error occurred.

EXAMPLES

      integer bin
      ...
      ! flush a specific output stream
      ier = fdds_fflush(bin)
      ...
      ! flush all output streams
      ier = fdds_fflush(-1)

AUTHOR

Jerry Ehlers, BP America (May 2003)