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 "xbt/testsuite.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);
73 ts_test_fail(TS_CTX, "M5: n=%d (!= 5)", n);
81 THROW0(unknown_error, 2, "toto");
83 ts_test_check(TS_CTX, "exception value passing");
84 if (ex.category != unknown_error)
85 ts_test_fail(TS_CTX, "category=%d (!= 1)", ex.category);
87 ts_test_fail(TS_CTX, "value=%d (!= 2)", ex.value);
88 if (strcmp(ex.msg,"toto"))
89 ts_test_fail(TS_CTX, "message=%s (!= toto)", ex.msg);
94 TS_TEST(test_variables)
100 r1 = r2 = v1 = v2 = 1234;
104 THROW0(unknown_error, 0, "toto");
106 ts_test_check(TS_CTX, "variable preservation");
108 ts_test_fail(TS_CTX, "r1=%d (!= 1234)", r1);
110 ts_test_fail(TS_CTX, "v1=%d (!= 1234)", v1);
111 /* r2 is allowed to be destroyed because not volatile */
113 ts_test_fail(TS_CTX, "v2=%d (!= 5678)", v2);
118 TS_TEST(test_cleanup)
124 ts_test_check(TS_CTX, "cleanup handling");
130 THROW0(1, 2, "blah");
133 ts_test_fail(TS_CTX, "v1 = %d (!= 5678)", v1);
137 ts_test_fail(TS_CTX, "v1 = %d (!= 5678)", v1);
138 if (!(ex.category == 1 && ex.value == 2 && !strcmp(ex.msg,"blah")))
139 ts_test_fail(TS_CTX, "unexpected exception contents");
143 ts_test_fail(TS_CTX, "ex_cleanup not executed");
146 int main(int argc, char *argv[])
151 ts = ts_suite_new("OSSP ex (Exception Handling)");
152 ts_suite_test(ts, test_controlflow, "basic nested control flow");
153 ts_suite_test(ts, test_value, "exception value passing");
154 ts_suite_test(ts, test_variables, "variable value preservation");
155 ts_suite_test(ts, test_cleanup, "cleanup handling");
156 n = ts_suite_run(ts);
163 * The following is the example included in the documentation. It's a good
164 * idea to check its syntax even if we don't try to run it.
165 * And actually, it allows to put comments in the code despite doxygen.
167 static char *mallocex(int size) {
170 #define SMALLAMOUNT 10
171 #define TOOBIG 100000000
173 #if 0 /* this contains syntax errors, actually */
174 static void bad_example(void) {
175 struct {char*first;} *globalcontext;
180 char *cp1, *cp2, *cp3;
182 cp1 = mallocex(SMALLAMOUNT);
183 globalcontext->first = cp1;
184 cp2 = mallocex(TOOBIG);
185 cp3 = mallocex(SMALLAMOUNT);
189 if (cp3 != NULL) free(cp3);
190 if (cp2 != NULL) free(cp2);
191 if (cp1 != NULL) free(cp1);
193 printf("cp3=%s", cp3);
196 /* end_of_bad_example */
200 static void good_example(void) {
201 struct {char*first;} *globalcontext;
206 char * volatile /*03*/ cp1 = NULL /*02*/;
207 char * volatile /*03*/ cp2 = NULL /*02*/;
208 char * volatile /*03*/ cp3 = NULL /*02*/;
210 cp1 = mallocex(SMALLAMOUNT);
211 globalcontext->first = cp1;
212 cp1 = NULL /*05 give away*/;
213 cp2 = mallocex(TOOBIG);
214 cp3 = mallocex(SMALLAMOUNT);
218 printf("cp3=%s", cp3 == NULL /*02*/ ? "" : cp3);
223 /*05 cp1 was given away */
225 /*05 global context untouched */
229 /* end_of_good_example */