FWRITE File Write Function
Section: Input/Ouput Functions
UsageWrites an array to a given file handle as a block of binary (raw) data. The general use of the function is
n = fwrite(handle,A)
handle argument must be a valid value returned by the fopen
function, and accessable for writing. The array
A is written to
the file a column at a time. The form of the output data depends
on (and is inferred from) the precision of the array
A. If the
write fails (because we ran out of disk space, etc.) then an error
is returned. The output
n indicates the number of elements
Note that unlike MATLAB, FreeMat 4 does not default to
writing arrays to files. Alternately, the type of the data to be
written to the file can be specified with the syntax
n = fwrite(handle,A,type)
type is one of the following legal values:
- 'uint8','uchar','unsigned char' for an unsigned, 8-bit integer.
- 'int8','char','integer*1' for a signed, 8-bit integer.
- 'uint16','unsigned short' for an unsigned, 16-bit integer.
- 'int16','short','integer*2' for a signed, 16-bit integer.
- 'uint32','unsigned int' for an unsigned, 32-bit integer.
- 'int32','int','integer*4' for a signed, 32-bit integer.
- 'single','float32','float','real*4' for a 32-bit floating point.
- 'double','float64','real*8' for a 64-bit floating point.
ExampleHeres an example of writing an array of
512 x 512Gaussian-distributed
floatrandom variables, and then writing them to a file called
--> A = float(randn(512)); --> fp = fopen('test.dat','w'); --> fwrite(fp,A,'single'); --> fclose(fp);