MSG_testUtility.c File Reference

Various test printing utilities. More...

#include <stdio.h>
#include <string.h>
#include <MSG_tstdefs.h>

Defines
#define	POINTER_FORMAT   "%s:0x%08x %s 0x%08x %s"
#define	POINTER_LENGTH   (49)
Functions
unsigned int	MSG_action (const char *txt)
	Announce an action.
unsigned int	MSG_announceMajor (const char *txt)
	Major test announcement.
unsigned int	MSG_announceMajorEnd (const char *txt, unsigned int ret)
	Major test end announcement.
unsigned int	MSG_announceMinor (const char *txt)
	Minor test announcement.
unsigned int	MSG_announceMinorEnd (const char *txt, unsigned int ret)
	Minor test end announcement.
unsigned int	MSG_testInt (const char *txt, unsigned int val, unsigned int op, unsigned int lim)
	Test an integer value.
unsigned int	MSG_testPtr (const char *txt, void *val, unsigned int op, void *lim)
	Test a pointer (32 or 64 bit).
unsigned int	MSG_testStr (const char *txt, const char *val, unsigned int op, const char *lim)
	Test an integer value.
Variables
static const char *	s_equal = "======================================="
	A rule of equal signs.
static const char *	s_fail = "fail"
	The string "fail".
static const char *	s_iop [7] = { "??", "< ", "<=", "==", ">=", "> ", "!=" }
	Strings corresponding to integer comparison operators.
static const char *	s_minus = "---------------------------------------"
	A string of minus signs.
static const char *	s_pass = "pass"
	The string "pass".
static const char *	s_sop [4] = { "???", "=v=", "=l=", "-->" }
	Strings corresponding to string comparison operators.
static const char *	s_star = "***************************************"
	A rule of stars.
static const char *	s_what = "????"
	The string "????".

---

Detailed Description

Various test printing utilities.

CVS $Id: MSG_testUtility.c,v 1.3 2011/03/25 01:05:53 apw Exp $

Author:

A.P.Waite

---

Function Documentation

unsigned int MSG_action

(

const char *

txt

)

Announce an action.

Parameters:

txt

Text string embedded in test dump

Referenced by MSG_testNoTask(), MSG_testOptions(), MSG_testThread(), testBuffer_task(), testBufferMsg_cb(), testFormat_cb(), testFormat_task(), testInitialized(), testOddballs(), testStarted(), and testUninitialized().

unsigned int MSG_announceMajor

(

const char *

txt

)

Major test announcement.

Parameters:

txt

Text string embedded in test dump

Referenced by MSG_testNoTask(), MSG_testOptions(), MSG_testState(), MSG_testThread(), testBuffer_task(), and testFormat_task().

unsigned int MSG_announceMajorEnd	(	const char *	txt,
		unsigned int	ret
	)

Major test end announcement.

Parameters:

	txt	Text string embedded in test dump
	ret	Pass/fail

Referenced by MSG_testNoTask(), MSG_testOptions(), MSG_testState(), testBuffer_task(), and testFormat_task().

unsigned int MSG_announceMinor

(

const char *

txt

)

Minor test announcement.

Parameters:

txt

Text string embedded in test dump

Referenced by MSG_testNoTask(), MSG_testOptions(), testBuffer_task(), testFormat(), testFormat_task(), testInitialized(), testStarted(), and testUninitialized().

unsigned int MSG_announceMinorEnd	(	const char *	txt,
		unsigned int	ret
	)

Minor test end announcement.

Parameters:

	txt	Text string embedded in test dump
	ret	Pass/fail

Referenced by MSG_testOptions(), testBuffer_task(), testFormat_task(), testInitialized(), testStarted(), and testUninitialized().

unsigned int MSG_testInt	(	const char *	txt,
		unsigned int	val,
		unsigned int	op,
		unsigned int	lim
	)

Test an integer value.

Parameters:

	txt	Text string embedded in test dump
	val	The value to test
	op	The operation
	lim	The value to test against

References _EQ, _GE, _GT, _LE, _LT, _NE, and _ZZ.

Referenced by MSG_testNoTask(), MSG_testOptions(), MSG_testThread(), testBuffer_task(), testFormat_task(), testInitialized(), testStarted(), and testUninitialized().

unsigned int MSG_testPtr	(	const char *	txt,
		void *	val,
		unsigned int	op,
		void *	lim
	)

Test a pointer (32 or 64 bit).

Parameters:

	txt	Text string embedded in test dump
	val	The value to test
	op	The operation
	lim	The value to test against

References _EQ, _GE, _GT, _LE, _LT, _NE, and _ZZ.

Referenced by testInitialized(), testStarted(), and testUninitialized().

unsigned int MSG_testStr	(	const char *	txt,
		const char *	val,
		unsigned int	op,
		const char *	lim
	)

Test an integer value.

Parameters:

	txt	Text string embedded in test dump
	val	The string to test
	op	The operation
	lim	The string to test against

References _SLE, _SRV, _SVE, and _ZZ.

Referenced by MSG_testNoTask(), and testFormat_cb().