RequestValue (UserStatistics function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (match syntax table to syntax template, tags and edits)
Line 1: Line 1:
{{Template:UserStatistics:RequestValue subtitle}}
{{Template:UserStatistics:RequestValue subtitle}}
<var>RequestValue</var> returns the value of a <var>[[UserStatistics class#request|Request]]</var> statistic.


This function returns the value of a [[UserStatistics class#request|Request statistic]].
The method cancels the request if it is applied to a statistic
that is exclusively a [[UserStatistics class#login|Login]]
(also called Final) statistic.
==Syntax==
==Syntax==
{{Template:UserStatistics:RequestValue syntax}}
{{Template:UserStatistics:RequestValue 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 that is contained in the method object. </td></tr>
<td>A numeric variable to contain the value of the specified statistic that is contained in the method object. </td></tr>
<tr><th><i>%ustat</i></th>
<tr><th>userStatistics</th>
<td>A UserStatistics object variable. </td></tr>
<td>A <var>UserStatistics</var> object variable. </td></tr>
<tr><th><i>statistic</i></th>
<tr><th>string</th>
<td>This case-independent string contains the name of a ''Model 204'' user statistic. Only the names of ''Model 204'' Request statistics are valid. All other names return an UnknownStatistic exception.</td></tr>
<td>This case-independent string contains the name of a <var class="product">Model 204</var> user statistic. Only the names of <var class="product">Model 204</var> <var>Request</var> statistics are valid. All other names return an <var>[[UnknownStatistic_class|UnknownStatistic]]</var> exception.</td></tr>
</table>
</table>
==Usage notes==
==Usage notes==
<ul>
<ul>
<li>The [[Value (UserStatistics function)|Value]] function returns the value of a
<li><var>RequestValue</var> cancels the request if it is applied to a statistic that is exclusively a <var>[[UserStatistics class#login|Login]]</var> (also called "Final") statistic.
''Model 204'' user Login statistic.
</ul>
</ul>
==Examples==
==Examples==
 
<ol><li>The following statements assign and print a <var>Request</var> statistic value:
The following statements respectively assign
and print a Request statistic value:
<p class="code">%num = %stat:requestValue('dkpr')
<p class="code">%num = %stat:requestValue('dkpr')
   
   
printText PDL highwater mark: {%stat:requestValue('PDL')}
[[PrintText statement|printText]] PDL highwater mark: {%stat:requestValue('PDL')}
</p>
</p></ol>
 
==See also==
==See also==
<ul><li><var>[[Value (UserStatistics function)|Value]]</var> returns the value of a <var class="product">Model 204</var> user <var>Login</var> statistic.
</ul>
{{Template:UserStatistics:RequestValue footer}}
{{Template:UserStatistics:RequestValue footer}}

Revision as of 10:18, 31 March 2011

Value of the specified Request statistic (UserStatistics class)

RequestValue returns the value of a Request statistic.

Syntax

%number = userStatistics:RequestValue( string) Throws UnknownStatistic

Syntax terms

%number A numeric variable to contain the value of the specified statistic that is contained in the method object.
userStatistics A UserStatistics object variable.
string This case-independent string contains the name of a Model 204 user statistic. Only the names of Model 204 Request statistics are valid. All other names return an UnknownStatistic exception.

Usage notes

  • RequestValue cancels the request if it is applied to a statistic that is exclusively a Login (also called "Final") statistic.

Examples

  1. The following statements assign and print a Request statistic value:

    %num = %stat:requestValue('dkpr') printText PDL highwater mark: {%stat:requestValue('PDL')}

See also

  • Value returns the value of a Model 204 user Login statistic.