[#BloombergLP-balb-ReservationGuard-cancelReserved]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balb.adoc[balb]::xref:BloombergLP/balb/ReservationGuard.adoc[ReservationGuard]::cancelReserved
:relfileprefix: ../../../
:mrdocs:

Cancel the specified `numUnits` from the reserve units guarded by this object&period;

== Synopsis

Declared in `&lt;balb&lowbar;reservationguard&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
cancelReserved(xref:BloombergLP/bsls/Types/Uint64.adoc[bsls::Types::Uint64] numUnits);
----

== Description

Subtract the `numUnits` from `unitsReserved` and invoke the `cancelReserved` method on the guarded object for `numUnits`&period; After this operation, the number of reserved units guarded by this object will be reduced by `numUnits`&period; The behavior is undefined unless `numUnits &lt;&equals; unitsReserved()`&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *numUnits*
| number of previously reserved units to cancel
|===


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