NAME

fp_write_int_matrix_with_header - Writes data row-wise to a FILE prefaced by an integer matrix header

SYNOPSIS

#include "l/l_int_mat_io.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


int fp_write_int_matrix_with_header
(
	const Int_matrix *mp,
	FILE *fp
);

DESCRIPTION

This routine writes data in an integer matrix to a file. Data is prefaced by a matrix size header indicating the number of rows and columns in the matrix being output. "fp" points to a FILE object as returned by "kjb_fopen". A matrix size header is written at the current file position. The matrix size header has the form:
   #! rows=<num-matrix-rows> cols=<num-matrix-cols>
where <num-matrix-rows>,<num-matrix-cols> are positive integers. (The "#" is actually the comment char (user settable) and the "!" is actually the header char, also user settable). Data is then written in row order to the file. The current file position is NOT reset to the starting after the function returns, so this function can be used to write multiple matrices from the same file.

RETURNS

NO_ERROR on success, ERROR on failure, with "kjb_error" set to a descriptive message.

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Lindsay Martin and Kobus Barnard

DOCUMENTER

Lindsay Martin and Kobus Barnard

SEE ALSO

read_int_matrix_from_config_file , read_int_matrix , fp_read_int_matrix , fp_read_raw_int_matrix , fp_read_int_matrix_from_matlab_file , fp_read_int_matrix_with_header , fp_read_formatted_int_matrix , read_int_matrix_by_rows , fp_read_int_matrix_by_rows , read_int_matrix_by_cols , fp_read_int_matrix_by_cols , fp_ow_read_formatted_int_matrix , fp_ow_read_int_matrix_by_rows , fp_ow_read_int_matrix_by_cols , fp_read_matrix_size_header , fp_write_int_matrix_with_title , write_int_matrix , fp_write_int_matrix , write_raw_int_matrix , fp_write_raw_int_matrix , write_int_matrix_rows , fp_write_int_matrix_rows , write_int_matrix_cols , fp_write_int_matrix_cols , write_int_matrix_with_header , fp_write_matrix_size_header , write_int_matrix_to_matlab_file , fp_write_int_matrix_to_matlab_file