[#BloombergLP-bdldfp-operator_minus-02c]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdldfp.adoc[bdldfp]::operator‐
:relfileprefix: ../../
:mrdocs:

Subtract the specified `rhs` from the value of the specified `lhs` as described by IEEE‐754 and return a reference to this object.

== Synopsis

Declared in `<bdldfp_decimal.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bdldfp/Decimal128.adoc[bdldfp::Decimal128]
operator‐(
    xref:BloombergLP/bdldfp/Decimal128.adoc[Decimal128] lhs,
    int rhs);
----

== Description

* If `lhs` is signaling NaN, then store the value of the macro `EDOM` into `errno` and return a NaN. * Otherwise if `lhs` is NaN, then return a NaN. * Otherwise if `lhs` is infinity, then return infinity. * Otherwise if subtracting `rhs` from `lhs` object's value results in an absolute value that is larger than `std::numeric_limits<Decimal128>::max()` then store the value of the macro `ERANGE` into `errno` and return infinity with the same sign as that result. * Otherwise return the result of subtracting `rhs` from the value of `lhs`.


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