PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags > Class Template Reference

PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags > Class Template Reference#

Composable Kernel: PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags > Class Template Reference

Writer with indentation and spacing. More...

#include <prettywriter.h>

Inheritance diagram for PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >:

Public Types
typedef Writer< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >	Base
typedef Base::Ch	Ch
Public Types inherited from Writer< OutputStream, UTF8<>, UTF8<>, CrtAllocator, kWriteDefaultFlags >
typedef UTF8<>::Ch	Ch

Public Member Functions
	PrettyWriter (OutputStream &os, StackAllocator *allocator=0, size_t levelDepth=Base::kDefaultLevelDepth)
	Constructor.
	PrettyWriter (StackAllocator *allocator=0, size_t levelDepth=Base::kDefaultLevelDepth)
PrettyWriter &	SetIndent (Ch indentChar, unsigned indentCharCount)
	Set custom indentation.
PrettyWriter &	SetFormatOptions (PrettyFormatOptions options)
	Set pretty writer formatting options.
Implementation of Handler
See also Handler
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)
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 memberCount=0)
Public Member Functions inherited from Writer< OutputStream, UTF8<>, UTF8<>, CrtAllocator, kWriteDefaultFlags >
	Writer (OutputStream &os, CrtAllocator *stackAllocator=0, size_t levelDepth=kDefaultLevelDepth)
	Constructor.
void	Reset (OutputStream &os)
	Reset the writer with a new stream.
bool	IsComplete () const
	Checks whether the output is a complete JSON.
int	GetMaxDecimalPlaces () const
void	SetMaxDecimalPlaces (int maxDecimalPlaces)
	Sets the maximum number of decimal places for double output.
bool	Null ()
	Writes the given `double` value to the stream.
bool	Bool (bool b)
	Writes the given `double` value to the stream.
bool	Int (int i)
	Writes the given `double` value to the stream.
bool	Uint (unsigned u)
	Writes the given `double` value to the stream.
bool	Int64 (int64_t i64)
	Writes the given `double` value to the stream.
bool	Uint64 (uint64_t u64)
	Writes the given `double` value to the stream.
bool	Double (double d)
	Writes the given `double` value to the stream.
bool	RawNumber (const Ch *str, SizeType length, bool copy=false)
	Writes the given `double` value to the stream.
bool	String (const Ch *str, SizeType length, bool copy=false)
	Writes the given `double` value to the stream.
bool	StartObject ()
	Writes the given `double` value to the stream.
bool	Key (const Ch *str, SizeType length, bool copy=false)
	Writes the given `double` value to the stream.
bool	EndObject (SizeType memberCount=0)
	Writes the given `double` value to the stream.
bool	StartArray ()
	Writes the given `double` value to the stream.
bool	EndArray (SizeType elementCount=0)
	Writes the given `double` value to the stream.
bool	RawValue (const Ch *json, size_t length, Type type)
	Write a raw JSON value.
void	Flush ()
	Flush the output stream.

Convenience extensions
Ch	indentChar_
	Simpler but slower overload.
unsigned	indentCharCount_
	Simpler but slower overload.
PrettyFormatOptions	formatOptions_
	Simpler but slower overload.
bool	String (const Ch *str)
	Simpler but slower overload.
bool	Key (const Ch *str)
	Simpler but slower overload.
bool	RawValue (const Ch *json, size_t length, Type type)
	Write a raw JSON value.
void	PrettyPrefix (Type type)
	Simpler but slower overload.
void	WriteIndent ()
	Simpler but slower overload.

Additional Inherited Members
Static Public Attributes inherited from Writer< OutputStream, UTF8<>, UTF8<>, CrtAllocator, kWriteDefaultFlags >
static const int	kDefaultMaxDecimalPlaces
static const size_t	kDefaultLevelDepth
	Simpler but slower overload.
Protected Member Functions inherited from Writer< OutputStream, UTF8<>, UTF8<>, CrtAllocator, kWriteDefaultFlags >
bool	WriteInt (int i)
bool	WriteUint (unsigned u)
bool	WriteInt64 (int64_t i64)
bool	WriteUint64 (uint64_t u)
bool	WriteDouble (double d)
bool	WriteNull ()
	Simpler but slower overload.
bool	WriteBool (bool b)
	Simpler but slower overload.
bool	WriteString (const Ch *str, SizeType length)
	Simpler but slower overload.
bool	ScanWriteUnescapedString (GenericStringStream< UTF8<> > &is, size_t length)
	Simpler but slower overload.
bool	WriteStartObject ()
	Simpler but slower overload.
bool	WriteEndObject ()
	Simpler but slower overload.
bool	WriteStartArray ()
	Simpler but slower overload.
bool	WriteEndArray ()
	Simpler but slower overload.
bool	WriteRawValue (const Ch *json, size_t length)
	Simpler but slower overload.
void	Prefix (Type type)
	Simpler but slower overload.
bool	EndValue (bool ret)
	Simpler but slower overload.
OutputStream *	os_
	Simpler but slower overload.
