UnknownStatistic class: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
m (link repair)
 
Line 2: Line 2:
The <var>UnknownStatistic</var> exception class describes an exception associated with finding a string identifier that is not a valid or not an appropriate <var class="product">Model 204</var> statistic name.
The <var>UnknownStatistic</var> exception class describes an exception associated with finding a string identifier that is not a valid or not an appropriate <var class="product">Model 204</var> statistic name.
   
   
To produce an <var>UnknownStatistic</var> exception for yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions|Throw]]</var> statement with the <var>[[New (UnknownStatistic constructor)|New]]</var> <var>UnknownStatistic</var> constructor. For example, the following statement throws an <var>UnknownStatistic</var> exception for the value <code>ABCD</code>:
To produce an <var>UnknownStatistic</var> exception for yourself, you typically use a <var class="product">SOUL</var> <var>[[Exceptions#Throwing exceptions|Throw]]</var> statement with the <var>[[New (UnknownStatistic constructor)|New]]</var> <var>UnknownStatistic</var> constructor. For example, the following statement throws an <var>UnknownStatistic</var> exception for the value <code>ABCD</code>:
<p class="code">throw %(unknownStatistic):new(Name='abcd')
<p class="code">throw %(unknownStatistic):new(Name='abcd')
</p>
</p>
Line 16: Line 16:
The methods in the class are described in the subsections that follow. In addition:
The methods in the class are described in the subsections that follow. In addition:
<ul>
<ul>
<li>[[Notation conventions for methods|"Notation conventions for methods"]] has information
<li>[[Notation conventions for methods]] has information about the conventions followed. </li>
about the conventions followed.  
<li>[[UnknownStatistic methods syntax]] is a single page that contains the syntax diagrams of all the methods in the class. </li>
<li>[[UnknownStatistic methods syntax|"UnknownStatistic methods syntax"]] is a single page that contains the syntax diagrams of all the methods in the class.
</ul>
</ul>


Line 63: Line 62:
===Usage notes===
===Usage notes===
<ul>
<ul>
<li>As described in [[Object variables#Using New or other Constructors|"Using New or other Constructors"]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%unknown = new(Name='MYSTAT')
<li>As described in [[Object variables#Using New or other Constructors|Using New or other Constructors]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%unknown = new(Name='MYSTAT')


%unknown = %(UnknownStatistic):new(Name='MYSTAT')
%unknown = %(UnknownStatistic):new(Name='MYSTAT')


%unknown = %unknown:new(Name='MYSTAT')
%unknown = %unknown:new(Name='MYSTAT')
</p>
</p></li>
</ul>
</ul>


[[Category:System exception classes]]
[[Category:System exception classes]]

Latest revision as of 21:56, 18 November 2014

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

MethodDescription
NameName of statistic not recognized by the method
NewCreate a new UnknownStatistic object

The methods in the class are described in the subsections that follow. In addition:


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. See "Usage notes", below, for more information about invoking an UnknownStatistic 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.

Usage notes

  • As described in Using New or other Constructors, New can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is Null:

    %unknown = new(Name='MYSTAT') %unknown = %(UnknownStatistic):new(Name='MYSTAT') %unknown = %unknown:new(Name='MYSTAT')