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 </r> | ||
+ | (- #c(3 -5)) <r>#C(-3 5) </r> | ||
+ | (- 0) <r>0 </r> | ||
+ | ([[CL:Functions:eql]] (- 0.0) -0.0) <r>//[[CL:Glossary:true]]// </r> | ||
+ | (- #c(100 45) #c(0 45)) <r>100 </r> | ||
+ | (- 10 1 2 3 4) <r>0 </r> | ||
+ | </blockquote> | ||
+ | |||
+ | ====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. | ||