cbinread

This function is used to read in binary files that have been written using the C block I/O function write.

Synopsis

	function cbinread( 
		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 cbinread function is used to read in binary data. The data must be read on the same architecture machine as it was written. If the dimensions specified specify a size less than the total file size, only the first n bytes of the file will be read in, where n is the product of the dimensions times the size of the specified type. If the size implied by the dimension sizes is greater than the file size, then the remaining space in the returned value is padded with the default missing value for the specified type. In both of these cases, warnings are printed. Note 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 the entire file is read into a single dimension variable with a dimension length equal to the number of elements in the file.

Reference Manual Control Panel

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

$Revision: 1.13 $ $Date: 1998/06/15 21:29:00 $