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

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

== Synopsis

Declared in `<baljsn_jsonconverter.h>`

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

== Description

Load to the specified `value` of (template parameter) `TYPE` the value of the specified `json` 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 `value` is reset.

== Return Value

0 on success, and a non‐zero value otherwise

== Parameters

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


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