ReactOS  0.4.14-dev-1036-g3c5b10f
pserror.h
Go to the documentation of this file.
1 /***************************************************************************/
2 /* */
3 /* pserror.h */
4 /* */
5 /* Adobe's code for error handling (specification). */
6 /* */
7 /* Copyright 2006-2013 Adobe Systems Incorporated. */
8 /* */
9 /* This software, and all works of authorship, whether in source or */
10 /* object code form as indicated by the copyright notice(s) included */
11 /* herein (collectively, the "Work") is made available, and may only be */
12 /* used, modified, and distributed under the FreeType Project License, */
13 /* LICENSE.TXT. Additionally, subject to the terms and conditions of the */
14 /* FreeType Project License, each contributor to the Work hereby grants */
15 /* to any individual or legal entity exercising permissions granted by */
16 /* the FreeType Project License and this section (hereafter, "You" or */
17 /* "Your") a perpetual, worldwide, non-exclusive, no-charge, */
18 /* royalty-free, irrevocable (except as stated in this section) patent */
19 /* license to make, have made, use, offer to sell, sell, import, and */
20 /* otherwise transfer the Work, where such license applies only to those */
21 /* patent claims licensable by such contributor that are necessarily */
22 /* infringed by their contribution(s) alone or by combination of their */
23 /* contribution(s) with the Work to which such contribution(s) was */
24 /* submitted. If You institute patent litigation against any entity */
25 /* (including a cross-claim or counterclaim in a lawsuit) alleging that */
26 /* the Work or a contribution incorporated within the Work constitutes */
27 /* direct or contributory patent infringement, then any patent licenses */
28 /* granted to You under this License for that Work shall terminate as of */
29 /* the date such litigation is filed. */
30 /* */
31 /* By using, modifying, or distributing the Work you indicate that you */
32 /* have read and understood the terms and conditions of the */
33 /* FreeType Project License as well as those provided in this section, */
34 /* and you accept them fully. */
35 /* */
36 /***************************************************************************/
37 
38 
39 #ifndef PSERROR_H_
40 #define PSERROR_H_
41 
42 
43 #include FT_MODULE_ERRORS_H
44 
45 #undef FTERRORS_H_
46 
47 #undef FT_ERR_PREFIX
48 #define FT_ERR_PREFIX CF2_Err_
49 #define FT_ERR_BASE FT_Mod_Err_CF2
50 
51 
52 #include FT_ERRORS_H
53 #include "psft.h"
54 
55 
57 
58 
59  /*
60  * A poor-man error facility.
61  *
62  * This code being written in vanilla C, doesn't have the luxury of a
63  * language-supported exception mechanism such as the one available in
64  * Java. Instead, we are stuck with using error codes that must be
65  * carefully managed and preserved. However, it is convenient for us to
66  * model our error mechanism on a Java-like exception mechanism.
67  * When we assign an error code we are thus `throwing' an error.
68  *
69  * The preservation of an error code is done by coding convention.
70  * Upon a function call if the error code is anything other than
71  * `FT_Err_Ok', which is guaranteed to be zero, we
72  * will return without altering that error. This will allow the
73  * error to propagate and be handled at the appropriate location in
74  * the code.
75  *
76  * This allows a style of code where the error code is initialized
77  * up front and a block of calls are made with the error code only
78  * being checked after the block. If a new error occurs, the original
79  * error will be preserved and a functional no-op should result in any
80  * subsequent function that has an initial error code not equal to
81  * `FT_Err_Ok'.
82  *
83  * Errors are encoded by calling the `FT_THROW' macro. For example,
84  *
85  * {
86  * FT_Error e;
87  *
88  *
89  * ...
90  * e = FT_THROW( Out_Of_Memory );
91  * }
92  *
93  */
94 
95 
96  /* Set error code to a particular value. */
97  FT_LOCAL( void )
99  FT_Error value );
100 
101 
102  /*
103  * A macro that conditionally sets an error code.
104  *
105  * This macro will first check whether `error' is set;
106  * if not, it will set it to `e'.
107  *
108  */
109 #define CF2_SET_ERROR( error, e ) \
110  cf2_setError( error, FT_THROW( e ) )
111 
112 
114 
115 
116 #endif /* PSERROR_H_ */
117 
118 
119 /* END */
int FT_Error
Definition: fttypes.h:300
#define error(str)
Definition: mkdosfs.c:1605
#define FT_END_HEADER
Definition: ftheader.h:54
#define FT_BEGIN_HEADER
Definition: ftheader.h:36
#define FT_LOCAL(x)
Definition: ftconfig.h:387
FT_BEGIN_HEADER cf2_setError(FT_Error *error, FT_Error value)
Definition: pserror.c:44