Rules / Types, classes & roles / exception

X::Numeric::DivideByZero Reference

Error while trying to divide by zero

What it is #

Routines #

Signatures are reproduced from the documentation, including their declared return types. A routine listed here is part of the type's published interface; whether Raku++ implements it is a separate question, answered by the examples below.

method using #

method using()

If present, returns the name of the operator used, e.g. C<infix:<%%>>.

method details #

method details()

If present, contains some details on the operation that caused the failure.

method numerator #

method numerator()

If present, returns the numerator of the operation.

Examples, run three ways #

Every example below comes from the official documentation, together with the output that documentation asserts. Each was then executed by Rakudo and by Raku++ when this page was built. Where the three agree, one result is shown; where they do not, all three are — because which of them is wrong is exactly the information worth having.

2 no-output · 1 rakudo-differs

class X::Numeric::DivideByZero is Exception { }

Not executed: the documentation states no expected output for this example.

say 1 / 0;
CATCH { default { put .^name, ': ', .Str } };
# OUTPUT: «X::Numeric::DivideByZero: Attempt to divide by zero when coercing Rational to Str␤»
Documentation
X::Numeric::DivideByZero: Attempt to divide by zero when coercing Rational to Str
Rakudo
X::Numeric::DivideByZero: Attempt to divide 1 by zero when coercing Rational to Str
Raku++
X::Numeric::DivideByZero: Attempt to divide by zero when coercing Rational to Str

Raku++ matches the documentation; Rakudo does not. This is the one class where neither engine can be assumed right: it may be a stale doc that Raku++ was built from, or it may be a Rakudo bug that the documentation predates. Each case is examined individually.

Not yet examined. Which of these is correct has not been established — do not treat either engine as settled here.

1/0; # no Error

Not executed: the documentation states no expected output for this example.