| /*===========================================================================* |
| * Purpose : Function definitions for the TIO_PrintHandler class external |
| * 'C' interface. |
| * |
| * - PrintHandlerNew |
| * - PrintHandlerDelete |
| * - PrintHandlerInit |
| * - PrintHandlerExists |
| * - PrintHandlerFilter |
| * - PrintHandlerMessage |
| * - PrintHandlerInfo |
| * - PrintHandlerWarning |
| * - PrintHandlerError |
| * - PrintHandlerTrace |
| * - PrintHandlerDirect |
| * |
| *===========================================================================*/ |
| |
| //---------------------------------------------------------------------------// |
| // Copyright (C) 2012-2013 Jeff Rudolph, Texas Instruments (jrudolph@ti.com) // |
| // // |
| // Permission is hereby granted, free of charge, to any person obtaining a // |
| // copy of this software and associated documentation files (the "Software"),// |
| // to deal in the Software without restriction, including without limitation // |
| // the rights to use, copy, modify, merge, publish, distribute, sublicense, // |
| // and/or sell copies of the Software, and to permit persons to whom the // |
| // Software is furnished to do so, subject to the following conditions: // |
| // // |
| // The above copyright notice and this permission notice shall be included // |
| // in all copies or substantial portions of the Software. // |
| // // |
| // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // |
| // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF // |
| // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN // |
| // NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, // |
| // DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR // |
| // OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE // |
| // USE OR OTHER DEALINGS IN THE SOFTWARE. // |
| //---------------------------------------------------------------------------// |
| |
| #include <cstdarg> |
| using namespace std; |
| |
| #include "TIO_SkinHandler.h" |
| #include "TIO_PrintHandler.h" |
| #include "TIO_PrintHandlerExtern.h" |
| |
| /*===========================================================================* |
| * Function : PrintHandlerNew |
| * Purpose : Provides an external C interface to the TIO_PrintHandler. |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 07/02/12 jeffr : Original |
| *===========================================================================*/ |
| extern "C" void PrintHandlerNew( |
| const char* pszLogFileName ) |
| { |
| /* Allocate a skin handler 'singleton' for program message handling */ |
| TIO_SkinHandler_c& skinHandler = TIO_SkinHandler_c::GetInstance( ); |
| skinHandler.Set( TIO_SkinHandler_c::TIO_SKIN_VPR ); |
| |
| /* Allocate a print handler 'singleton' for program message handling */ |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( ); |
| printHandler.SetStdioOutput( stdout ); |
| |
| /* Display optional print handler program banner */ |
| |
| /* jluu removed optional program banner */ |
| /* printHandler.WriteBanner( ); */ |
| |
| /* Apply optional print handler file logging and include program banner */ |
| if( pszLogFileName ) |
| { |
| printHandler.SetLogFileOutput( pszLogFileName ); |
| |
| printHandler.DisableOutput( TIO_PRINT_OUTPUT_STDIO | TIO_PRINT_OUTPUT_CUSTOM ); |
| printHandler.WriteBanner( ); |
| printHandler.EnableOutput( TIO_PRINT_OUTPUT_STDIO | TIO_PRINT_OUTPUT_CUSTOM ); |
| } |
| } |
| |
| /*===========================================================================* |
| * Function : PrintHandlerDelete |
| * Purpose : Provides an external C interface to the TIO_PrintHandler. |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 07/02/12 jeffr : Original |
| *===========================================================================*/ |
| extern "C" void PrintHandlerDelete( void ) |
| { |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( ); |
| printHandler.DeleteInstance( ); |
| |
| TIO_SkinHandler_c& skinHandler = TIO_SkinHandler_c::GetInstance( ); |
| skinHandler.DeleteInstance( ); |
| } |
| |
| /*===========================================================================* |
| * Function : PrintHandlerInit |
| * Purpose : Provides an external C interface to the TIO_PrintHandler. |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 07/02/12 jeffr : Original |
| * 06/19/13 jeffr : Added support for "enableFileLines" parameter |
| *===========================================================================*/ |
| extern "C" void PrintHandlerInit( |
| unsigned char enableTimeStamps, |
| unsigned char enableFileLines, |
| unsigned long maxWarningCount, |
| unsigned long maxErrorCount ) |
| { |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( ); |
| |
| /* Enable optional print handler message time stamps */ |
| printHandler.SetTimeStampsEnabled( static_cast< bool >( enableTimeStamps == (unsigned char) 0 )); |
| |
| /* Enable optional print handler message file lines */ |
| printHandler.SetFileLinesEnabled( static_cast< bool >( enableFileLines == (unsigned char) 0 )); |
| |
| /* Define optional print handler max warning/error counts */ |
| printHandler.SetMaxWarningCount( maxWarningCount ); |
| printHandler.SetMaxErrorCount( maxErrorCount ); |
| } |
| |
| /*===========================================================================* |
| * Function : PrintHandlerExists |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 08/15/12 jeffr : Original |
| *===========================================================================*/ |
| extern "C" int PrintHandlerExists( |
| void ) |
| { |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( false ); |
| return( printHandler.HasInstance( ) ? true : false ); |
| } |
| |
| /*===========================================================================* |
| * Function : PrintHandlerFilter |
| * Purpose : Provides an external C interface to the TIO_PrintHandler. |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 07/02/12 jeffr : Original |
| *===========================================================================*/ |
| extern "C" void PrintHandlerFilter( |
| TIO_MessageMode_t messageMode, |
| TIO_FilterMode_t filterMode, |
| const char* pszFilter ) |
| { |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( ); |
| |
| switch( messageMode ) |
| { |
| case TIO_MESSAGE_INFO: |
| switch( filterMode ) |
| { |
| case TIO_FILTER_ACCEPT: |
| printHandler.AddInfoAcceptRegExp( pszFilter ); |
| break; |
| case TIO_FILTER_REJECT: |
| printHandler.AddInfoRejectRegExp( pszFilter ); |
| break; |
| case TIO_FILTER_UNDEFINED: |
| break; |
| } |
| break; |
| case TIO_MESSAGE_WARNING: |
| switch( filterMode ) |
| { |
| case TIO_FILTER_ACCEPT: |
| printHandler.AddWarningAcceptRegExp( pszFilter ); |
| break; |
| case TIO_FILTER_REJECT: |
| printHandler.AddWarningRejectRegExp( pszFilter ); |
| break; |
| case TIO_FILTER_UNDEFINED: |
| break; |
| } |
| break; |
| case TIO_MESSAGE_ERROR: |
| switch( filterMode ) |
| { |
| case TIO_FILTER_ACCEPT: |
| printHandler.AddErrorAcceptRegExp( pszFilter ); |
| break; |
| case TIO_FILTER_REJECT: |
| printHandler.AddErrorRejectRegExp( pszFilter ); |
| break; |
| case TIO_FILTER_UNDEFINED: |
| break; |
| } |
| break; |
| case TIO_MESSAGE_TRACE: |
| switch( filterMode ) |
| { |
| case TIO_FILTER_ACCEPT: |
| printHandler.AddTraceAcceptRegExp( pszFilter ); |
| break; |
| case TIO_FILTER_REJECT: |
| printHandler.AddTraceRejectRegExp( pszFilter ); |
| break; |
| case TIO_FILTER_UNDEFINED: |
| break; |
| } |
| break; |
| case TIO_MESSAGE_DIRECT: |
| case TIO_MESSAGE_UNDEFINED: |
| break; |
| } |
| } |
| |
| /*===========================================================================* |
| * Function : PrintHandlerMessage |
| * Purpose : Provides an external C interface to the TIO_PrintHandler. |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 07/02/12 jeffr : Original |
| *===========================================================================*/ |
| extern "C" unsigned char PrintHandlerMessage( |
| TIO_MessageMode_t messageMode, |
| const char* pszMessage, |
| ... ) |
| { |
| va_list vaArgs; /* Make a variable argument list */ |
| va_start( vaArgs, pszMessage ); /* Initialize variable argument list */ |
| |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( ); |
| |
| unsigned char ok = true; |
| switch( messageMode ) |
| { |
| case TIO_MESSAGE_INFO: |
| printHandler.Info( TIO_PRINT_INFO, pszMessage, vaArgs ); |
| break; |
| case TIO_MESSAGE_WARNING: |
| ok = printHandler.Warning( TIO_PRINT_WARNING, pszMessage, vaArgs ); |
| break; |
| case TIO_MESSAGE_ERROR: |
| ok = printHandler.Error( TIO_PRINT_ERROR, pszMessage, vaArgs ); |
| break; |
| case TIO_MESSAGE_TRACE: |
| printHandler.Trace( TIO_PRINT_TRACE, pszMessage, vaArgs ); |
| break; |
| case TIO_MESSAGE_DIRECT: |
| printHandler.Direct( TIO_PRINT_DIRECT, pszMessage, vaArgs ); |
| break; |
| case TIO_MESSAGE_UNDEFINED: |
| break; |
| } |
| va_end( vaArgs ); /* Reset variable argument list */ |
| |
| return( ok ); |
| } |
| |
| /*===========================================================================* |
| * Function : PrintHandlerInfo |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 06/18/13 jeffr : Original |
| *===========================================================================*/ |
| extern "C" void PrintHandlerInfo( |
| const char* pszMessage, |
| ... ) |
| { |
| va_list vaArgs; /* Make a variable argument list */ |
| va_start( vaArgs, pszMessage ); /* Initialize variable argument list */ |
| |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( ); |
| printHandler.Info( TIO_PRINT_INFO, pszMessage, vaArgs ); |
| |
| va_end( vaArgs ); /* Reset variable argument list */ |
| } |
| |
| /*===========================================================================* |
| * Function : PrintHandlerWarning |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 06/18/13 jeffr : Original |
| *===========================================================================*/ |
| extern "C" unsigned char PrintHandlerWarning( |
| const char* pszFileName, |
| unsigned int lineNum, |
| const char* pszMessage, |
| ... ) |
| { |
| va_list vaArgs; /* Make a variable argument list */ |
| va_start( vaArgs, pszMessage ); /* Initialize variable argument list */ |
| |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( ); |
| unsigned char ok = printHandler.Warning( TIO_PRINT_WARNING, |
| pszFileName, lineNum, |
| pszMessage, vaArgs ); |
| |
| va_end( vaArgs ); /* Reset variable argument list */ |
| |
| return( ok ); |
| } |
| |
| /*===========================================================================* |
| * Function : PrintHandlerError |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 06/18/13 jeffr : Original |
| *===========================================================================*/ |
| extern "C" unsigned char PrintHandlerError( |
| const char* pszFileName, |
| unsigned int lineNum, |
| const char* pszMessage, |
| ... ) |
| { |
| va_list vaArgs; /* Make a variable argument list */ |
| va_start( vaArgs, pszMessage ); /* Initialize variable argument list */ |
| |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( ); |
| unsigned char ok = printHandler.Error( TIO_PRINT_ERROR, |
| pszFileName, lineNum, |
| pszMessage, vaArgs ); |
| |
| va_end( vaArgs ); /* Reset variable argument list */ |
| |
| return( ok ); |
| } |
| |
| /*===========================================================================* |
| * Function : PrintHandlerTrace |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 06/18/13 jeffr : Original |
| *===========================================================================*/ |
| extern "C" void PrintHandlerTrace( |
| const char* pszMessage, |
| ... ) |
| { |
| va_list vaArgs; /* Make a variable argument list */ |
| va_start( vaArgs, pszMessage ); /* Initialize variable argument list */ |
| |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( ); |
| printHandler.Trace( TIO_PRINT_TRACE, pszMessage, vaArgs ); |
| |
| va_end( vaArgs ); /* Reset variable argument list */ |
| } |
| |
| /*===========================================================================* |
| * Function : PrintHandlerDirect |
| * Author : Jeff Rudolph |
| *---------------------------------------------------------------------------* |
| * Version history |
| * 06/18/13 jeffr : Original |
| *===========================================================================*/ |
| extern "C" void PrintHandlerDirect( |
| const char* pszMessage, |
| ... ) |
| { |
| va_list vaArgs; /* Make a variable argument list */ |
| va_start( vaArgs, pszMessage ); /* Initialize variable argument list */ |
| |
| TIO_PrintHandler_c& printHandler = TIO_PrintHandler_c::GetInstance( ); |
| printHandler.Direct( TIO_PRINT_DIRECT, pszMessage, vaArgs ); |
| |
| va_end( vaArgs ); /* Reset variable argument list */ |
| } |