NAME

dbs - (MACRO) Debug printing of a string

SYNOPSIS

#include "l/l_sys_debug.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 


void dbs(char *str);

DESCRIPTION

This macro prints a string, along with the variable name, file, and line number, on standard error. The string is delimited by -> and <-. Its behaviour is a function of the debugging level, which can be set through the option "debug" if the KJB library options are being made available to the user. The macro is available for both development and production code, but since the default debug level is different in the two cases, the behaviour is different. The default level for development code is 2, whereas for production code it is 0. If the debug level is 2 (or more), then the output is printed to standard error using regular KJB library output routines. If the debug level is 1, then the output is printed to standard error using standard C library routines instead of regular KJB library routines. This facility is provided for KJB library I/O routines themselves. If the debug level is 0 (default for production code), then the output is disabled.

NOTE

This macro can be called with a buffer (array of char) as an argument, but "dbb" is preferred in that case.

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

dbw , dbr , dbp , dbx , dbo , dbi , dbj , dbu , dbf , dbe , dbc , dbnc , dbb , dbm , db_irv , db_icv , file_db_icv , dbi_mat , file_dbi_mat , dbw_no_kjb , dbr_no_kjb , dbp_no_kjb , dbx_no_kjb , dbo_no_kjb , dbi_no_kjb , dbf_no_kjb , dbe_no_kjb , dbc_no_kjb , dbnc_no_kjb , dbs_no_kjb , dbm_no_kjb , ASSERT , ASSERT_IS_BOOL , ASSERT_IS_EQUAL_INT , ASSERT_IS_NON_NEGATIVE_INT , ASSERT_IS_POSITIVE_INT , ASSERT_IS_NOT_EQUAL_INT , ASSERT_IS_GREATER_INT , ASSERT_IS_LESS_INT , ASSERT , ASSERT , ASSERT_IS_NUMBER_DBL , ASSERT_IS_FINITE_DBL , ASSERT_IS_NON_NEGATIVE_DBL , ASSERT_IS_ZERO_DBL , ASSERT_IS_NOT_ZERO_DBL , ASSERT_IS_POSITIVE_DBL , ASSERT_IS_PROB_DBL , ASSERT_IS_EQUAL_DBL , ASSERT , ASSERT , ASSERT_IS_GREATER_DBL , ASSERT_IS_LESS_DBL , ASSERT_IS_NOT_GREATER_DBL , ASSERT_IS_NOT_LESS_DBL