NAME

verbose_pso - Printing to stdout if verbose level is high enough.

SYNOPSIS

#include "l/l_verbose.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 verbose_pso
(
	int cut_off,
	const char *format_str,
	...
);

DESCRIPTION

This routine writes a formatted string to stdout if the first paramter is equal to or exceeds the verbose level set by kjb_set_verbose_level. When verbose_pso prints, it prepends a string to each line which identifies that the verbosity level cutoff. That string is "<< %d >> ". Otherwise it is similar to pso. Specifically, it is similar to kjb_fprintf with respect to extended formatting options and paging.

RETURNS

Returns the number of characters written, which is zero in the case of the verbose level being smaller than the argument. ERROR is returned if there is an error.

RELATED

verbose_puts, pso, kjb_fprintf

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER

Kobus Barnard

SEE ALSO

kjb_set_verbose_level , kjb_get_verbose_level , verbose_puts , warn_pso , warn_puts , interactive_pso , interactive_puts