[#BloombergLP-baljsn-EncoderTestChoiceWithAllCategories-manipulateSelection]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/baljsn.adoc[baljsn]::xref:BloombergLP/baljsn/EncoderTestChoiceWithAllCategories.adoc[EncoderTestChoiceWithAllCategories]::manipulateSelection
:relfileprefix: ../../../
:mrdocs:

Invoke `manipulator` on the address of the current selection.

== Synopsis

Declared in `<baljsn_encoder_testtypes.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<typename t_MANIPULATOR>
int
manipulateSelection(t_MANIPULATOR& manipulator);
----

== Description

Invoke the specified 'manipulator' on the address of the modifiable selection, supplying 'manipulator' with the corresponding selection information structure. Return the value returned from the invocation of 'manipulator' if this object has a defined selection, and ‐1 otherwise.

== Return Value

the value returned from the invocation of `manipulator`, or a non‐zero value on failure

== Parameters

[cols="1,4"]
|===
| Name| Description
| *manipulator*
| functor invoked on the current selection
|===


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