[#BloombergLP-ball-CstdioObserver-setFormatFunctor]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/ball.adoc[ball]::xref:BloombergLP/ball/CstdioObserver.adoc[CstdioObserver]::setFormatFunctor
:relfileprefix: ../../../
:mrdocs:

Set the record formatting functor used by this observer.

== Synopsis

Declared in `<ball_cstdioobserver.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
setFormatFunctor(xref:BloombergLP/ball/CstdioObserver/RecordFormatter.adoc[RecordFormatter] const& formatter);
----

== Description

Note that a default format ("n%d %p %t %s %f %l %c %m %un") is in effect until this method or `setFormat` is called (see `ball_recordstringformatter`). Also note that the observer emits newline characters at the beginning and at the end of a log record by default, so the user needs to add them explicitly to the format string to preserve this behavior. Note that this method is not able to communicate the timezone default settings to the `formatter`, prefer `setFormat`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *formatter*
| functor that formats a log record for output
|===


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