fbinread

This function is used to read a binary file that has been written using an UNFORMATTED FORTRAN write and contains only one record. The fbinrecread function should be used for files with multiple records and fbindirread should be used for files written with Fortran direct access files.


Synopsis

	function fbinread( 
		filepath[1]:string,
		dimensions[*]:integer,
		datatype[1]:string
	)

Arguments

filepath
Path needed to locate binary file.
dimensions
An array specifying the dimensions of the data to be read or the value -1.
datatype
A string representing the type of the data being read.

Description

The fbinread function is used to read binary data. To guarantee this function will work, the data must have been written on a machine with the same architecture and Fortran compiler as the machine on which they are being read. If the specified dimensions do not define a size equal to the total file data size, an error message is generated. Note that there is no way for NCL to determine if the type of file and the datatype parameter represent the same type. If the value of -1 is used for dimensions then all of the values of the Fortran record are read and the output is a single dimension variable with a dimension size equal to the number of elements of the record.

The purpose of this function is to "skip" over control words often written into Fortran records. This function, technically, is limited to only reading one Fortran record. However, if the size of the control words are equal to the data type being read and the file contains only a single data type, there are techniques for reading multiple record Fortran binary files. (See Binary data input in the NCL user guide tutorial)


Reference Manual Control Panel

NG4.1 Home, Index, Examples, Glossary, Feedback, Ref Contents, Ref WhereAmI?


$Revision: 1.16 $ $Date: 1998/11/11 23:32:16 $