### User Tools

A PCRE internal error occured. This might be caused by a faulty plugin

# Differences

This shows you the differences between two versions of the page.

 cl:functions:math-subtract [2019/09/14 05:00] cl:functions:math-subtract [2021/01/26 04:00] (current) Line 1: Line 1: + ====== Function - ====== + + ====Syntax==== + * **-** //number// → //​negation//​ + * **-** //minuend ''&​rest''​ subtrahends''​+''//​ → //​difference//​ + + ====Arguments and Values==== + * //number//, //​minuend//,​ //​subtrahend//​ - a //​[[CL:​Glossary:​number]]//​. + * //​negation//,​ //​difference//​ - a //​[[CL:​Glossary:​number]]//​. + + ====Description==== + The //​[[CL:​Glossary:​function]]//​ **[[CL:​Functions:​-]]** performs arithmetic subtraction and negation. + + If only one //number// is supplied, the negation of that //number// is returned. + + If more than one //​[[CL:​Glossary:​argument]]//​ is given, it subtracts all of the //​subtrahends//​ from the //minuend// and returns the result. + + The //​[[CL:​Glossary:​function]]//​ **[[CL:​Functions:​-]]** performs necessary type conversions. + + ====Examples==== + <​blockquote>​ + (- 55.55) <​r>​-55.55 + (- #c(3 -5)) <​r>#​C(-3 5) + (- 0) 0 + ([[CL:​Functions:​eql]] (- 0.0) -0.0) <​r>//​[[CL:​Glossary:​true]]//​ + (- #c(100 45) #c(0 45)) <​r>​100 + (- 10 1 2 3 4) 0 + ​ + + ====Affected By==== + None. + + ====Exceptional Situations==== + Might signal **[[CL:​Types:​type-error]]** if some //​[[CL:​Glossary:​argument]]//​ is not a //​[[CL:​Glossary:​number]]//​. Might signal **[[CL:​Types:​arithmetic-error]]**. + + ====See Also==== + * {\secref\NumericOperations} + * {\secref\RationalComputations} + * {\secref\FloatingPointComputations} + * {\secref\ComplexComputations} + + ====Notes==== + None.