54876
|
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 |
*/
|
49234
|
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 |
|
|
56 |
FT_BEGIN_HEADER
|
|
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 )
|
|
98 |
cf2_setError( FT_Error* error,
|
|
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 |
|
|
113 |
FT_END_HEADER
|
|
114 |
|
|
115 |
|
|
116 |
#endif /* PSERROR_H_ */
|
|
117 |
|
|
118 |
|
|
119 |
/* END */
|