uUnit.h

Go to the documentation of this file.

/* uUnit.h (C) 2011 adolfo@di-mare.com */
 
/** \file   uUnit.h
    \brief  [u]Micro module for [Unit] program testing.
 
    \author Adolfo Di Mare <adolfo@di-mare.com>
    \date   2011,2019
    \see    http://www.di-mare.com/adolfo/p/BUnitXP.htm
 
\code
    #include "uUnit.h" // assertTrue() && assertFalse()
 
    // Example
    int main( int argc , const char* argv[] ) {
        std::cout << "TestCase [uUnit.h] yesYES" << std::endl;
        assertTrue(  1==2 ); // ok?
        assertFalse( 1==2 ); // ok!
        return test_myImp(argc , argv);
    }
\endcode
*/
 
#ifndef ADOLFO_UUNIT
#define ADOLFO_UUNIT
 
/* #include "BUnit.h" // http://www.di-mare.com/adolfo/p/BUnit.htm    */
/* #include "BUnit.h" // http://www.di-mare.com/adolfo/p/BUnitXP.htm  */
 
/* inline [C++] && static [C] trick
 * -> TRICK to avoid using a uUnit.cpp implementation file
 * -> TRICK to avoid "function already defined" linkage error   */
 
#ifdef __cplusplus
    /** "C:/DIR/SubDir/file_name.ext" ==> "file_name.ext" */
    template <class T>
    const T* remove_dir_name( const T* str );
    /** "C:/DIR/SubDir/file_name.ext" ==> "file_name.ext" */
    template <>
    const char* remove_dir_name<char>( const char* str )
#else
    /** "C:/DIR/SubDir/file_name.ext" ==> "file_name.ext" */
    static /* "static" avoids "function already defined" linkage error */
    const char* remove_dir_name( const char* str )
 
    /*  Only for C [not C++]
        In C, each object file will contain a local compiled copy of this
        function because it is declared 'static'.
        - This duplication is the price paid to avoid using a uUnit.cpp file.
    */
#endif /* __cplusplus */
{
    const char *p = str;     /* p = str+strlen(str); */
    while ( *p != 0 ) { ++p; }
    while ( *p != '/' && *p != '\\' && *p != ':' ) {
        if ( p == str ) { return str; }
        --p;
    }
    return p+1;
}
 
#ifdef __cplusplus
    #include <iostream> /* std::cout */
    template <class T> inline /* inline avoids 'multiple definition' warning */
    void uUnit_testThis( bool cond, const T* label, const T* fname, long lineno );
    template <> inline
    void uUnit_testThis<char>(
        bool cond, const char* label, const char* fname, long lineno
    ) {
        if (!cond) {
            std::cout << "=\\_fail: " << label << " \n=/ (";
            std::cout << lineno << ") " << remove_dir_name(fname) << "\n";
        }
    }
#else
    #include <stdio.h>  /* printf() */
    static
    void uUnit_testThis(
        int cond, const char* label, const char* fname, long lineno
    ) {
        if (!cond) {
            printf( "%s%s%s",   "=\\_fail: " , label , " \n=/ (" );
            printf( "%ld%s%s%s", lineno , ") " , remove_dir_name(fname),"\n" );
        }
    }
#endif
 
 
#ifdef NDEBUG
    #define assertTrue(x)   ((void)0)
    #define assertFalse(x)  ((void)0)
#else /* debugging enabled */
    /** (cond ? () : cout << "cond" ) */
    #define assertTrue(cond)  uUnit_testThis(!!(cond),     #cond,     __FILE__,__LINE__ )
    /** (!(cond) ? () : cout << "!" << (cond)" ) */
    #define assertFalse(cond) uUnit_testThis( !(cond),"!(" #cond ")", __FILE__,__LINE__ )
#endif
 
#endif
 
/* EOF: uUnit.h */