NAME

kjb_fread_exact - Reads a specifed number of bytes from a stream.

SYNOPSIS

#include "l/l_sys_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 kjb_fread_exact
(
	FILE *fp,
	void *buff,
	size_t len
);

DESCRIPTION

This routine is very similar to kjb_fread, execpt that exactly "len" bytes must be successfully read for a successfull return. Otherwise, ERROR is returned, with an approapriate error measure being set. This function is not re-entrant (i.e., not thread-safe).

RETURNS

On success kjb_fread_exact returns NO_ERROR. Since the number of bytes that must be read is in the parameter, there is no need to return that (thus avoiding problems due to signed versus unsigned types). On failure ERROR is returned and an error message is set. Other kjb_fread returns such as EOF will not occur.

MACROS

FIELD_READ

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER