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. |