$IncStat: Difference between revisions
m (1 revision) |
m (1 revision) |
||
Line 13: | Line 13: | ||
==Syntax== | ==Syntax== | ||
<p class="syntax"><section begin="syntax" /> %VALUE = $IncStat(stat_num, value) | <p class="syntax"><section begin="syntax" />%VALUE = $IncStat(stat_num, value) | ||
<section end="syntax" /></p> | <section end="syntax" /></p> | ||
<p class="caption">$IncStat Function | <p class="caption">$IncStat Function |
Revision as of 20:32, 24 October 2012
Increment local system statistic
Most Sirius $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $IncStat function.
This function allows a user to increment the current value of a local system statistic. There are 10 local system statistics that can be incremented with $IncStat. These stats can be examined via $SyStat under the names LOCAL0 through LOCAL9.
The $IncStat function accepts two arguments and returns either the new value of the appropriate local statistic or a 0 if there is an error.
The first argument is a number that indicates the local stat number to be incremented. This number must be 0 through 9. Otherwise, the $IncStat performs no action and returns a 0.
The second argument is a number that indicates the value that will be added to the local stat. This is an optional argument and defaults to 1.
Syntax
<section begin="syntax" />%VALUE = $IncStat(stat_num, value) <section end="syntax" />
For example, the code fragment
%VALUE = $IncStat(2)
adds 1 to local stat number 2.