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 ()

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