InvalidSortSpecification class: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
 
mNo edit summary
 
Line 6: Line 6:
   
   
This exception class has no properties.
This exception class has no properties.
The class's only method is the <var>[[New (InvalidSortSpecification constructor)|New]]</var> constructor, which you would typically use with a <var class="product">User Language</var> <var>[[Throw statement|Throw]]</var> statement to produce an <var>InvalidSortSpecification</var> exception yourself. For example:
The class's only method is the <var>[[New (InvalidSortSpecification constructor)|New]]</var> constructor, which you would typically use with a <var class="product">SOUL</var> <var>[[Throw statement|Throw]]</var> statement to produce an <var>InvalidSortSpecification</var> exception yourself. For example:
<p class="code">throw %(invalidSortSpecification):new
<p class="code">throw %(invalidSortSpecification):new
</p>
</p>
Line 25: Line 25:
be correct in all circumstances, and if it is not, you want a request cancellation. So you do <b>not</b> provide a <code>try.../catch</code> block.
be correct in all circumstances, and if it is not, you want a request cancellation. So you do <b>not</b> provide a <code>try.../catch</code> block.
   
   
The <var>InvalidSortSpecification</var> class is available as of <var class="product">[[Category:System exception classes]]</var> version 7.9.
The <var>InvalidSortSpecification</var> class is available as of <var class="product">[[Sirius Mods]]</var> version 7.9.
   
   
   
   

Latest revision as of 21:14, 18 November 2014


An InvalidSortSpecification exception indicates that the first argument provided to either the Sort or SortNew method (in the Stringlist class) is not a valid sort specification.

This exception class has no properties. The class's only method is the New constructor, which you would typically use with a SOUL Throw statement to produce an InvalidSortSpecification exception yourself. For example:

throw %(invalidSortSpecification):new

Remember that you catch an exception with the Catch statement; if an exception condition occurs outside a Catch for it, the request is cancelled.

Although the InvalidSortSpecification is rarely used, one possibly appropriate occasion might be a sort specification entered (at least in part) by an end user. In this case, you could provide a try.../catch invalidSortSpecification block like the following:

%sortSpec = $read('Enter sort specification') try %strlist:sort(%sortSpec) catch invalidSortSpecification Print 'Invalid ...' ... end try

In most cases, however, a sort specification is explicitly coded in the User Language request (for example, rather than %sortSpec = $read... as above, something like %sortSpec = '1,10,CH,A'). You expect such a sort specification to be correct in all circumstances, and if it is not, you want a request cancellation. So you do not provide a try.../catch block.

The InvalidSortSpecification class is available as of Sirius Mods version 7.9.


The InvalidSortSpecification methods

The following are the available InvalidSortSpecification class methods.

MethodDescription
NewCreate a new InvalidSortSpecification object

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


New constructor

Create a new InvalidSortSpecification object (InvalidSortSpecification class)

[Introduced in Sirius Mods 7.9]

This Constructor generates an instance of an InvalidSortSpecification exception. The New method format follows:

Syntax

%invalidSortSpecification = [%(InvalidSortSpecification):]New

Syntax terms

%invalidSortSpecification An InvalidSortSpecification %variable which will refer to the newly created object.
[%(InvalidSortSpecification):]The class name in parentheses denotes a Constructor. New can also be invoked via an InvalidSortSpecification object variable.