NAME

kjb_fwrite - Writes a specified number of bytes to 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 


long kjb_fwrite
(
	FILE *fp,
	const void *line,
	size_t len
);

PARAMETERS

FILE *fp: File pointer
const void *line: Pointer to bytes to write
size_t len: Number of bytes to write.

DESCRIPTION

This routine is similar to fwrite (but note the difference in arguments!). However, error handling is made more consistant with the rest of the KJB library. Several other KJB library IO conventions and features are also implemented. (One should not mix KJB and non-KJB IO)! This routine can only write up to LONG_MAX bytes at a time. The routine kjb_fwrite_2() can be used to write up the number of bytes that can stored in size_t. This function is not re-entrant (i.e., not thread-safe).

RETURNS

On success kjb_write returns the number of bytes written. On failure ERROR is returned and an error message is set.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER