2 ** OSSP ex - Exception Handling
3 ** Copyright (c) 2002-2004 Ralf S. Engelschall <rse@engelschall.com>
4 ** Copyright (c) 2002-2004 The OSSP Project <http://www.ossp.org/>
5 ** Copyright (c) 2002-2004 Cable & Wireless <http://www.cw.com/>
7 ** This file is part of OSSP ex, an exception handling library
8 ** which can be found at http://www.ossp.org/pkg/lib/ex/.
10 ** Permission to use, copy, modify, and distribute this software for
11 ** any purpose with or without fee is hereby granted, provided that
12 ** the above copyright notice and this permission notice appear in all
15 ** THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
16 ** WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
17 ** MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 ** IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
19 ** CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
21 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
22 ** USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
23 ** ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24 ** OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
25 ** OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 ** ex_test.c: exception handling test suite
36 #include "ex_test_ts.h"
40 XBT_LOG_NEW_CATEGORY(test,"This test");
42 TS_TEST(test_controlflow)
47 ts_test_check(TS_CTX, "basic nested control flow");
51 ts_test_fail(TS_CTX, "M1: n=%d (!= 1)", n);
55 ts_test_fail(TS_CTX, "M2: n=%d (!= 2)", n);
57 THROW0(unknown_error,0,"something");
60 ts_test_fail(TS_CTX, "M3: n=%d (!= 1)", n);
64 ts_test_fail(TS_CTX, "MX: n=%d (expected: not reached)", n);
68 ts_test_fail(TS_CTX, "M4: n=%d (!= 4)", n);
72 ts_test_fail(TS_CTX, "M5: n=%d (!= 5)", n);
80 THROW0(unknown_error, 2, "toto");
82 ts_test_check(TS_CTX, "exception value passing");
83 if (ex.category != unknown_error)
84 ts_test_fail(TS_CTX, "category=%d (!= 1)", ex.category);
86 ts_test_fail(TS_CTX, "value=%d (!= 2)", ex.value);
87 if (strcmp(ex.msg,"toto"))
88 ts_test_fail(TS_CTX, "message=%s (!= toto)", ex.msg);
92 TS_TEST(test_variables)
98 r1 = r2 = v1 = v2 = 1234;
102 THROW0(unknown_error, 0, "toto");
104 ts_test_check(TS_CTX, "variable preservation");
106 ts_test_fail(TS_CTX, "r1=%d (!= 1234)", r1);
108 ts_test_fail(TS_CTX, "v1=%d (!= 1234)", v1);
109 /* r2 is allowed to be destroyed because not volatile */
111 ts_test_fail(TS_CTX, "v2=%d (!= 5678)", v2);
115 TS_TEST(test_cleanup)
121 ts_test_check(TS_CTX, "cleanup handling");
127 THROW0(1, 2, "blah");
130 ts_test_fail(TS_CTX, "v1 = %d (!= 5678)", v1);
134 ts_test_fail(TS_CTX, "v1 = %d (!= 5678)", v1);
135 if (!(ex.category == 1 && ex.value == 2 && !strcmp(ex.msg,"blah")))
136 ts_test_fail(TS_CTX, "unexpected exception contents");
139 ts_test_fail(TS_CTX, "ex_cleanup not executed");
142 int main(int argc, char *argv[])
147 ts = ts_suite_new("OSSP ex (Exception Handling)");
148 ts_suite_test(ts, test_controlflow, "basic nested control flow");
149 ts_suite_test(ts, test_value, "exception value passing");
150 ts_suite_test(ts, test_variables, "variable value preservation");
151 ts_suite_test(ts, test_cleanup, "cleanup handling");
152 n = ts_suite_run(ts);
159 * The following is the example included in the documentation. It's a good
160 * idea to check its syntax even if we don't try to run it.
161 * And actually, it allows to put comments in the code despite doxygen.
163 static char *mallocex(int size) {
166 #define SMALLAMOUNT 10
167 #define TOOBIG 100000000
169 #if 0 /* this contains syntax errors, actually */
170 static void bad_example(void) {
171 struct {char*first;} *globalcontext;
176 char *cp1, *cp2, *cp3;
178 cp1 = mallocex(SMALLAMOUNT);
179 globalcontext->first = cp1;
180 cp2 = mallocex(TOOBIG);
181 cp3 = mallocex(SMALLAMOUNT);
185 if (cp3 != NULL) free(cp3);
186 if (cp2 != NULL) free(cp2);
187 if (cp1 != NULL) free(cp1);
189 printf("cp3=%s", cp3);
192 /* end_of_bad_example */
196 static void good_example(void) {
197 struct {char*first;} *globalcontext;
202 char * volatile /*03*/ cp1 = NULL /*02*/;
203 char * volatile /*03*/ cp2 = NULL /*02*/;
204 char * volatile /*03*/ cp3 = NULL /*02*/;
206 cp1 = mallocex(SMALLAMOUNT);
207 globalcontext->first = cp1;
208 cp1 = NULL /*05 give away*/;
209 cp2 = mallocex(TOOBIG);
210 cp3 = mallocex(SMALLAMOUNT);
214 printf("cp3=%s", cp3 == NULL /*02*/ ? "" : cp3);
219 /*05 cp1 was given away */
221 /*05 global context untouched */
225 /* end_of_good_example */