[#BloombergLP-ball-Log-getRecord]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/ball.adoc[ball]::xref:BloombergLP/ball/Log.adoc[Log]::getRecord
:relfileprefix: ../../../
:mrdocs:

Return a modifiable record with the specified file and line.

== Synopsis

Declared in `<ball_log.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/ball/Record.adoc[Record]*
getRecord(
    xref:BloombergLP/ball/Category.adoc[Category] const* category,
    std::string_view const& fileName,
    int lineNumber);
----

== Description

Return the address of a modifiable record having the specified `fileName` and `lineNumber` attributes. The memory for the record will be supplied by the allocator held by the logger manager singleton if the specified `category` is non‐null, or by the currently installed default allocator otherwise. The behavior is undefined unless the logger manager singleton is initialized when `category` is non‐null. Note that the returned `Record` must subsequently be supplied to a call to the 3‐argument `logMessage` method.

== Return Value

address of a modifiable record with the given attributes

== Parameters

[cols="1,4"]
|===
| Name| Description
| *category*
| category used to select the record allocator, or 0
| *fileName*
| source file name attribute for the record
| *lineNumber*
| source line number attribute for the record
|===


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