[#BloombergLP-bsls-TimeUtil-getThreadUserTimer]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bsls.adoc[bsls]::xref:BloombergLP/bsls/TimeUtil.adoc[TimeUtil]::getThreadUserTimer
:relfileprefix: ../../../
:mrdocs:

Return the current thread user CPU time in nanoseconds.

== Synopsis

Declared in `<bsls_timeutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/bsls/Types/Int64.adoc[Types::Int64]
getThreadUserTimer();
----

== Description

Return the instantaneous values of a platform‐dependent timer for the current thread user time in absolute nanoseconds referenced to an arbitrary but fixed origin. Return ‐1 on platforms where per‐thread CPU timers are unavailable or in case of a system call failure. Note that this method is thread‐safe only if `initialize` has been called before.

== Return Value

thread user CPU time in nanoseconds, or ‐1 on failure


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