|
|
Modules | |
| Examples | |
Error handling examples
| |
Functions | |
| int | gx_geterror (int *code, wchar_t *string, int maxlen) |
| You can query the error code and string with this function (Unicode version). | |
| int | gx_geterrora (int *code, char *string, int maxlen) |
| You can query the error code and string with this function (ASCII version). | |
| int | gx_geterror (int *code, char *string=(char *) 0, int maxlen=0) |
| Usable in C++. | |
| int | gx_geterrorcode (void) |
| You can query the error code with this function. | |
| int | gx_geterror (void) |
| Usable in C++. | |
| int | gx_seterrorfv (int flags, int code, const wchar_t *wformat, va_list args) |
| Updates a thread-local error buffer (Unicode version). | |
| int | gx_seterrorv (int flags, int code, const wchar_t *wformat, va_list args) |
| Usable in C++. | |
| int | gx_seterrorafv (int flags, int code, const char *wformat, va_list args) |
| Updates a thread-local error buffer (ASCII version). | |
| int | gx_seterrorv (int flags, int code, const char *wformat, va_list args) |
| Usable in C++. | |
| int | gx_seterrorv (int code, const wchar_t *wformat, va_list args) |
| Clears and updates a thread-local error buffer (Unicode version). | |
| int | gx_seterrorav (int code, const char *wformat, va_list args) |
| Clears and updates a thread-local error buffer (ASCII version). | |
| int | gx_seterrorv (int code, const char *wformat, va_list args) |
| Usable in C++. | |
| int | gx_appenderrorv (int code, const wchar_t *wformat, va_list args) |
| Appends a thread-local error buffer (Unicode version). | |
| int | gx_appenderrorav (int code, const char *wformat, va_list args) |
| Appends a thread-local error buffer (ASCII version). | |
| int | gx_appenderrorv (int code, const char *wformat, va_list args) |
| Usable in C++. | |
| int | gx_prependerrorv (int code, const wchar_t *wformat, va_list args) |
| Prepends a thread-local error buffer (Unicode version). | |
| int | gx_prependerrorav (int code, const char *wformat, va_list args) |
| Prepends a thread-local error buffer (ASCII version). | |
| int | gx_prependerrorv (int code, const char *wformat, va_list args) |
| Usable in C++. | |
| int | gx_seterrorf (int flags, int code, const wchar_t *wformat,...) |
| Updates a thread-local error buffer with variable number of arguments (. | |
| int | gx_seterror (int flags, int code, const wchar_t *wformat=(const wchar_t *) 0,...) |
| Usable in C++. | |
| int | gx_seterroraf (int flags, int code, const char *wformat,...) |
| Updates a thread-local error buffer with variable number of arguments (. | |
| int | gx_seterror (int flags, int code, const char *wformat=(const char *) 0,...) |
| Usable in C++. | |
| int | gx_clearerror (void) |
| Clears a thread-local error buffer. | |
| int | gx_seterrorcodef (int flags, int code) |
| Updates a thread-local error buffer with flags and error code. | |
| int | gx_seterrorcode (int code) |
| Updates a thread-local error buffer with error code. | |
| int | gx_appenderrorcode (int code) |
| Appends a thread-local error buffer with error code. | |
| int | gx_prependerrorcode (int code) |
| Prepends a thread-local error buffer with error code. | |
| int | gx_seterror (int code, const wchar_t *wformat,...) |
| Clears and updates a thread-local error buffer (Unicode version). | |
| int | gx_seterror (int code) |
| Usable in C++. | |
| int | gx_seterrora (int code, const char *wformat,...) |
| Clears and updates a thread-local error buffer (ASCII version). | |
| int | gx_seterror (int code, const char *wformat,...) |
| Usable in C++. | |
| int | gx_appenderror (int code, const wchar_t *wformat,...) |
| Appends a thread-local error buffer (Unicode version). | |
| int | gx_appenderror (int code) |
| Usable in C++. | |
| int | gx_appenderrora (int code, const char *wformat,...) |
| Appends a thread-local error buffer (ASCII version). | |
| int | gx_appenderror (int code, const char *wformat,...) |
| Usable in C++. | |
| int | gx_prependerror (int code, const wchar_t *wformat,...) |
| Prepends a thread-local error buffer (Unicode version). | |
| int | gx_prependerror (int code) |
| Usable in C++. | |
| int | gx_prependerrora (int code, const char *wformat,...) |
| Prepends a thread-local error buffer (ASCII version). | |
| int | gx_prependerror (int code, const char *wformat,...) |
| Usable in C++. | |
| int | gx_updateerrtable (int nitems, const gxERRITEM *items) |
| Updates the error table in the memory. | |
| int | gx_pusherror (void) |
| Pushes the error code and string to the error stack. | |
| int | gx_poperror (void) |
| Pops the error code and string from the error stack. | |
| int gx_geterror | ( | int * | code, | |
| wchar_t * | string, | |||
| int | maxlen | |||
| ) | [inline] |
You can query the error code and string with this function (Unicode version).
| code | The function will update it with the error code (Can be NULL). | |
| string | Memory pointer where the function writes the descriptive text of the error. Can be NULL, in that case there is no description. | |
| maxlen | Length of the memory area in characters (not bytes). |
References gx_call().
Referenced by gxSystem::GetError(), gxException::GetError(), gxSystem::GetErrorString(), and gxException::GetErrorString().
| int gx_geterrora | ( | int * | code, | |
| char * | string, | |||
| int | maxlen | |||
| ) | [inline] |
You can query the error code and string with this function (ASCII version).
| code | The function will update it with the error code (Can be NULL). | |
| string | Memory pointer where the function writes the descriptive text of the error. Can be NULL, in that case there is no description. | |
| maxlen | Length of the memory area in characters (not bytes). |
References gx_call().
Referenced by gxSystem::GetError(), gxException::GetError(), gxSystem::GetErrorStringA(), gxException::GetErrorStringA(), and gx_geterror().
| int gx_geterror | ( | int * | code, | |
| char * | string = (char *)0, |
|||
| int | maxlen = 0 | |||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_geterrora.
| code | The function will update it with the error code (Can be NULL). | |
| string | Memory pointer where the function writes the descriptive text of the error. Can be NULL, in that case there is no description. | |
| maxlen | Length of the memory area in characters (not bytes). |
References gx_geterrora().
| int gx_geterrorcode | ( | void | ) | [inline] |
You can query the error code with this function.
References gx_call().
Referenced by gxSystem::GetErrorCode(), gxException::GetErrorCode(), and gx_geterror().
| int gx_geterror | ( | void | ) | [inline] |
Usable in C++.
It is the same function as the gx_geterrorcode().
References gx_geterrorcode().
| int gx_seterrorfv | ( | int | flags, | |
| int | code, | |||
| const wchar_t * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Updates a thread-local error buffer (Unicode version).
| flags | Clear/Insert/Append mode ( see GX_ERR_FLAG_CLEAR, GX_ERR_FLAG_APPEND, GX_ERR_FLAG_PREPEND, GX_ERR_FLAG_APPMODE, GX_ERR_FLAG_LOCAL ) | |
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_call().
Referenced by gx_appenderrorv(), gx_prependerrorv(), gx_seterror(), gx_seterrorf(), gx_seterrorv(), and gxSystem::SetErrorv().
| int gx_seterrorv | ( | int | flags, | |
| int | code, | |||
| const wchar_t * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_seterrorfv().
| flags | Clear/Insert/Append mode ( see GX_ERR_FLAG_CLEAR, GX_ERR_FLAG_APPEND, GX_ERR_FLAG_PREPEND, GX_ERR_FLAG_APPMODE, GX_ERR_FLAG_LOCAL ) | |
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorfv().
Referenced by gx_seterror().
| int gx_seterrorafv | ( | int | flags, | |
| int | code, | |||
| const char * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Updates a thread-local error buffer (ASCII version).
| flags | Clear/Insert/Append mode ( see GX_ERR_FLAG_CLEAR, GX_ERR_FLAG_APPEND, GX_ERR_FLAG_PREPEND, GX_ERR_FLAG_APPMODE, GX_ERR_FLAG_LOCAL ) | |
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_call().
Referenced by gx_appenderrorav(), gx_appenderrorv(), gx_prependerrorav(), gx_prependerrorv(), gx_seterror(), gx_seterroraf(), gx_seterrorav(), gx_seterrorv(), and gxSystem::SetErrorv().
| int gx_seterrorv | ( | int | flags, | |
| int | code, | |||
| const char * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_seterrorafv().
| flags | Clear/Insert/Append mode ( see GX_ERR_FLAG_CLEAR, GX_ERR_FLAG_APPEND, GX_ERR_FLAG_PREPEND, GX_ERR_FLAG_APPMODE, GX_ERR_FLAG_LOCAL ) | |
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorafv().
| int gx_seterrorv | ( | int | code, | |
| const wchar_t * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Clears and updates a thread-local error buffer (Unicode version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorfv().
| int gx_seterrorav | ( | int | code, | |
| const char * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Clears and updates a thread-local error buffer (ASCII version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorafv().
Referenced by gx_seterror(), and gx_seterrora().
| int gx_seterrorv | ( | int | code, | |
| const char * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_seterrorav().
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorafv().
| int gx_appenderrorv | ( | int | code, | |
| const wchar_t * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Appends a thread-local error buffer (Unicode version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorfv().
Referenced by gx_appenderror().
| int gx_appenderrorav | ( | int | code, | |
| const char * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Appends a thread-local error buffer (ASCII version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorafv().
Referenced by gx_appenderror(), and gx_appenderrora().
| int gx_appenderrorv | ( | int | code, | |
| const char * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_appenderrorav().
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorafv().
| int gx_prependerrorv | ( | int | code, | |
| const wchar_t * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Prepends a thread-local error buffer (Unicode version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorfv().
Referenced by gx_prependerror().
| int gx_prependerrorav | ( | int | code, | |
| const char * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Prepends a thread-local error buffer (ASCII version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorafv().
Referenced by gx_prependerrora().
| int gx_prependerrorv | ( | int | code, | |
| const char * | wformat, | |||
| va_list | args | |||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_prependerrorav().
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| args | Arguments for format strings. |
References gx_seterrorafv().
| int gx_seterrorf | ( | int | flags, | |
| int | code, | |||
| const wchar_t * | wformat, | |||
| ... | ||||
| ) | [inline] |
Updates a thread-local error buffer with variable number of arguments (.
..).
| flags | Clear/Insert/Append mode ( see GX_ERR_FLAG_CLEAR, GX_ERR_FLAG_APPEND, GX_ERR_FLAG_PREPEND, GX_ERR_FLAG_APPMODE, GX_ERR_FLAG_LOCAL ) | |
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for printf). | |
| ... | Arguments for format strings. |
References gx_seterrorfv().
Referenced by gxSystem::AppendError(), gx_appenderrorcode(), gx_clearerror(), gx_prependerrorcode(), gx_seterrorcode(), gx_seterrorcodef(), gxSystem::PrependError(), and gxSystem::SetError().
| int gx_seterror | ( | int | flags, | |
| int | code, | |||
| const wchar_t * | wformat = (const wchar_t *)0, |
|||
| ... | ||||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_seterrorf().
| flags | Clear/Insert/Append mode ( see GX_ERR_FLAG_CLEAR, GX_ERR_FLAG_APPEND, GX_ERR_FLAG_PREPEND, GX_ERR_FLAG_APPMODE, GX_ERR_FLAG_LOCAL ) | |
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for printf). | |
| ... | Arguments for format strings. |
References gx_seterrorfv().
Referenced by gxTrafo::Attach(), and gxImage::Attach().
| int gx_seterroraf | ( | int | flags, | |
| int | code, | |||
| const char * | wformat, | |||
| ... | ||||
| ) | [inline] |
Updates a thread-local error buffer with variable number of arguments (.
..) (ASCII version).
| flags | Clear/Insert/Append mode ( see GX_ERR_FLAG_CLEAR, GX_ERR_FLAG_APPEND, GX_ERR_FLAG_PREPEND, GX_ERR_FLAG_APPMODE, GX_ERR_FLAG_LOCAL ) | |
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for printf). | |
| ... | Arguments for format strings. |
References gx_seterrorafv().
| int gx_seterror | ( | int | flags, | |
| int | code, | |||
| const char * | wformat = (const char *)0, |
|||
| ... | ||||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_seterrorf().
| flags | Clear/Insert/Append mode ( see GX_ERR_FLAG_CLEAR, GX_ERR_FLAG_APPEND, GX_ERR_FLAG_PREPEND, GX_ERR_FLAG_APPMODE, GX_ERR_FLAG_LOCAL ) | |
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for printf). | |
| ... | Arguments for format strings. |
References gx_seterrorafv().
| int gx_clearerror | ( | void | ) | [inline] |
Clears a thread-local error buffer.
References gx_seterrorf().
Referenced by gxSystem::ClearError().
| int gx_seterrorcodef | ( | int | flags, | |
| int | code | |||
| ) | [inline] |
Updates a thread-local error buffer with flags and error code.
| flags | Clear/Insert/Append mode ( see GX_ERR_FLAG_CLEAR, GX_ERR_FLAG_APPEND, GX_ERR_FLAG_PREPEND, GX_ERR_FLAG_APPMODE, GX_ERR_FLAG_LOCAL ) | |
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). |
References gx_seterrorf().
| int gx_seterrorcode | ( | int | code | ) | [inline] |
Updates a thread-local error buffer with error code.
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). |
References gx_seterrorf().
Referenced by gx_seterror().
| int gx_appenderrorcode | ( | int | code | ) | [inline] |
Appends a thread-local error buffer with error code.
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). |
References gx_seterrorf().
Referenced by gx_appenderror().
| int gx_prependerrorcode | ( | int | code | ) | [inline] |
Prepends a thread-local error buffer with error code.
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). |
References gx_seterrorf().
Referenced by gx_prependerror().
| int gx_seterror | ( | int | code, | |
| const wchar_t * | wformat, | |||
| ... | ||||
| ) | [inline] |
Clears and updates a thread-local error buffer (Unicode version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string. (like for wprintf, use hs and ls instead of s) | |
| ... | Arguments for format strings. |
References gx_seterrorv().
| int gx_seterror | ( | int | code | ) | [inline] |
Usable in C++.
It is the same function as the gx_seterrorcode() (Unicode version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). |
References gx_seterrorcode().
| int gx_seterrora | ( | int | code, | |
| const char * | wformat, | |||
| ... | ||||
| ) | [inline] |
Clears and updates a thread-local error buffer (ASCII version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| ... | Arguments for format strings. |
References gx_seterrorav().
| int gx_seterror | ( | int | code, | |
| const char * | wformat, | |||
| ... | ||||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_seterrora() (ASCII version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| ... | Arguments for format strings. |
References gx_seterrorav().
| int gx_appenderror | ( | int | code, | |
| const wchar_t * | wformat, | |||
| ... | ||||
| ) | [inline] |
Appends a thread-local error buffer (Unicode version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| ... | Arguments for format strings. |
References gx_appenderrorv().
| int gx_appenderror | ( | int | code | ) | [inline] |
Usable in C++.
It is the same function as the gx_appenderrorcode() (Unicode version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). |
References gx_appenderrorcode().
| int gx_appenderrora | ( | int | code, | |
| const char * | wformat, | |||
| ... | ||||
| ) | [inline] |
Appends a thread-local error buffer (ASCII version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| ... | Arguments for format strings. |
References gx_appenderrorav().
| int gx_appenderror | ( | int | code, | |
| const char * | wformat, | |||
| ... | ||||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_seterrorv() (ASCII version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| ... | Arguments for format strings. |
References gx_appenderrorav().
| int gx_prependerror | ( | int | code, | |
| const wchar_t * | wformat, | |||
| ... | ||||
| ) | [inline] |
Prepends a thread-local error buffer (Unicode version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| ... | Arguments for format strings. |
References gx_prependerrorv().
| int gx_prependerror | ( | int | code | ) | [inline] |
Usable in C++.
It is the same function as the gx_prependerrorcode() (Unicode version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| ... | Arguments for format strings. |
References gx_prependerrorcode().
| int gx_prependerrora | ( | int | code, | |
| const char * | wformat, | |||
| ... | ||||
| ) | [inline] |
Prepends a thread-local error buffer (ASCII version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| ... | Arguments for format strings. |
References gx_prependerrorav().
| int gx_prependerror | ( | int | code, | |
| const char * | wformat, | |||
| ... | ||||
| ) | [inline] |
Usable in C++.
It is the same function as the gx_seterrorv() (ASCII version).
| code | Error code (Specified in gxerror.h or error codes also used in modules or system). | |
| wformat | Format string (like for wprintf, use hs and ls instead of s). | |
| ... | Arguments for format strings. |
References gx_prependerrorv().
| int gx_updateerrtable | ( | int | nitems, | |
| const gxERRITEM * | items | |||
| ) | [inline] |
Updates the error table in the memory.
| nitems | Number of items in the table. | |
| items | Items of the table. |
References gx_call().
| int gx_pusherror | ( | void | ) | [inline] |
Pushes the error code and string to the error stack.
References gx_call().
Referenced by gx_convertvariantbypath(), gx_convertvariantchild(), gx_convertvariantitem(), gx_createvariantchild(), gx_createvariantitem(), gxVariant::operator=(), and gxSystem::PushError().
| int gx_poperror | ( | void | ) | [inline] |
Pops the error code and string from the error stack.
References gx_call().
Referenced by gx_convertvariantbypath(), gx_convertvariantchild(), gx_convertvariantitem(), gx_createvariantchild(), gx_createvariantitem(), gxVariant::operator=(), and gxSystem::PopError().