| Index: src/cff/cf2error.h
|
| diff --git a/src/cff/cf2error.h b/src/cff/cf2error.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..6453ebcb7b85f3baae0cec275bb92665532d676d
|
| --- /dev/null
|
| +++ b/src/cff/cf2error.h
|
| @@ -0,0 +1,119 @@
|
| +/***************************************************************************/
|
| +/* */
|
| +/* cf2error.h */
|
| +/* */
|
| +/* Adobe's code for error handling (specification). */
|
| +/* */
|
| +/* Copyright 2006-2013 Adobe Systems Incorporated. */
|
| +/* */
|
| +/* This software, and all works of authorship, whether in source or */
|
| +/* object code form as indicated by the copyright notice(s) included */
|
| +/* herein (collectively, the "Work") is made available, and may only be */
|
| +/* used, modified, and distributed under the FreeType Project License, */
|
| +/* LICENSE.TXT. Additionally, subject to the terms and conditions of the */
|
| +/* FreeType Project License, each contributor to the Work hereby grants */
|
| +/* to any individual or legal entity exercising permissions granted by */
|
| +/* the FreeType Project License and this section (hereafter, "You" or */
|
| +/* "Your") a perpetual, worldwide, non-exclusive, no-charge, */
|
| +/* royalty-free, irrevocable (except as stated in this section) patent */
|
| +/* license to make, have made, use, offer to sell, sell, import, and */
|
| +/* otherwise transfer the Work, where such license applies only to those */
|
| +/* patent claims licensable by such contributor that are necessarily */
|
| +/* infringed by their contribution(s) alone or by combination of their */
|
| +/* contribution(s) with the Work to which such contribution(s) was */
|
| +/* submitted. If You institute patent litigation against any entity */
|
| +/* (including a cross-claim or counterclaim in a lawsuit) alleging that */
|
| +/* the Work or a contribution incorporated within the Work constitutes */
|
| +/* direct or contributory patent infringement, then any patent licenses */
|
| +/* granted to You under this License for that Work shall terminate as of */
|
| +/* the date such litigation is filed. */
|
| +/* */
|
| +/* By using, modifying, or distributing the Work you indicate that you */
|
| +/* have read and understood the terms and conditions of the */
|
| +/* FreeType Project License as well as those provided in this section, */
|
| +/* and you accept them fully. */
|
| +/* */
|
| +/***************************************************************************/
|
| +
|
| +
|
| +#ifndef __CF2ERROR_H__
|
| +#define __CF2ERROR_H__
|
| +
|
| +
|
| +#include FT_MODULE_ERRORS_H
|
| +
|
| +#undef __FTERRORS_H__
|
| +
|
| +#undef FT_ERR_PREFIX
|
| +#define FT_ERR_PREFIX CF2_Err_
|
| +#define FT_ERR_BASE FT_Mod_Err_CF2
|
| +
|
| +
|
| +#include FT_ERRORS_H
|
| +#include "cf2ft.h"
|
| +
|
| +
|
| +FT_BEGIN_HEADER
|
| +
|
| +
|
| + /*
|
| + * A poor-man error facility.
|
| + *
|
| + * This code being written in vanilla C, doesn't have the luxury of a
|
| + * language-supported exception mechanism such as the one available in
|
| + * Java. Instead, we are stuck with using error codes that must be
|
| + * carefully managed and preserved. However, it is convenient for us to
|
| + * model our error mechanism on a Java-like exception mechanism.
|
| + * When we assign an error code we are thus `throwing' an error.
|
| + *
|
| + * The perservation of an error code is done by coding convention.
|
| + * Upon a function call if the error code is anything other than
|
| + * `FT_Err_Ok', which is guaranteed to be zero, we
|
| + * will return without altering that error. This will allow the
|
| + * error to propogate and be handled at the appropriate location in
|
| + * the code.
|
| + *
|
| + * This allows a style of code where the error code is initialized
|
| + * up front and a block of calls are made with the error code only
|
| + * being checked after the block. If a new error occurs, the original
|
| + * error will be preserved and a functional no-op should result in any
|
| + * subsequent function that has an initial error code not equal to
|
| + * `FT_Err_Ok'.
|
| + *
|
| + * Errors are encoded by calling the `FT_THROW' macro. For example,
|
| + *
|
| + * {
|
| + * FT_Error e;
|
| + *
|
| + *
|
| + * ...
|
| + * e = FT_THROW( Out_Of_Memory );
|
| + * }
|
| + *
|
| + */
|
| +
|
| +
|
| + /* Set error code to a particular value. */
|
| + FT_LOCAL( void )
|
| + cf2_setError( FT_Error* error,
|
| + FT_Error value );
|
| +
|
| +
|
| + /*
|
| + * A macro that conditionally sets an error code.
|
| + *
|
| + * This macro will first check whether `error' is set;
|
| + * if not, it will set it to `e'.
|
| + *
|
| + */
|
| +#define CF2_SET_ERROR( error, e ) \
|
| + cf2_setError( error, FT_THROW( e ) )
|
| +
|
| +
|
| +FT_END_HEADER
|
| +
|
| +
|
| +#endif /* __CF2ERROR_H__ */
|
| +
|
| +
|
| +/* END */
|
|
|