BrowserREPL-button-tip-on BrowserREPL-button-tip-off

EditButtonTip 2024-08-08

class NumStr

Dual value floating-point number and string

class NumStr is Allomorph is Num { }
Code

NumStr is a dual value type, a subclass of both Allomorph, hence Str, and Num.

See Allomorph for further details.

my $num-str = <42.1e0>;
say $num-str.^name;         # OUTPUT: «NumStr␤»

my Num $num = $num-str;     # OK!
my Str $str = $num-str;     # OK!

# ∈ operator cares about object identity
say 42e10 ∈ <42e10 55 1>; # OUTPUT: «False␤»
Code

Methods§

method new§

method new(Num $i, Str $s)
Code

The constructor requires both the Num and the Str value, when constructing one directly the values can be whatever is required:

my $f = NumStr.new(42.1e0, "forty two and a bit");
say +$f; # OUTPUT: «42.1␤»
say ~$f; # OUTPUT: «"forty two and a bit"␤»
Code

method Num§

method Num
Code

Returns the Num value of the NumStr.

method Numeric§

multi method Numeric(NumStr:D: --> Num:D)
multi method Numeric(NumStr:U: --> Num:D)
Code

The :D variant returns the numeric portion of the invocant. The :U variant issues a warning about using an uninitialized value in numeric context and then returns value 0e0.

method Real§

multi method Real(NumStr:D: --> Num:D)
multi method Real(NumStr:U: --> Num:D)
Code

The :D variant returns the numeric portion of the invocant. The :U variant issues a warning about using an uninitialized value in numeric context and then returns value 0e0.

Operators§

infix ===§

multi infix:<===>(NumStr:D $a, NumStr:D $b)
Code

NumStr Value identity operator. Returns True if the Num values of $a and $b are identical and their Str values are also identical. Returns False otherwise.

Class relation diagram§

Rakudo Type Relation for NumStr NumStr NumStr Allomorph Allomorph NumStr->Allomorph is Num Num NumStr->Num is