Build a CharReader implementation. More...
#include <json.h>
Public Member Functions | |
| CharReaderBuilder () | |
| CharReader * | newCharReader () const override |
| Allocate a CharReader via operator new(). More... | |
| Value & | operator[] (std::string key) |
| bool | validate (Json::Value *invalid) const |
| ~CharReaderBuilder () override | |
 Public Member Functions inherited from Json::CharReader::Factory | |
| virtual | ~Factory () |
Static Public Member Functions | |
| static void | setDefaults (Json::Value *settings) |
| static void | strictMode (Json::Value *settings) |
Public Attributes | |
| Json::Value | settings_ |
Detailed Description
Build a CharReader implementation.
Usage:
Constructor & Destructor Documentation
◆ CharReaderBuilder()
| Json::CharReaderBuilder::CharReaderBuilder | ( | ) |
Definition at line 2100 of file jsoncpp.cpp.
◆ ~CharReaderBuilder()
|
override |
Definition at line 2104 of file jsoncpp.cpp.
Member Function Documentation
◆ newCharReader()
|
overridevirtual |
Allocate a CharReader via operator new().
- Exceptions
-
std::exception if something goes wrong (e.g. invalid settings)
Implements Json::CharReader::Factory.
Definition at line 2106 of file jsoncpp.cpp.
◆ operator[]()
| Value & Json::CharReaderBuilder::operator[] | ( | std::string | key | ) |
A simple way to update a specific setting.
Definition at line 2152 of file jsoncpp.cpp.
◆ setDefaults()
|
static |
Called by ctor, but you can use this to reset settings_.
- Precondition
- 'settings' != NULL (but Json::null is fine)
- Remarks
- Defaults:
[CharReaderBuilderDefaults]
[CharReaderBuilderDefaults]
Definition at line 2172 of file jsoncpp.cpp.
◆ strictMode()
|
static |
Same as old Features::strictMode().
- Precondition
- 'settings' != NULL (but Json::null is fine)
- Remarks
- Defaults:
[CharReaderBuilderStrictMode]
[CharReaderBuilderStrictMode]
Definition at line 2157 of file jsoncpp.cpp.
◆ validate()
| bool Json::CharReaderBuilder::validate | ( | Json::Value * | invalid | ) | const |
- Returns
- true if 'settings' are legal and consistent; otherwise, indicate bad settings via 'invalid'.
Definition at line 2135 of file jsoncpp.cpp.
Member Data Documentation
◆ settings_
| Json::Value Json::CharReaderBuilder::settings_ |
Configuration of this builder. These are case-sensitive. Available settings (case-sensitive):
"collectComments": false or true- true to collect comment and allow writing them back during serialization, false to discard comments. This parameter is ignored if allowComments is false.
"allowComments": false or true- true if comments are allowed.
"strictRoot": false or true- true if root must be either an array or an object value
"allowDroppedNullPlaceholders": false or true- true if dropped null placeholders are allowed. (See StreamWriterBuilder.)
"allowNumericKeys": false or true- true if numeric object keys are allowed.
"allowSingleQuotes": false or true- true if '' are allowed for strings (both keys and values)
"stackLimit": integer- Exceeding stackLimit (recursive depth of
readValue()) will cause an exception. - This is a security issue (seg-faults caused by deeply nested JSON), so the default is low.
- Exceeding stackLimit (recursive depth of
"failIfExtra": false or true- If true,
parse()returns false when extra non-whitespace trails the JSON value in the input string.
- If true,
"rejectDupKeys": false or true- If true,
parse()returns false when a key is duplicated within an object.
- If true,
"allowSpecialFloats": false or true- If true, special float values (NaNs and infinities) are allowed and their values are lossfree restorable.
You can examine 'settings_` yourself to see the defaults. You can also write and read them just like any JSON Value.
- See also
- setDefaults()
The documentation for this class was generated from the following files: