[#BloombergLP-ball-RecordFormatterRegistryUtil-createRecordFormatter]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/ball.adoc[ball]::xref:BloombergLP/ball/RecordFormatterRegistryUtil.adoc[RecordFormatterRegistryUtil]::createRecordFormatter
:relfileprefix: ../../../
:mrdocs:

Load, into the specified `result` a formatter functor that formats as instructed by the specified `format` and `formatOptions`. The `format` may start with a URI‐like scheme (e.g., `"qjson://"`) that selects both the formatter (class) and the syntax of the format specification that follows the scheme. In case `format` does not start with a scheme the "text://" scheme is assumed. Return 0 if the requested log record formatter was successfully created and loaded into `result`. Otherwise, if `results is empty, load a default/fallback‐formatter into `result`, with the requested scheme if that exists or with a sensible fallback text log format otherwise. For further details on behavior in case of errors see {Behavior with Invalid Formats}. This method currently supports the "text", "qjson", and "json" schemes.

== Synopsis

Declared in `<ball_recordformatterregistryutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
createRecordFormatter(
    xref:BloombergLP/ball/RecordFormatterFunctor/Type.adoc[RecordFormatterFunctor::Type]* result,
    std::string_view const& format,
    xref:BloombergLP/ball/RecordFormatterOptions.adoc[RecordFormatterOptions] const& formatOptions);
----


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