Value (UserStatistics function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
mNo edit summary
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:UserStatistics:Value subtitle}}
{{Template:UserStatistics:Value subtitle}}
<var>Value</var> returns the value of a <var class="product">Model 204</var> user [[UserStatistics class#login|Login]] (also called "Final") statistic.


This method returns the value of a ''Model 204'' user [[UserStatistics class#login|Login]]
(also called &amp;amp;ldquo;Final&amp;amp;rdquo;) statistic.
The method cancels the request if it is applied to a statistic
that is exclusively a [[UserStatistics class#request|Request statistic]].
==Syntax==
==Syntax==
{{Template:UserStatistics:Value syntax}}
{{Template:UserStatistics:Value syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th><i>%val</i></th>
<tr><th>%number</th>
<td>A numeric variable to contain the value of the specified statistic contained in the method object. </td></tr>
<td>A numeric variable that will be assigned the value of the specified statistic contained in the method object.</td></tr>
<tr><th><i>%ustat</i></th>
 
<td>A UserStatistics object variable. </td></tr>
<tr><th>userStatistics</th>
<tr><th><i>statistic</i></th>
<td>A <var>UserStatistics</var> object variable. </td></tr>
<td>This case-independent string contains the name of a ''Model 204'' user statistic. The names of final or partial statistics available to the ''Model 204'' $STAT function are valid. The OBJSWAP statistic for [[Janus SOAP]] objects is also valid. All other names return an UnknownStatistic exception.</td></tr>
 
<tr><th>string</th>
<td>This case-independent string contains the name of a <var class="product">Model 204</var> user statistic. The names of all "final" or "partial" statistics supported by the <var class="product">Model 204</var> $STAT function are valid. The <var>OBJSWAP</var> statistic for <var class="product">[[Janus SOAP]]</var> objects is also valid. All other names return an <var>[[UnknownStatistic_class|UnknownStatistic]]</var> exception.</td></tr>
</table>
</table>
==Usage notes==
==Usage notes==
<ul>
<ul>
<li>The statistics UpdtTime(MS) and LongupdTime(MS) can also be specified
<li><var>Value</var> cancels the request if it is applied to a statistic that is exclusively a [[UserStatistics class#request|Request]] statistic.
without the parentheses: for example,
<li>The statistics <var>UpdtTime(MS)</var> and <var>LongupdTime(MS)</var> can also be specified without the parentheses: for example, <code>UpdtTimeMs</code> and <code>LongUpdtimeMs</code>, respectively.
UpdtTimeMs and LongUpdtimeMs, respectively.
<li>The [[RequestValue (UserStatistics function)|RequestValue]] function returns the value of a
''Model 204'' request statistic.
</ul>
</ul>
==Examples==
==Examples==
 
The following statements validly assign and print statistic values:  
The following statements validly assign and print statistic values:
<p class="code">%cpu = %stat:value('cpu')
<p class="code">%cpu = %stat:value('cpu')


printText Object swaps: {%stat:value('OBJSWAP')}
[[PrintText statement|printText]] Object swaps: {%stat:value('OBJSWAP')}
</p>
</p>
==See also==
==See also==
<ul>
<li><var>[[RequestValue (UserStatistics function)|RequestValue]]</var> returns the value of a <var class="product">Model 204</var> Request statistic.</ul>
{{Template:UserStatistics:Value footer}}
{{Template:UserStatistics:Value footer}}

Latest revision as of 22:27, 20 November 2012

Value of the specified Login statistic (UserStatistics class)

Value returns the value of a Model 204 user Login (also called "Final") statistic.

Syntax

%number = userStatistics:Value( string) Throws UnknownStatistic

Syntax terms

%number A numeric variable that will be assigned the value of the specified statistic contained in the method object.
userStatistics A UserStatistics object variable.
string This case-independent string contains the name of a Model 204 user statistic. The names of all "final" or "partial" statistics supported by the Model 204 $STAT function are valid. The OBJSWAP statistic for Janus SOAP objects is also valid. All other names return an UnknownStatistic exception.

Usage notes

  • Value cancels the request if it is applied to a statistic that is exclusively a Request statistic.
  • The statistics UpdtTime(MS) and LongupdTime(MS) can also be specified without the parentheses: for example, UpdtTimeMs and LongUpdtimeMs, respectively.

Examples

The following statements validly assign and print statistic values:

%cpu = %stat:value('cpu') printText Object swaps: {%stat:value('OBJSWAP')}

See also

  • RequestValue returns the value of a Model 204 Request statistic.