[#BloombergLP-baljsn-JsonConverter-convert-067]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/baljsn.adoc[baljsn]::xref:BloombergLP/baljsn/JsonConverter.adoc[JsonConverter]::convert
:relfileprefix: ../../../
:mrdocs:

Load `value` into `json` using `options`.

== Synopsis

Declared in `<baljsn_jsonconverter.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class TYPE>
int
convert(
    xref:BloombergLP/bdljsn/Json.adoc[bdljsn::Json]* json,
    TYPE const& value,
    xref:BloombergLP/baljsn/ConvertToJsonOptions.adoc[ConvertToJsonOptions] const& options = ConvertToJsonOptions());
----

== Description

Load into the specified `json` the specified `value` of (template parameter) `TYPE` using the specified `options`. Return 0 on success, and a non‐zero value otherwise. An error is returned if `TYPE` is not a top‐level `Sequence`, `Choice`, or `Array`. The prior value of `json` is reset.

== Return Value

0 on success, and a non‐zero value otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *json*
| JSON object to load
| *value*
| value to convert
| *options*
| conversion options
|===


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