internal::Stack< CrtAllocator >	level_stack_
	Simpler but slower overload.
int	maxDecimalPlaces_
	Simpler but slower overload.
bool	hasRoot_
	Simpler but slower overload.

Detailed Description

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>
class PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >

Writer with indentation and spacing.

Template Parameters

OutputStream	Type of output os.
SourceEncoding	Encoding of source string.
TargetEncoding	Encoding of output stream.
StackAllocator	Type of allocator for allocating memory of stack.

Member Typedef Documentation

◆ Base

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

typedef Writer<OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags> PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Base

◆ Ch

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

typedef Base::Ch PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Ch

Constructor & Destructor Documentation

◆ PrettyWriter() [1/2]

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::PrettyWriter	(	OutputStream &	os,
		StackAllocator *	allocator = 0,
		size_t	levelDepth = Base::kDefaultLevelDepth )

inlineexplicit

Constructor.

Parameters

os	Output stream.
allocator	User supplied allocator. If it is null, it will create a private one.
levelDepth	Initial capacity of stack.

◆ PrettyWriter() [2/2]

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::PrettyWriter	(	StackAllocator *	allocator = 0,
		size_t	levelDepth = Base::kDefaultLevelDepth )

inlineexplicit

Member Function Documentation

◆ Bool()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Bool ( bool b )

inline

◆ Double()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Double ( double d )

inline

◆ EndArray()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::EndArray ( SizeType memberCount = 0 )

inline

◆ EndObject()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::EndObject ( SizeType memberCount = 0 )

inline

◆ Int()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Int ( int i )

inline

◆ Int64()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Int64 ( int64_t i64 )

inline

◆ Key() [1/2]

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Key ( const Ch * str )

inline

Simpler but slower overload.

◆ Key() [2/2]

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Key	(	const Ch *	str,
		SizeType	length,
		bool	copy = false )

inline

◆ Null()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Null ( )

inline

◆ PrettyPrefix()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

void PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::PrettyPrefix ( Type type )

inlineprotected

Simpler but slower overload.

◆ RawNumber()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::RawNumber	(	const Ch *	str,
		SizeType	length,
		bool	copy = false )

inline

◆ RawValue()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< 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.

Note: When using PrettyWriter::RawValue(), the result json may not be indented correctly.

◆ SetFormatOptions()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

PrettyWriter & PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::SetFormatOptions ( PrettyFormatOptions options )

inline

Set pretty writer formatting options.

Parameters

options Formatting options.

◆ SetIndent()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

PrettyWriter & PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::SetIndent	(	Ch	indentChar,
		unsigned	indentCharCount )

inline

Set custom indentation.

Parameters

indentChar	Character for indentation. Must be whitespace character (' ', '\t', '\n', '\r').
indentCharCount	Number of indent characters for each indentation level.

Note: The default indentation is 4 spaces.

◆ StartArray()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::StartArray ( )

inline

◆ StartObject()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::StartObject ( )

inline

◆ String() [1/2]

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::String ( const Ch * str )

inline

Simpler but slower overload.

◆ String() [2/2]

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::String	(	const Ch *	str,
		SizeType	length,
		bool	copy = false )

inline

◆ Uint()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Uint ( unsigned u )

inline

◆ Uint64()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

bool PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::Uint64 ( uint64_t u64 )

inline

◆ WriteIndent()

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

void PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::WriteIndent ( )

inlineprotected

Simpler but slower overload.

Member Data Documentation

◆ formatOptions_

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

PrettyFormatOptions PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::formatOptions_

protected

Simpler but slower overload.

◆ indentChar_

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

Ch PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::indentChar_

protected

Simpler but slower overload.

◆ indentCharCount_

template<typename OutputStream, typename SourceEncoding = UTF8<>, typename TargetEncoding = UTF8<>, typename StackAllocator = CrtAllocator, unsigned writeFlags = kWriteDefaultFlags>

unsigned PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags >::indentCharCount_

protected

Simpler but slower overload.

The documentation for this class was generated from the following files:

PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags > Class Template Reference

PrettyWriter&lt; OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags &gt; Class Template Reference#

Public Types

Public Member Functions

Convenience extensions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ Base

◆ Ch

Constructor & Destructor Documentation

◆ PrettyWriter() [1/2]

◆ PrettyWriter() [2/2]

Member Function Documentation

◆ Bool()

◆ Double()

◆ EndArray()

◆ EndObject()

◆ Int()

◆ Int64()

◆ Key() [1/2]

◆ Key() [2/2]

◆ Null()

◆ PrettyPrefix()

◆ RawNumber()

◆ RawValue()

◆ SetFormatOptions()

◆ SetIndent()

◆ StartArray()

◆ StartObject()

◆ String() [1/2]

◆ String() [2/2]

◆ Uint()

◆ Uint64()

◆ WriteIndent()

Member Data Documentation

◆ formatOptions_

◆ indentChar_

◆ indentCharCount_

PrettyWriter< OutputStream, SourceEncoding, TargetEncoding, StackAllocator, writeFlags > Class Template Reference#