class ArrayRendererRequired header: <Eclog/ArrayRenderer.h>
The ArrayRenderer class represents an array renderer.
| Name | Description |
|---|---|
| (constructor) | Constructor. |
| beginObject | Begins rendering an object. |
| endObject | Ends rendering the current object. |
| beginArray | Begins rendering an array. |
| endArray | Ends rendering the current array. |
| renderMember | Renders value. |
| renderEmptyLines | Renders one or more empty lines. |
| renderComment | Renders a comment. |
| beginInline | Begins an inline-block. |
| endInline | Ends an inline-block. |
| operator RendererHandle | Returns a handle to this renderer. |
explicit ArrayRenderer(RendererHandle parent);
explicit ArrayRenderer(ArrayRenderer& parent);Constructs an ArrayRenderer.
RendererHandle parent Handle to the parent renderer.
ArrayRenderer& parent Reference to the parent renderer.
void beginObject();
void beginObject(ErrorCode& ec);Begins rendering an object.
The key-value pairs of the object must be rendered with a new object renderer (an ObjectRenderer instance) constructed from this renderer.
Each call to this method must be paired with a call to endObject.
ErrorCode& ec Set to indicate what error occurred, if any.
An InvalidOperation fault occurs if there is currently a nested object or array being rendered.
void endObject();
void endObject(ErrorCode& ec);Ends rendering the current object.
The object renderer of the current object, if there is one, is invalidated after this call.
ErrorCode& ec Set to indicate what error occurred, if any.
An InvalidOperation fault occurs if there is currently no nested object that is being rendered.
An InvalidOperation fault occurs if there is currently a deeply nested object or array that is being rendered.
void beginArray();
void beginArray(ErrorCode& ec);Begins rendering an array.
The values of the array must be rendered with a new array renderer (an ArrayRenderer instance) constructed from this renderer.
Each call to this method must be paired with a call to endArray.
ErrorCode& ec Set to indicate what error occurred, if any.
An InvalidOperation fault occurs if there is currently a nested object or array being rendered.
Ends rendering the current array.
The array renderer of the current array, if there is one, is invalidated after this call.
ErrorCode& ec Set to indicate what error occurred, if any.
An InvalidOperation fault occurs if there is currently no nested array that is being rendered.
An InvalidOperation fault occurs if there is currently a deeply nested object or array that is being rendered.
void renderMember(const ValueDesc& value);
void renderMember(const ValueDesc& value, ErrorCode& ec);Renders a value.
const ValueDesc& value The description of the value.
ErrorCode& ec Set to indicate what error occurred, if any.
An InvalidOperation fault occurs if there is currently a nested object or array being rendered.
void renderEmptyLines(int count);
void renderEmptyLines(int count, ErrorCode& ec);Renders one or more empty lines.
int count Number of empty lines.
ErrorCode& ec Set to indicate what error occurred, if any.
An InvalidOperation fault occurs if there is currently a nested object or array being rendered.
void renderComment(cstring comment);
void renderComment(cstring comment, ErrorCode& ec);Renders a comment.
cstring comment The comment.
ErrorCode& ec Set to indicate what error occurred, if any.
An InvalidOperation fault occurs if there is currently a nested object or array being rendered.
int beginInline();Begins an inline-block.
int The nesting level of the inline block.
An InvalidOperation fault occurs if there is currently a nested object or array being rendered.
int endInline();Ends an inline-block.
int The nesting level of the inline block.
An InvalidOperation fault occurs if there is currently a nested object or array being rendered.
operator RendererHandle();
Returns a handle to this renderer.
RendererHandle Handle to this renderer.