====== decr ======

===== Description =====

Decrement the value of an integer.

===== Function prototype =====

<code>
int64 incr <varref:Var>
</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| Var | varref | A reference to the integer variable to be decremented.  |

===== Return value =====

The value of Var after it was decremented by 1. 

===== Example =====

<code>
// create a new integer 'i', and set it to 10
int i
set i 10

// decrement the value of 'i' four times, and echo to log 
echo <zs:decr i>
echo <zs:decr i>
echo <zs:decr i>
echo <zs:decr i>
</code>

... the output of which is written to the event log by [[plugins:general:zeoscript:reference:functions:echo]] as:

<file>
9
8
7
6
</file>

===== Comments =====


==== Supported types ====

The following variable types of the argument //Var// are supported by ''decr'': 
  * char
  * sbyte (signed byte)
  * byte
  * short
  * ushort
  * int
  * uint
  * int64

===== See also =====

  * [[plugins:general:zeoscript:reference:functions:incr]]
  * [[plugins:general:zeoscript:reference:functions:sub]]