[#BloombergLP-bdlat-NullableValueUtil-manipulateValueByCategory]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlat.adoc[bdlat]::xref:BloombergLP/bdlat/NullableValueUtil.adoc[NullableValueUtil]::manipulateValueByCategory
:relfileprefix: ../../../
:mrdocs:

Invoke a categorized manipulator on the value held by a nullable object.

== Synopsis

Declared in `<bdlat_nullablevalueutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class TYPE,
    class MANIPULATOR>
static
int
manipulateValueByCategory(
    TYPE* object,
    MANIPULATOR& manipulator);
----

== Description

Invoke the specified `manipulator` on the address of the value stored in the specified "nullable" `object` and on a prvalue of the category tag type for the dynamic category of the value. See {`bdlat_typecategory`|Category Tags and Enumerators} for documentation about category tags. Return the value from the invocation of `manipulator`. The `manipulator` must be a manipulator functor. See {`bdlat_typecategory`|`MANIPULATOR` Functors} for the requirements on `manipulator`. The behavior is undefined if `object` contains a null value.

== Return Value

value from the invocation of `manipulator`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *object*
| "nullable" object whose held value is manipulated
| *manipulator*
| functor applied to the held value with a category tag
|===


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