|
void | Flush () |
| Flush the output stream. More...
|
|
int | GetMaxDecimalPlaces () const |
|
bool | IsComplete () const |
| Checks whether the output is a complete JSON. More...
|
|
bool | RawValue (const Ch *json, size_t length, Type type) |
| Write a raw JSON value. More...
|
|
void | Reset (OutputStream &os) |
| Reset the writer with a new stream. More...
|
|
void | SetMaxDecimalPlaces (int maxDecimalPlaces) |
| Sets the maximum number of decimal places for double output. More...
|
|
| Writer (OutputStream &os, StackAllocator *stackAllocator=0, size_t levelDepth=kDefaultLevelDepth) |
| Constructor. More...
|
|
| Writer (StackAllocator *allocator=0, size_t levelDepth=kDefaultLevelDepth) |
|
|
|
bool | Null () |
|
bool | Bool (bool b) |
|
bool | Int (int i) |
|
bool | Uint (unsigned u) |
|
bool | Int64 (int64_t i64) |
|
bool | Uint64 (uint64_t u64) |
|
bool | Double (double d) |
| Writes the given double value to the stream. More...
|
|
bool | RawNumber (const Ch *str, SizeType length, bool copy=false) |
|
bool | String (const Ch *str, SizeType length, bool copy=false) |
|
bool | StartObject () |
|
bool | Key (const Ch *str, SizeType length, bool copy=false) |
|
bool | EndObject (SizeType memberCount=0) |
|
bool | StartArray () |
|
bool | EndArray (SizeType elementCount=0) |
|
|
bool | String (const Ch *const &str) |
| Simpler but slower overload. More...
|
|
bool | Key (const Ch *const &str) |
|
template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>
class Writer< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >
JSON writer.
Writer implements the concept Handler. It generates JSON text by events to an output os.
User may programmatically calls the functions of a writer to generate JSON text.
On the other side, a writer can also be passed to objects that generates events,
for example Reader::Parse() and Document::Accept().
- Template Parameters
-
OutputStream | Type of output stream. |
SourceEncoding | Encoding of source string. |
TargetEncoding | Encoding of output stream. |
StackAllocator | Type of allocator for allocating memory of stack. |
- Note
- implements Handler concept
Definition at line 110 of file fwd.h.
template<typename OutputStream , typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>
bool Writer< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Double |
( |
double |
d | ) |
|
|
inline |
Writes the given double
value to the stream.
- Parameters
-
d | The value to be written. |
- Returns
- Whether it is succeed.
Definition at line 230 of file writer.h.
template<typename OutputStream , typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>
void Writer< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Flush |
( |
| ) |
|
|
inline |
Flush the output stream.
Allows the user to flush the output stream immediately.
Definition at line 328 of file writer.h.
template<typename OutputStream , typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>
bool Writer< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::IsComplete |
( |
| ) |
const |
|
inline |
Checks whether the output is a complete JSON.
A complete JSON has a complete root object or array.
Definition at line 165 of file writer.h.
template<typename OutputStream , typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>
bool Writer< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::RawValue |
( |
const Ch * |
json, |
|
|
size_t |
length, |
|
|
Type |
type |
|
) |
| |
|
inline |
Write a raw JSON value.
For user to write a stringified JSON as a value.
- Parameters
-
json | A well-formed JSON value. It should not contain null character within [0, length - 1] range. |
length | Length of the json. |
type | Type of the root of json. |
Definition at line 318 of file writer.h.
template<typename OutputStream , typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>
void Writer< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Reset |
( |
OutputStream & |
os | ) |
|
|
inline |
Reset the writer with a new stream.
This function reset the writer with a new stream and default settings, in order to make a Writer object reusable for output multiple JSONs.
- Parameters
-
os | New output stream. writer.StartObject(); writer.EndObject(); writer.Reset(os2); writer.StartObject(); writer.EndObject(); |
Definition at line 155 of file writer.h.
template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>
void Writer< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::SetMaxDecimalPlaces |
( |
int |
maxDecimalPlaces | ) |
|
|
inline |
Sets the maximum number of decimal places for double output.
This setting truncates the output with specified number of decimal places.
For example,
writer.SetMaxDecimalPlaces(3);
writer.StartArray();
writer.Double(0.12345);
writer.Double(0.0001);
writer.Double(1.234567890123456e30);
truncate significand for positive exponent) writer.Double(1.23e-4);
"0.0" (do truncate significand for negative exponent)
writer.EndArray();
The default setting does not truncate any decimal places. You can restore to this setting by calling
Definition at line 191 of file writer.h.
template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>
bool Writer< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::String |
( |
const Ch *const & |
str | ) |
|
|
inline |
Simpler but slower overload.
Definition at line 303 of file writer.h.