[#BloombergLP-bsls-Util-forward-09]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bsls.adoc[bsls]::xref:BloombergLP/bsls/Util.adoc[Util]::forward
:relfileprefix: ../../../
:mrdocs:

Forward the specified `t` as a reference of non‐deduced `TYPE`.

== Synopsis

Declared in `<bsls_util.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class TYPE>
constexpr
static
TYPE&&
forward(Util_RemoveReference<TYPE>::type&& t) noexcept;
----

== Description

Return a reference to the specified `t` of non‐deduced `TYPE`. If `TYPE` is an lvalue‐reference type, then the result will be an lvalue‐reference, and an rvalue‐refernce otherwise. Note that as `TYPE` is not deduced, it must be explicitly specified by the caller of this function. Also note that while this function may return an rvalue‐reference, it cannot extend the lifetime of temporaries beyond the expression that calls this function; storing an rvalue reference to the result will lead to undefined behavior.

== Return Value

reference to `t` of non‐deduced `TYPE`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *t*
| object to forward
|===


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