Home Download Musics Developers
API Sources Tools File Format Technicals

Error message stack
[emu68 library documentation.]


Detailed Description

EMU68 error handling consists on a fixed size stack of messages.

When an EMU68 function fails, it stores a description message for the error and returns a negative number. If error stack is full, the older stacked message is removed.


Files

file  emu68/error68.h
 Error message header.


Functions

int EMU68error_add (char *format,...)
 Push formatted error message.

const char * EMU68error_get (void)
 Pop last error message.


Function Documentation

int EMU68error_add char *  format,
... 
 

Push formatted error message.

The EMU68error_add() format error message and push it in error stack. On overflow the older message is lost.

Parameters:
format printf() like format string.
Returns:
error-code
Return values:
0xDEAD0xxx,where xxx is a random value

const char* EMU68error_get void   ) 
 

Pop last error message.

Retrieve and remove last error message from error stack.

Returns:
Last pushed error message.
Return values:
0 Empty message stack, no more message.