Futurebasic/Language/Reference/dec

DEC statement edit

DEC edit

Statement edit

✔ Appearance ✔ Standard ✔ Console

Syntax edit

DEC(intVar)
numericVariable --
numericVariable -= valueToSubtract

Revised edit

May 30, 2000 (Release 3)

Description edit

This statement decrements intVar by 1 (or by valueToSubtract); that is, it subtracts 1 from the value of intVar, and stores the value back into intVar. intVar must be a (signed or unsigned) byte variable, short-integer variable or long-integer variable. If intVar is already at the minimum value for its variable type, then DEC(intVar) will cycle it back to its maximum value. As of Release 3, FB supports the use of -= to decrease the value of a variable by a specified amount.

Example edit

DEC(x&)

and...

x& -= 1

and...

x& --

...are all equivalent to:

x& = x& - 1

The following expressions are also equivalent:

x& = x& - 100
x& -= 100

Note edit

The -= syntax may not be used for arrays of strings, containers, or records where arrays are involved, only numeric values may take advantage of this syntax.

See Also edit

INC; DEC LONG/WORD/BYTE; DEF CYCLE