NAME

test_pso - Printing to stdout with <<TEST>> prefix

SYNOPSIS

#include "l/l_debug.h"

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


void test_pso
(
	const char *format_str,
	...
);

DESCRIPTION

This routine writes a formatted string to stdout with each lined prefixed with <<TEST>>. Normally this routine is only used indirectly using the macro TEST_PSO. Other behaviour is similar to pso. Specifically, it is similar to kjb_fprintf with respect to extended formatting options and paging.

RETURNS

Return is void, as it is normally used with the TEST_PSO macro.

MACROS

This routine is normally accessed using the macro TEST_PSO which sets things up so that the printing only occurrs if TEST is defined. If TEST is not defined, then TEST_PSO becomes nothing (IE, it is removed by the pre-processor). TEST_PSO is used as follows:
    TEST_PSO(( <format>, arg1, arg2, ....)); // Note DOUBLE parens!

MACROS TEST_PSO

NOTE

More often than not, one is better off instead using test_pse() via the macro TEST_PSE().

RELATED

pse, 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_debug_level , kjb_get_debug_level , hex_print , test_pse