ToString (UserStatistics function): Difference between revisions
Jump to navigation
Jump to search
m (→Examples) |
mNo edit summary |
||
| (12 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
{{Template:UserStatistics:ToString subtitle}} | {{Template:UserStatistics:ToString subtitle}} | ||
<var>ToString</var> returns the values of the statistics in the method <var>UserStatistics</var> object. By default, it will only return statistics with non-zero values; but, as an option, it may return all (including zero) statistics. | |||
==Syntax== | ==Syntax== | ||
{{Template:UserStatistics:ToString syntax}} | {{Template:UserStatistics:ToString syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
< | <table class="syntaxTable"> | ||
< | <tr><th>%string</th> | ||
< | <td>A <var>[[Longstrings|longstring]]</var> variable to receive the listing of the values of the statistics. </td></tr> | ||
statistics. | |||
< | <tr><th>userStatistics</th> | ||
< | <td>A <var>UserStatistics</var> object variable. </td></tr> | ||
< | |||
< | <tr><th><var>Zeros</var></th> | ||
that indicates whether statistics with a zero value should be included | <td>This [[Notation conventions for methods#Named parameters|name required]] argument is a <var>[[Enumerations#Using Boolean enumerations|Boolean]]</var> value that indicates whether statistics with a zero value should be included in the returned data. <var>Zeros</var> is an optional argument that defaults to <var>False</var>, which results in the inclusion of only statistics with non-zero values.</td></tr> | ||
in the returned data. | |||
Zeros is an optional argument that defaults to < | <tr><th><var>NamesToLower</var></th> | ||
results in the inclusion of only statistics with non-zero values. | <td>This name required argument is a <var>Boolean</var> value that indicates whether the returned <var class="product">Model 204</var> statistic names, which are normally all-uppercase, should be returned as lowercase. This is an optional argument which defaults to <var>False</var>.</td></tr> | ||
</table> | |||
==Usage notes== | ==Usage notes== | ||
<ul> | <ul> | ||
<li> | <li><var>ToString</var> can be applied implicitly: simply <var>Print</var> (or <var>Audit</var>) an object variable, and the <var>ToString</var> method is automatically applied to the object. That is: | ||
simply Print (or Audit) an object variable, and | <p class="code">print %statobject</p> is equivalent to: <p class="code">print %statobject:ToString</p> | ||
the ToString method is automatically applied to the object. | |||
< | |||
</ul> | </ul> | ||
==Examples== | ==Examples== | ||
The following display of non-zero [[UserStatistics class#login|Login]] and [[UserStatistics class#request|Request]] statistics is produced by a | |||
The following display of non-zero Login and Request statistics is produced by a | <p class="code">print %ustat</p> statement: | ||
< | <p class="output">time='20080730102646772' userNumber=6 loginTime='20080730102645880' login: cnct=1 sqrd=29 sqwr=4 sgmto=27 cpu=890 - | ||
req=1 move=97 slic=71 audit=32 dkar=253 dkpr=124751 pcpu=996 objswap=250247 request: ntbl=10 qtbl=29 stbl=524 vtbl=51 pdl=508 cnct=1 - | |||
cpu=887 out=1 slic=71 pcpu=996 rqtm=889 dkpr=124750 objswap=250247 | |||
<p class=" | |||
req=1 move=97 slic=71 audit=32 dkar=253 dkpr=124751 pcpu= | |||
996 objswap=250247 request: ntbl=10 qtbl=29 stbl=524 vtbl | |||
=51 pdl=508 cnct=1 cpu=887 out=1 slic=71 pcpu=996 rqtm= | |||
</p> | </p> | ||
A <code>print %ustat:ToString(Zeros=true)</code> statement would print all the statistics, including those with a <code>0</code> value. | |||
==See also== | ==See also== | ||
<ul> | |||
<li><var>[[LoginToString (UserStatistics function)|LoginToString]]</var> returns the values of the Login statistics in the <var>UserStatistics</var> object. | |||
<li><var>[[RequestToString (UserStatistics function)|RequestToString]]</var> returns the values of the Request statistics in the object. | |||
</ul> | |||
{{Template:UserStatistics:ToString footer}} | {{Template:UserStatistics:ToString footer}} | ||
Latest revision as of 22:08, 20 November 2012
Print UserStatistics values (UserStatistics class)
ToString returns the values of the statistics in the method UserStatistics object. By default, it will only return statistics with non-zero values; but, as an option, it may return all (including zero) statistics.
Syntax
%string = userStatistics:ToString[( [Zeros= boolean], [NamesToLower= boolean])]
Syntax terms
| %string | A longstring variable to receive the listing of the values of the statistics. |
|---|---|
| userStatistics | A UserStatistics object variable. |
| Zeros | This name required argument is a Boolean value that indicates whether statistics with a zero value should be included in the returned data. Zeros is an optional argument that defaults to False, which results in the inclusion of only statistics with non-zero values. |
| NamesToLower | This name required argument is a Boolean value that indicates whether the returned Model 204 statistic names, which are normally all-uppercase, should be returned as lowercase. This is an optional argument which defaults to False. |
Usage notes
- ToString can be applied implicitly: simply Print (or Audit) an object variable, and the ToString method is automatically applied to the object. That is:
print %statobject
is equivalent to:print %statobject:ToString
Examples
The following display of non-zero Login and Request statistics is produced by a
print %ustat
statement:
time='20080730102646772' userNumber=6 loginTime='20080730102645880' login: cnct=1 sqrd=29 sqwr=4 sgmto=27 cpu=890 - req=1 move=97 slic=71 audit=32 dkar=253 dkpr=124751 pcpu=996 objswap=250247 request: ntbl=10 qtbl=29 stbl=524 vtbl=51 pdl=508 cnct=1 - cpu=887 out=1 slic=71 pcpu=996 rqtm=889 dkpr=124750 objswap=250247
A print %ustat:ToString(Zeros=true) statement would print all the statistics, including those with a 0 value.
See also
- LoginToString returns the values of the Login statistics in the UserStatistics object.
- RequestToString returns the values of the Request statistics in the object.