[#BloombergLP-baljsn-SimpleFormatter-openArray-00]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/baljsn.adoc[baljsn]::xref:BloombergLP/baljsn/SimpleFormatter.adoc[SimpleFormatter]::openArray
:relfileprefix: ../../../
:mrdocs:

`openArray` overloads

== Synopses

Declared in `<baljsn_simpleformatter.h>`

Print onto the stream supplied at construction the sequence of characters designating the start of an array (referred to as an "array" in JSON), preceded, if necessary, by a comma. Optionally specify `formattingStyle` denoting if the array being opened should be formatted as an empty array. If `formattingStyle` is not specified then the array being opened is formatted as a regular array having elements. The behavior is undefined unless `isNameNeeded()` is `false`. Note that the formatting (and as a consequence the `formattingStyle`) is relevant only if this formatter encodes in the pretty style and is ignored otherwise.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/baljsn/SimpleFormatter/openArray-08.adoc[openArray](xref:BloombergLP/baljsn/SimpleFormatter/ArrayFormattingStyle.adoc[ArrayFormattingStyle] formattingStyle = e_REGULAR_ARRAY_FORMAT);
----

[.small]#xref:BloombergLP/baljsn/SimpleFormatter/openArray-08.adoc[_» more..._]#

Print onto the stream supplied at construction the sequence of characters designating the start of an array (referred to as an "array" in JSON) with the specified `name`, preceded, if necessary, by a comma. Optionally specify `formattingStyle` denoting if the array being opened should be formatted as an empty array. If `formattingStyle` is not specified then the array being opened is formatted as a regular array having elements. The behavior is undefined unless `isNameNeeded()` is `true`. Note that the formatting (and as a consequence the `formattingStyle`) is relevant only if this formatter encodes in the pretty style and is ignored otherwise.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/baljsn/SimpleFormatter/openArray-0e.adoc[openArray](
    std::string_view const& name,
    xref:BloombergLP/baljsn/SimpleFormatter/ArrayFormattingStyle.adoc[ArrayFormattingStyle] formattingStyle = e_REGULAR_ARRAY_FORMAT);
----

[.small]#xref:BloombergLP/baljsn/SimpleFormatter/openArray-0e.adoc[_» more..._]#


[.small]#Created with https://www.mrdocs.com[MrDocs]#