Commit 27101d9c authored by Milo Yip's avatar Milo Yip

Add API doc for Writer::Reset() and Writer::IsComplete()

parent 5babae98
...@@ -44,6 +44,24 @@ public: ...@@ -44,6 +44,24 @@ public:
os_(&os), level_stack_(allocator, levelDepth * sizeof(Level)), os_(&os), level_stack_(allocator, levelDepth * sizeof(Level)),
doublePrecision_(kDefaultDoublePrecision), hasRoot_(false) {} doublePrecision_(kDefaultDoublePrecision), hasRoot_(false) {}
//! 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.
\param os New output stream.
\code
Writer<OutputStream> writer(os1);
writer.StartObject();
// ...
writer.EndObject();
writer.Reset(os2);
writer.StartObject();
// ...
writer.EndObject();
\endcode
*/
void Reset(OutputStream& os) { void Reset(OutputStream& os) {
os_ = &os; os_ = &os;
doublePrecision_ = kDefaultDoublePrecision; doublePrecision_ = kDefaultDoublePrecision;
...@@ -51,6 +69,10 @@ public: ...@@ -51,6 +69,10 @@ public:
level_stack_.Clear(); level_stack_.Clear();
} }
//! Checks whether the output is a complete JSON.
/*!
A complete JSON has a complete root object or array.
*/
bool IsComplete() const { bool IsComplete() const {
return hasRoot_ && level_stack_.Empty(); return hasRoot_ && level_stack_.Empty();
} }
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment