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"
39 XBT_LOG_NEW_CATEGORY(test,"This test");
41 TS_TEST(test_controlflow)
46 ts_test_check(TS_CTX, "basic nested control flow");
50 ts_test_fail(TS_CTX, "M1: n=%d (!= 1)", n);
54 ts_test_fail(TS_CTX, "M2: n=%d (!= 2)", n);
56 THROW0(unknown_error,0,"something");
59 ts_test_fail(TS_CTX, "M3: n=%d (!= 1)", n);
63 ts_test_fail(TS_CTX, "MX: n=%d (expected: not reached)", n);
67 ts_test_fail(TS_CTX, "M4: n=%d (!= 4)", n);
71 ts_test_fail(TS_CTX, "M5: n=%d (!= 5)", n);
79 THROW0(unknown_error, 2, "toto");
81 ts_test_check(TS_CTX, "exception value passing");
82 if (ex.category != unknown_error)
83 ts_test_fail(TS_CTX, "category=%d (!= 1)", ex.category);
85 ts_test_fail(TS_CTX, "value=%d (!= 2)", ex.value);
86 if (strcmp(ex.msg,"toto"))
87 ts_test_fail(TS_CTX, "message=%s (!= toto)", ex.msg);
91 TS_TEST(test_variables)
97 r1 = r2 = v1 = v2 = 1234;
101 THROW0(unknown_error, 0, "toto");
103 ts_test_check(TS_CTX, "variable preservation");
105 ts_test_fail(TS_CTX, "r1=%d (!= 1234)", r1);
107 ts_test_fail(TS_CTX, "v1=%d (!= 1234)", v1);
108 /* r2 is allowed to be destroyed because not volatile */
110 ts_test_fail(TS_CTX, "v2=%d (!= 5678)", v2);
114 TS_TEST(test_cleanup)
120 ts_test_check(TS_CTX, "cleanup handling");
126 THROW0(1, 2, "blah");
129 ts_test_fail(TS_CTX, "v1 = %d (!= 5678)", v1);
133 ts_test_fail(TS_CTX, "v1 = %d (!= 5678)", v1);
134 if (!(ex.category == 1 && ex.value == 2 && !strcmp(ex.msg,"blah")))
135 ts_test_fail(TS_CTX, "unexpected exception contents");
138 ts_test_fail(TS_CTX, "ex_cleanup not executed");
141 int main(int argc, char *argv[])
146 ts = ts_suite_new("OSSP ex (Exception Handling)");
147 ts_suite_test(ts, test_controlflow, "basic nested control flow");
148 ts_suite_test(ts, test_value, "exception value passing");
149 ts_suite_test(ts, test_variables, "variable value preservation");
150 ts_suite_test(ts, test_cleanup, "cleanup handling");
151 n = ts_suite_run(ts);
158 * The following is the example included in the documentation. It's a good
159 * idea to check its syntax even if we don't try to run it.
160 * And actually, it allows to put comments in the code despite doxygen.
162 static char *mallocex(int size) {
165 #define SMALLAMOUNT 10
166 #define TOOBIG 100000000
168 #if 0 /* this contains syntax errors, actually */
169 static void bad_example(void) {
170 struct {char*first;} *globalcontext;
175 char *cp1, *cp2, *cp3;
177 cp1 = mallocex(SMALLAMOUNT);
178 globalcontext->first = cp1;
179 cp2 = mallocex(TOOBIG);
180 cp3 = mallocex(SMALLAMOUNT);
184 if (cp3 != NULL) free(cp3);
185 if (cp2 != NULL) free(cp2);
186 if (cp1 != NULL) free(cp1);
188 printf("cp3=%s", cp3);
191 /* end_of_bad_example */
195 static void good_example(void) {
196 struct {char*first;} *globalcontext;
201 char * volatile /*03*/ cp1 = NULL /*02*/;
202 char * volatile /*03*/ cp2 = NULL /*02*/;
203 char * volatile /*03*/ cp3 = NULL /*02*/;
205 cp1 = mallocex(SMALLAMOUNT);
206 globalcontext->first = cp1;
207 cp1 = NULL /*05 give away*/;
208 cp2 = mallocex(TOOBIG);
209 cp3 = mallocex(SMALLAMOUNT);
213 printf("cp3=%s", cp3 == NULL /*02*/ ? "" : cp3);
218 /*05 cp1 was given away */
220 /*05 global context untouched */
224 /* end_of_good_example */