NCL Home > Documentation > Functions > File IO

fbinwrite

Writes a single binary record to a file in manner analogous to fortran's "form=unformatted, access=sequential".

Prototype

	procedure fbinwrite (
		filepath [1] : string,   
		value        : numeric   
	)

Arguments

filepath

Path needed to locate binary file.

value

A numeric value of any dimensionality.

Description

The fbinwrite function is used to create a binary data file from an NCL numeric variable. The variable is written to a file as a single sequential access unformatted record.

By default, the elements of value are written to the file using the machine's native binary format. To force the byte order to be written as big-endian or little-endian, see the "WriteByteOrder" option in the setfileoption procedure.

See Also

fbinnumrec, fbinrecread, fbindirread, fbinread, fbinrecwrite, fbindirwrite, setfileoption

Examples

The following will write one record length 100x64x128 float words.

  ntimes = 100
  z      = new ( (/ntimes,64,128/), float)
         .
  fbinwrite(path, z )

The binary file will be the same as a one open via fortran's open statement:

    open(..., form="unformatted",  [,access="sequential"] )  ; sequential is default