Rules / Types, classes & roles / exception

X::Numeric::Real Reference

Error while trying to coerce a number to a Real type

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 source #

method source(--> Numeric:D)

Returns Numeric:D.

Returns the number that failed to coerce to Real.

method target #

method target()

Returns the type to which the coercion was attempted.

method reason #

method reason(--> Str:D)

Returns Str:D.

Returns the reason that the conversion failed.

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.

1 all-differ · 1 no-output

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

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

say (1+2i).Int;
CATCH { default { put .^name, ': ', .Str } };
# OUTPUT: «X::Numeric::Real: Can not convert 1+2i to Int: imaginary part not zero␤»
Documentation
X::Numeric::Real: Can not convert 1+2i to Int: imaginary part not zero
Rakudo
X::Numeric::Real: Cannot convert 1+2i to Int: imaginary part not zero
Raku++
X::Numeric::Real: Cannot convert 1.000000+2.000000i to Int: imaginary part not zero

All three differ. Needs a human.

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