summaryrefslogtreecommitdiff
path: root/iup/src/iup_assert.h
blob: 03cec997c1df4865e1ce2c0192a249035b2df00a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
/** \file
 * \brief Assert Utilities
 *
 * See Copyright Notice in "iup.h"
 */

 
#ifndef __IUP_ASSERT_H 
#define __IUP_ASSERT_H

#ifdef __cplusplus
extern "C" {
#endif


/** \defgroup assert Assert Utilities
 * \par
 * All functions of the main API (Iup***) calls iupASSERT to check the parameters.
 * \par
 * The IUP main library must be recompiled with the IUP_ASSERT define to enable these checks.
 * iupASSERT is not called inside driver dependent functions nor in each control implementation, 
 * it is used only in the functions of the main API and in some utilities.
 * \par
 * See \ref iup_assert.h
 * \ingroup util */

/* internal functions */
void iupAssert(const char* expr, const char* file, int line, const char* func);
void iupError(const char* format, ...);

/** \def iupASSERT
 * \brief If the expression if false, 
 * displays a message with information of the source code where the assert happen.
 *
 * \param _expr The evaluated expression.
 * \par
 * It is a macro that calls a function only if IUP_ASSERT is defined.
 * \ingroup assert */

/** \def iupERROR
 * \brief Displays an error message. Also used by the iupASSERT. 
 * \par
 * It is a macro that calls a function only if IUP_ASSERT is defined.
 * \ingroup assert */

#ifndef  IUP_ASSERT
#define iupASSERT(_expr)  ((void)0)
#define iupERROR(_msg)  ((void)0)
#define iupERROR1(_msg, _p1)  ((void)0)
#define iupERROR2(_msg, _p1, _p2)  ((void)0)
#else
#ifdef __FUNCTION__
#define iupASSERT(_expr) ((_expr)? (void)0: iupAssert(#_expr, __FILE__, __LINE__, __FUNCTION__))
#else
#define iupASSERT(_expr) ((_expr)? (void)0: iupAssert(#_expr, __FILE__, __LINE__, NULL))
#endif  /* __FUNCTION__ */

#define iupERROR(_msg) iupError(_msg)
#define iupERROR1(_msg, _p1) iupError(_msg, _p1)
#define iupERROR2(_msg, _p1, _p2) iupError(_msg, _p1, _p2)

#endif  /* IUP_ASSERT */

#ifdef __cplusplus
}
#endif

#endif