Macros
#define	jsonOutTree(sb, tree, ...) _jsonOutTree(sb, tree, opt_flags(__VA_ARGS__), (SSDLockState*)_ssdCurrentLockState)

#define	jsonTreeToString(out, tree, ...) _jsonTreeToString(out, tree, opt_flags(__VA_ARGS__), (SSDLockState*)_ssdCurrentLockState)

Detailed Description

Automatic JSON serialization from SSD trees.

Macro Definition Documentation

◆ jsonOutTree

#define jsonOutTree	(	sb,
		tree,
		...
	)	_jsonOutTree(sb, tree, opt_flags(__VA_ARGS__), (SSDLockState*)_ssdCurrentLockState)

bool jsonOutTree(StreamBuffer *sb, SSDNode *tree, [flags])

Serializes an SSD tree to a stream buffer as JSON.

Automatically traverses the entire tree and outputs properly formatted JSON. The stream buffer should have a consumer registered (e.g., sbufStrCRegisterPush() or sbufFileCRegisterPush()).

IMPORTANT: The stream buffer is invalidated after this call.

Parameters

sb	Stream buffer to write to (invalidated after call)
tree	Root node of SSD tree to serialize
...	(flags) Optional output formatting flags (defaults to platform EOL with no indent)

Returns: true on success, false on error

Example:

SSDNode *root = ssdCreate(0);
ssdSet(root, _S"/name", stvar(string, _S"test"));
ssdSet(root, _S"/value", stvar(int32, 42));
 
VFSFile *file = vfsOpen(vfs, _S"output.json", FS_Write | FS_Create);
StreamBuffer *sb = sbufCreate(4096);
sbufFileCRegisterPush(sb, file, true);
jsonOutTree(sb, root, JSON_Pretty);
 
objRelease(&root);

Definition at line 171 of file jsonout.h.

◆ jsonTreeToString

#define jsonTreeToString	(	out,
		tree,
		...
	)	_jsonTreeToString(out, tree, opt_flags(__VA_ARGS__), (SSDLockState*)_ssdCurrentLockState)

bool jsonTreeToString(string *out, SSDNode *tree, [flags])

Serializes an SSD tree to a string as JSON.

Convenience function that internally creates a stream buffer and writes the JSON output to a string. Equivalent to manually setting up a stream buffer with sbufStrCRegisterPush() and calling jsonOutTree().