WOLFRAM

Wolfram Language & System Documentation Center

x--

decreases the value of x by 1, returning the old value of x.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Applications  
Properties & Relations  
Possible Issues  
See Also
Tech Notes
Related Guides
History
Cite this Page

Decrement

x--

decreases the value of x by 1, returning the old value of x.

Details

Examples

open all close all

Basic Examples  (1)

Decrement the value of k by one, but return the old value:

Scope  (4)

Decrement a numerical value:

Decrement a symbolic value:

Decrement all values in a list:

The argument to Decrement need not be a symbol:

Applications  (1)

Find the largest prime smaller than a given number:

Properties & Relations  (4)

Decrement and PreDecrement differ in the return value of the operation:

Decrement is a short form of this assignment:

Decrement is a special case of SubtractFrom:

Increment and PreIncrement are closely related operations:

Possible Issues  (1)

A variable to be decremented must have an initial value:

Wolfram Research (1988), Decrement, Wolfram Language function, https://reference.wolfram.com/language/ref/Decrement.html.

Text

Wolfram Research (1988), Decrement, Wolfram Language function, https://reference.wolfram.com/language/ref/Decrement.html.

CMS

Wolfram Language. 1988. "Decrement." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/Decrement.html.

APA

Wolfram Language. (1988). Decrement. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Decrement.html

BibTeX

@misc{reference.wolfram_2025_decrement, author="Wolfram Research", title="{Decrement}", year="1988", howpublished="\url{https://reference.wolfram.com/language/ref/Decrement.html}", note=[Accessed: 08-August-2025]}

BibLaTeX

@online{reference.wolfram_2025_decrement, organization={Wolfram Research}, title={Decrement}, year={1988}, url={https://reference.wolfram.com/language/ref/Decrement.html}, note=[Accessed: 08-August-2025]}