<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Unit Testing API</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK REL="PREVIOUS" TITLE="File Map" HREF="x4848.html"><LINK REL="NEXT" TITLE="C++ Unit Testing API" HREF="x4948.html"></HEAD ><BODY CLASS="CHAPTER" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >DejaGnu: The GNU Testing Framework</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="x4848.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="x4948.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="CHAPTER" ><H1 ><A NAME="UNITTESTAPI" ></A >Unit Testing API</H1 ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="CUNIT" ></A >C Unit Testing API</H1 ><P >All of the functions that take a <TT CLASS="PARAMETER" ><I >msg</I ></TT > parameter use a C char * that is the message to be dislayed. There currently is no support for variable length arguments.</P ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="PASSFUNC" ></A >Pass Function</H2 ><P >This prints a message for a successful test completion.</P ><DIV CLASS="FUNCSYNOPSIS" ><A NAME="AEN4911" ></A ><P ></P ><CODE CLASS="FUNCDEF" ><TT CLASS="FUNCTION" >pass</TT ></CODE >(<TT CLASS="PARAMETER" ><I >msg</I ></TT >);<P ></P ></DIV ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="FAILFUNC" ></A >Fail Function</H2 ><P >This prints a message for an unsuccessful test completion.</P ><DIV CLASS="FUNCSYNOPSIS" ><A NAME="AEN4919" ></A ><P ></P ><CODE CLASS="FUNCDEF" ><TT CLASS="FUNCTION" >fail</TT ></CODE >(<TT CLASS="PARAMETER" ><I >msg</I ></TT >);<P ></P ></DIV ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="UNTESTEDFUNC" ></A >Untested Function</H2 ><P >This prints a message for an test case that isn't run for some technical reason.</P ><DIV CLASS="FUNCSYNOPSIS" ><A NAME="AEN4927" ></A ><P ></P ><CODE CLASS="FUNCDEF" ><TT CLASS="FUNCTION" >untested</TT ></CODE >(<TT CLASS="PARAMETER" ><I >msg</I ></TT >);<P ></P ></DIV ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="UNRESOLVEDFUNC" ></A >Unresolved Function</H2 ><P >This prints a message for an test case that is run, but there is no clear result. These output states require a human to look over the results to determine what happened. </P ><DIV CLASS="FUNCSYNOPSIS" ><A NAME="AEN4935" ></A ><P ></P ><CODE CLASS="FUNCDEF" ><TT CLASS="FUNCTION" >unresolved</TT ></CODE >(<TT CLASS="PARAMETER" ><I >msg</I ></TT >);<P ></P ></DIV ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="TOTALSFUNC" ></A >Totals Function</H2 ><P >This prints out the total numbers of all the test state outputs.</P ><DIV CLASS="FUNCSYNOPSIS" ><A NAME="AEN4943" ></A ><P ></P ><CODE CLASS="FUNCDEF" ><TT CLASS="FUNCTION" >totals</TT ></CODE >(<TT CLASS="PARAMETER" ><I ></I ></TT >);<P ></P ></DIV ></DIV ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="x4848.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="book1.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="x4948.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >File Map</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" > </TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >C++ Unit Testing API</TD ></TR ></TABLE ></DIV ></BODY ></HTML >