1 // Tencent is pleased to support the open source community by making RapidJSON available. 2 // 3 // Copyright (C) 2015 THL A29 Limited, a Tencent company, and Milo Yip. All rights reserved. 4 // 5 // Licensed under the MIT License (the "License"); you may not use this file except 6 // in compliance with the License. You may obtain a copy of the License at 7 // 8 // http://opensource.org/licenses/MIT 9 // 10 // Unless required by applicable law or agreed to in writing, software distributed 11 // under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR 12 // CONDITIONS OF ANY KIND, either express or implied. See the License for the 13 // specific language governing permissions and limitations under the License. 14 15 #ifndef RAPIDJSON_ERROR_ERROR_H_ 16 #define RAPIDJSON_ERROR_ERROR_H_ 17 18 #include "../rapidjson.h" 19 20 #ifdef __clang__ 21 RAPIDJSON_DIAG_PUSH 22 RAPIDJSON_DIAG_OFF(padded) 23 #endif 24 25 /*! \file error.h */ 26 27 /*! \defgroup RAPIDJSON_ERRORS RapidJSON error handling */ 28 29 /////////////////////////////////////////////////////////////////////////////// 30 // RAPIDJSON_ERROR_CHARTYPE 31 32 //! Character type of error messages. 33 /*! \ingroup RAPIDJSON_ERRORS 34 The default character type is \c char. 35 On Windows, user can define this macro as \c TCHAR for supporting both 36 unicode/non-unicode settings. 37 */ 38 #ifndef RAPIDJSON_ERROR_CHARTYPE 39 #define RAPIDJSON_ERROR_CHARTYPE char 40 #endif 41 42 /////////////////////////////////////////////////////////////////////////////// 43 // RAPIDJSON_ERROR_STRING 44 45 //! Macro for converting string literial to \ref RAPIDJSON_ERROR_CHARTYPE[]. 46 /*! \ingroup RAPIDJSON_ERRORS 47 By default this conversion macro does nothing. 48 On Windows, user can define this macro as \c _T(x) for supporting both 49 unicode/non-unicode settings. 50 */ 51 #ifndef RAPIDJSON_ERROR_STRING 52 #define RAPIDJSON_ERROR_STRING(x) x 53 #endif 54 55 RAPIDJSON_NAMESPACE_BEGIN 56 57 /////////////////////////////////////////////////////////////////////////////// 58 // ParseErrorCode 59 60 //! Error code of parsing. 61 /*! \ingroup RAPIDJSON_ERRORS 62 \see GenericReader::Parse, GenericReader::GetParseErrorCode 63 */ 64 enum ParseErrorCode { 65 kParseErrorNone = 0, //!< No error. 66 67 kParseErrorDocumentEmpty, //!< The document is empty. 68 kParseErrorDocumentRootNotSingular, //!< The document root must not follow by other values. 69 70 kParseErrorValueInvalid, //!< Invalid value. 71 72 kParseErrorObjectMissName, //!< Missing a name for object member. 73 kParseErrorObjectMissColon, //!< Missing a colon after a name of object member. 74 kParseErrorObjectMissCommaOrCurlyBracket, //!< Missing a comma or '}' after an object member. 75 76 kParseErrorArrayMissCommaOrSquareBracket, //!< Missing a comma or ']' after an array element. 77 78 kParseErrorStringUnicodeEscapeInvalidHex, //!< Incorrect hex digit after \\u escape in string. 79 kParseErrorStringUnicodeSurrogateInvalid, //!< The surrogate pair in string is invalid. 80 kParseErrorStringEscapeInvalid, //!< Invalid escape character in string. 81 kParseErrorStringMissQuotationMark, //!< Missing a closing quotation mark in string. 82 kParseErrorStringInvalidEncoding, //!< Invalid encoding in string. 83 84 kParseErrorNumberTooBig, //!< Number too big to be stored in double. 85 kParseErrorNumberMissFraction, //!< Miss fraction part in number. 86 kParseErrorNumberMissExponent, //!< Miss exponent in number. 87 88 kParseErrorTermination, //!< Parsing was terminated. 89 kParseErrorUnspecificSyntaxError //!< Unspecific syntax error. 90 }; 91 92 //! Result of parsing (wraps ParseErrorCode) 93 /*! 94 \ingroup RAPIDJSON_ERRORS 95 \code 96 Document doc; 97 ParseResult ok = doc.Parse("[42]"); 98 if (!ok) { 99 fprintf(stderr, "JSON parse error: %s (%u)", 100 GetParseError_En(ok.Code()), ok.Offset()); 101 exit(EXIT_FAILURE); 102 } 103 \endcode 104 \see GenericReader::Parse, GenericDocument::Parse 105 */ 106 struct ParseResult { 107 //!! Unspecified boolean type 108 typedef bool (ParseResult::*BooleanType)() const; 109 public: 110 //! Default constructor, no error. ParseResultParseResult111 ParseResult() : code_(kParseErrorNone), offset_(0) {} 112 //! Constructor to set an error. ParseResultParseResult113 ParseResult(ParseErrorCode code, size_t offset) : code_(code), offset_(offset) {} 114 115 //! Get the error code. CodeParseResult116 ParseErrorCode Code() const { return code_; } 117 //! Get the error offset, if \ref IsError(), 0 otherwise. OffsetParseResult118 size_t Offset() const { return offset_; } 119 120 //! Explicit conversion to \c bool, returns \c true, iff !\ref IsError(). BooleanTypeParseResult121 operator BooleanType() const { return !IsError() ? &ParseResult::IsError : NULL; } 122 //! Whether the result is an error. IsErrorParseResult123 bool IsError() const { return code_ != kParseErrorNone; } 124 125 bool operator==(const ParseResult& that) const { return code_ == that.code_; } 126 bool operator==(ParseErrorCode code) const { return code_ == code; } 127 friend bool operator==(ParseErrorCode code, const ParseResult & err) { return code == err.code_; } 128 129 bool operator!=(const ParseResult& that) const { return !(*this == that); } 130 bool operator!=(ParseErrorCode code) const { return !(*this == code); } 131 friend bool operator!=(ParseErrorCode code, const ParseResult & err) { return err != code; } 132 133 //! Reset error code. ClearParseResult134 void Clear() { Set(kParseErrorNone); } 135 //! Update error code and offset. 136 void Set(ParseErrorCode code, size_t offset = 0) { code_ = code; offset_ = offset; } 137 138 private: 139 ParseErrorCode code_; 140 size_t offset_; 141 }; 142 143 //! Function pointer type of GetParseError(). 144 /*! \ingroup RAPIDJSON_ERRORS 145 146 This is the prototype for \c GetParseError_X(), where \c X is a locale. 147 User can dynamically change locale in runtime, e.g.: 148 \code 149 GetParseErrorFunc GetParseError = GetParseError_En; // or whatever 150 const RAPIDJSON_ERROR_CHARTYPE* s = GetParseError(document.GetParseErrorCode()); 151 \endcode 152 */ 153 typedef const RAPIDJSON_ERROR_CHARTYPE* (*GetParseErrorFunc)(ParseErrorCode); 154 155 RAPIDJSON_NAMESPACE_END 156 157 #ifdef __clang__ 158 RAPIDJSON_DIAG_POP 159 #endif 160 161 #endif // RAPIDJSON_ERROR_ERROR_H_ 162