X::Str::Numeric Reference

Error while trying to coerce a string to a number

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(--> Str:D)

Returns Str:D.

Returns the string that was attempted to convert to a number

method pos #

method pos(--> Int:D)

Returns Int:D.

Gives the position into the string where the parsing failed.

method reason #

method reason(--> Int:D)

Returns Int:D.

Verbal description of the reason why 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::Str::Numeric is Exception { }

say +"42 answers";
CATCH { default { put .^name, ': ', .Str } };
# OUTPUT: «X::Str::Numeric: Cannot convert string to number: trailing characters after number in '42⏏ answers' (indicated by ⏏)␤»

X::Str::Numeric: Cannot convert string to number: trailing characters after number in '42⏏ answers' (indicated by ⏏)

X::Str::Numeric: Cannot convert string to number: trailing characters after number in '42<HERE> answers' (indicated by <HERE>)

X::Str::Numeric: Cannot convert string to number: trailing characters after number in '42 answers'