ReactOS 0.4.15-dev-8102-g108db8f
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 )
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 */
#define FT_LOCAL(x)
Definition: ftconfig.h:387
#define FT_END_HEADER
Definition: ftheader.h:54
#define FT_BEGIN_HEADER
Definition: ftheader.h:36
int FT_Error
Definition: fttypes.h:300
#define error(str)
Definition: mkdosfs.c:1605
FT_BEGIN_HEADER cf2_setError(FT_Error *error, FT_Error value)
Definition: pserror.c:44
Definition: pdh_main.c:94