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 public: 108 //! Default constructor, no error. ParseResultParseResult109 ParseResult() : code_(kParseErrorNone), offset_(0) {} 110 //! Constructor to set an error. ParseResultParseResult111 ParseResult(ParseErrorCode code, size_t offset) : code_(code), offset_(offset) {} 112 113 //! Get the error code. CodeParseResult114 ParseErrorCode Code() const { return code_; } 115 //! Get the error offset, if \ref IsError(), 0 otherwise. OffsetParseResult116 size_t Offset() const { return offset_; } 117 118 //! Conversion to \c bool, returns \c true, iff !\ref IsError(). 119 operator bool() const { return !IsError(); } 120 //! Whether the result is an error. IsErrorParseResult121 bool IsError() const { return code_ != kParseErrorNone; } 122 123 bool operator==(const ParseResult& that) const { return code_ == that.code_; } 124 bool operator==(ParseErrorCode code) const { return code_ == code; } 125 friend bool operator==(ParseErrorCode code, const ParseResult & err) { return code == err.code_; } 126 127 //! Reset error code. ClearParseResult128 void Clear() { Set(kParseErrorNone); } 129 //! Update error code and offset. 130 void Set(ParseErrorCode code, size_t offset = 0) { code_ = code; offset_ = offset; } 131 132 private: 133 ParseErrorCode code_; 134 size_t offset_; 135 }; 136 137 //! Function pointer type of GetParseError(). 138 /*! \ingroup RAPIDJSON_ERRORS 139 140 This is the prototype for \c GetParseError_X(), where \c X is a locale. 141 User can dynamically change locale in runtime, e.g.: 142 \code 143 GetParseErrorFunc GetParseError = GetParseError_En; // or whatever 144 const RAPIDJSON_ERROR_CHARTYPE* s = GetParseError(document.GetParseErrorCode()); 145 \endcode 146 */ 147 typedef const RAPIDJSON_ERROR_CHARTYPE* (*GetParseErrorFunc)(ParseErrorCode); 148 149 RAPIDJSON_NAMESPACE_END 150 151 #ifdef __clang__ 152 RAPIDJSON_DIAG_POP 153 #endif 154 155 #endif // RAPIDJSON_ERROR_ERROR_H_ 156