class X::OutOfRange is Exception { }

General error when something (for example an array index) is out of an allowed range.

For example

say 42[2];
    CATCH { default { put .^name, ': ', .Str } };
    # OUTPUT: «X::OutOfRange: Index out of range. Is: 2, should be in 0..0␤»

since scalars generally act as a one-element list.

Methods

method what

method what(--> Str:D)

Verbal description of the thing that was out of range (e.g. "array index", "month").

method got

method got()

Returns the object that was considered out of range (often an integer)

method range

method range(--> Range:D)

Returns a Range object describing the permissible range for the object returned from .got.

method comment

method comment(--> Str)

Returns an additional comment that is included in the error message.