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.


file  emu68/error68.h
 Error message header.


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.

format printf() like format string.
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.

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