API Error Functions

Handeling of OpenVSP ErrorObj information is accomplished through this group of API functions.

Click here to return to the main page. More...

Functions
bool	GetErrorLastCallFlag ()
int	GetNumTotalErrors ()
ErrorObj	PopLastError ()
ErrorObj	GetLastError ()
void	SilenceErrors ()
void	PrintOnErrors ()

Detailed Description

Function Documentation

GetErrorLastCallFlag()

bool GetErrorLastCallFlag

(

)

Check if there was an error on the last call to the API

//==== Bogus Call To Create API Error ====//
Print( string( "---> Test Error Handling" ) );
 
SetParmVal( "BogusParmID", 23.0 );
 
if ( !GetErrorLastCallFlag() )                        { Print( "---> Error: API GetErrorLastCallFlag " ); }

Returns

False if no error, true otherwise

GetLastError()

ErrorObj GetLastError

(

)

Return the most recent error from the stack (does NOT pop error off the stack)

//==== Check For API Errors ====//
ErrorObj err = GetLastError();
 
Print( err.GetErrorString() );

Returns

Error object

GetNumTotalErrors()

int GetNumTotalErrors

(

)

Count the total number of errors on the stack

//==== Check For API Errors ====//
while ( GetNumTotalErrors() > 0 )
{
    ErrorObj err = PopLastError();
    Print( err.GetErrorString() );
}

Returns

Number of errors

PopLastError()

ErrorObj PopLastError

(

)

Pop (remove) and return the most recent error from the stack

//==== Check For API Errors ====//
while ( GetNumTotalErrors() > 0 )
{
    ErrorObj err = PopLastError();
    Print( err.GetErrorString() );
}

Returns

Error object

PrintOnErrors()

void PrintOnErrors

(

)

Cuase errors to be printed to stdout as they occur.

//==== Tell API to print error messages ====//
PrintOnErrors();

SilenceErrors()

void SilenceErrors

(

)

Prevent errors from printing to stdout as they occur.

//==== Force API to silence error messages ====//
SilenceErrors();