[#BloombergLP-bsls-AtomicOperations-subtractIntNv]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bsls.adoc[bsls]::xref:BloombergLP/bsls/AtomicOperations.adoc[AtomicOperations]::subtractIntNv
:relfileprefix: ../../../
:mrdocs:

Atomically subtract from `atomicInt` and return the result.

== Synopsis

Declared in `<bsls_atomicoperations.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
subtractIntNv(
    xref:BloombergLP/bsls/Atomic_TypeTraits-0b/Int.adoc[AtomicTypes::Int]* atomicInt,
    int value);
----

== Description

Atomically subtract from the specified `atomicInt` the specified `value` and return the resulting value, providing the sequential consistency memory ordering guarantee.

== Return Value

value of `atomicInt` after the subtraction

== Parameters

[cols="1,4"]
|===
| Name| Description
| *atomicInt*
| atomic integer to modify
| *value*
| amount to subtract
|===


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