Subtracts one value from another and produces their difference.
SDK
- Xcode 9.0+
Framework
- Swift Standard Library
Declaration
Parameters
lhs
A numeric value.
rhs
The value to subtract from
lhs
.
Discussion
The subtraction operator (-
) calculates the difference of its two arguments. For example:
You cannot use -
with arguments of different types. To subtract values of different types, convert one of the values to the other value’s type.
The difference of the two arguments must be representable in the arguments’ type. In the following example, the result of 21 - 50
is less than zero, the minimum representable UInt8
value:
Note
Overflow checking is not performed in -Ounchecked
builds.
If you want to opt out of overflow checking and wrap the result in case of any overflow, use the overflow subtraction operator (&-
).