[ Arithmetic | Reference Manual | Alphabetic Index ]
-(+Number1, +Number2, -Result)
-Result is +Number1 - +Number2
Evaluates the difference Number1 - Number2 and unifies the resulting value
with Result.
- Number1
- A number.
- Number2
- A number.
- Result
- Output: a number.
Description
Evaluates the difference Number1 - Number2 and unifies the resulting value
with Result.
The result is of type breal if any of the arguments is a breal,
else float if any of the arguments is a float, else rational if any
of the arguments is a rational. Only when both arguments are
integers is the result an integer.
This predicate can be used as a function in arithmetic expressions.
In coroutining mode, if Number1 or Number2 are uninstantiated, the call
to -/3 is delayed until these variables are instantiated.
Modes and Determinism
Exceptions
- (4) instantiation fault
- Number1 or Number2 is not instantiated (non-coroutining mode only).
- (24) number expected
- Number1 or Number2 is not of a numeric type.
Examples
Result is 5 - 2. % gives Result = 3
Result is 5 - -2.0. % gives Result = 7.0
See Also
is / 2