UnknownStatistic class: Difference between revisions
mNo edit summary |
mNo edit summary |
||
Line 43: | Line 43: | ||
{{Template:UnknownStatistic:New subtitle}} | {{Template:UnknownStatistic:New subtitle}} | ||
This | This <var>Constructor</var> generates an instance of an <var>[[UnknownStatistic_class|UnknownStatistic]]</var> exception. As shown below, the required argument of the <var>New</var> method is a specific string value that is ''not'' the name of a valid or appropriate <var class="product">Model 204</var> user statistic for the method that is being called. | ||
<h3>Syntax</h3> | <h3>Syntax</h3> | ||
Line 52: | Line 52: | ||
<td>An <var>[[UnknownStatistic_class|UnknownStatistic]]</var> object variable. | <td>An <var>[[UnknownStatistic_class|UnknownStatistic]]</var> object variable. | ||
</td></tr> | </td></tr> | ||
<tr><th><var>%(UnknownStatistic)</var></th><td>The class name in parentheses denotes a | <tr><th><var>%(UnknownStatistic)</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors|Constructor]]</var>.</td></tr> | ||
<tr><th><var>Name</var></th> | <tr><th><var>Name</var></th> | ||
<td>This [[Methods#Named parameters|name required]] parameter specifies the string value (<var class="term">string</var>) that is the name of the statistic for which you are providing the exception. | <td>This [[Methods#Named parameters|name required]] parameter specifies the string value (<var class="term">string</var>) that is the name of the statistic for which you are providing the exception. |
Revision as of 21:12, 27 July 2011
The UnknownStatistic exception class describes an exception associated with finding a string identifier that is not a valid or not an appropriate Model 204 statistic name.
To produce an UnknownStatistic exception for yourself, you typically use a User Language Throw statement with the New UnknownStatistic constructor. For example, the following statement throws an UnknownStatistic exception for the value ABCD
:
throw %(unknownStatistic):new(Name='abcd')
In addition to the New constructor that creates an object instance, the class includes a Name property that returns the invalid statistic name.
The UnknownStatistic class is available as of Sirius Mods version 7.3.
The UnknownStatistic methods
The following are the available UnknownStatistic class methods.
Method | Description |
---|---|
Name | Name of statistic not recognized by the method |
New | Create a new UnknownStatistic object |
The methods in the class are described in the subsections that follow. In addition:
- "Notation conventions for methods" has information about the conventions followed.
- "UnknownStatistic methods syntax" is a single page that contains the syntax diagrams of all the methods in the class.
Name property
Name of statistic not recognized by the method (UnknownStatistic class)
This ReadOnly property returns a string that contains the name of the statistic that is not recognized by the calling method.
Syntax
%string = unknownStatistic:Name
Syntax terms
%string | This string variable is to contain the name of the unrecognized statistic. |
---|---|
unknownStatistic | An UnknownStatistic object variable. |
New constructor
Create a new UnknownStatistic object (UnknownStatistic class)
This Constructor generates an instance of an UnknownStatistic exception. As shown below, the required argument of the New method is a specific string value that is not the name of a valid or appropriate Model 204 user statistic for the method that is being called.
Syntax
%unknownStatistic = [%(UnknownStatistic):]New( Name= string)
Syntax terms
%unknownStatistic | An UnknownStatistic object variable. |
---|---|
%(UnknownStatistic) | The class name in parentheses denotes a Constructor. |
Name | This name required parameter specifies the string value (string) that is the name of the statistic for which you are providing the exception. |