Version 7.0
Copyright © 2021 Lowell D. Thomas
APG
… an ABNF Parser Generator
exception.h
Go to the documentation of this file.
1 /* *************************************************************************************
2  Copyright (c) 2021, Lowell D. Thomas
3  All rights reserved.
4 
5  This file is part of APG Version 7.0.
6  APG Version 7.0 may be used under the terms of the BSD 2-Clause License.
7 
8  Redistribution and use in source and binary forms, with or without
9  modification, are permitted provided that the following conditions are met:
10 
11  1. Redistributions of source code must retain the above copyright notice, this
12  list of conditions and the following disclaimer.
13 
14  2. Redistributions in binary form must reproduce the above copyright notice,
15  this list of conditions and the following disclaimer in the documentation
16  and/or other materials provided with the distribution.
17 
18  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21  DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
22  FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23  DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
24  SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
25  CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
26  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27  OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 
29 * *************************************************************************************/
30 #ifndef EXCEPTION_H_
31 #define EXCEPTION_H_
32 
42 #define BAD_CONTEXT 99
43 
47 typedef struct{
48  const void* vpValidate;
49  abool try;
50  jmp_buf aJmpBuf;
51  unsigned int uiLine;
52  char caMsg[256];
53  char caFile[256];
54  char caFunc[64];
55 } exception;
56 
67 #define XTHROW(ctx, msg) vExThrow((ctx), (msg), __LINE__, __FILE__, __func__)
68 
77 #define XCTOR(e) \
78  vExCtor(&e);\
79  if(setjmp(e.aJmpBuf) == 0){ \
80  e.try = APG_TRUE; \
81  }else{ \
82  e.try = APG_FALSE; \
83  }
84 
85 void vExCtor(exception* spException);
86 abool bExValidate(exception* spException);
87 void vExThrow(exception* spException, const char *cpMsg, unsigned int iLine, const char *cpFile, const char *cpFunc);
88 void vExRethrow(exception* spMemFrom, exception* spMemTo);
89 void vExContext();
90 
91 #endif /* EXCEPTION_H_ */
exception::uiLine
unsigned int uiLine
The source code line number where the error occurred. "__LINE__".
Definition: exception.h:51
vExContext
void vExContext()
Handles bad context pointers.
Definition: exception.c:126
exception::aJmpBuf
jmp_buf aJmpBuf
A "long jump" context array. Long jumps to "catch" area on thrown exception.
Definition: exception.h:50
bExValidate
abool bExValidate(exception *spException)
Test an exception structure for validity.
Definition: exception.c:70
vExRethrow
void vExRethrow(exception *spMemFrom, exception *spMemTo)
Re-throw an exception from the "from" try/catch-block scope to the "to" try/catch-block scope.
Definition: exception.c:105
exception
A structure to describe the type and location of a caught exception.
Definition: exception.h:47
exception::vpValidate
const void * vpValidate
Used by the memory object to validate the exception structure.
Definition: exception.h:48
vExThrow
void vExThrow(exception *spException, const char *cpMsg, unsigned int iLine, const char *cpFile, const char *cpFunc)
Throws an exception.
Definition: exception.c:87
abool
uint8_t abool
abool is the APG bool type.
Definition: apg.h:140
vExCtor
void vExCtor(exception *spException)
Initialize an exception structure.
Definition: exception.c:57
Generated on Sun Jun 13 2021 14:32:59 for APG by   doxygen 1.8.17
APG Version 7.0 is licensed under the 2-Clause BSD License,
an Open Source Initiative Approved License.