InvalidSortSpecification class

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 User Language Throw statement to produce an InvalidSortSpecification exception. For example:

throw %(invalidSortSpecification):new

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

Actually, the InvalidSortSpecification is rarely used. One possible circumstance for using it would be if a sort specification is entered (at least in part) by an end user, and then a try.../catch invalidSortSpecification block might be appropriate, as shown here:

%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'), and so the sort specification should always be correct and request cancellation is an appropriate action, that is, do not use the try.../catch block as above.

The InvalidSortSpecification class is available as of version 7.9.

The InvalidSortSpecification methods

The following are the available InvalidSortSpecification class methods.

Method	Description
New	Create a new InvalidSortSpecification 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.
• "InvalidSortSpecification methods syntax" is a single page that contains the syntax diagrams of all the methods in the class.

New constructor

Create a new InvalidSortSpecification object (InvalidSortSpecification class)

[Introduced in Sirius Mods 7.9]

This callable constructor generates an instance of an InvalidSortSpecification exception. The New constructor 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 shared method. New can also be invoked via an InvalidSortSpecification object variable.