routine Int
Documentation for routine Int assembled from the following types:
enum Bool
From Bool
(Bool) routine Int
multi method Int(Bool:D --> Int:D)
Returns the value part of the enum pair.
say False.Int; # OUTPUT: «0» say True.Int; # OUTPUT: «1»
role Enumeration
From Enumeration
(Enumeration) method Int
Defined as:
multi method Int(::?CLASS:D:)
Takes a value of an enum and returns it after coercion to Int:
enum Numbers ( cool => '42', almost-pi => '3.14', sqrt-n-one => 'i' ); say cool.Int; # OUTPUT: «42» say almost-pi.Int; # OUTPUT: «3» try say sqrt-n-one.Int; say $!.message if $!; # OUTPUT: «Cannot convert 0+1i to Int: imaginary part not zero»
Note that if the value cannot be coerced to Int, an exception will be thrown.
class IO::Path
From IO::Path
(IO::Path) method Int
Defined as:
method Int(IO::Path:D: --> Int:D)
Coerces .basename to Int. Fails with X::Str::Numeric if base name is not numerical.
class Match
From Match
(Match) method Int
Defined as:
method Int(Match:D: --> Int:D)
Tries to convert stringified result of the matched text into Int.
say ('12345' ~~ /234/).Int;       # OUTPUT: «234»
say ('12345' ~~ /234/).Int.^name; # OUTPUT: «Int»
# the next line produces a warning about using Nil (result of a no match) in numeric context
say ('one-two' ~~ /234/).Int;     # OUTPUT: «0» # because Nil.Int returns 0
class Str
From Str
(Str) method Int
Defined as:
method Int(Str:D: --> Int:D)
Coerces the string to Int, using the same rules as Str.Numeric.
class IntStr
From IntStr
(IntStr) method Int
method Int
Returns the integer value of the IntStr.
class Map
From Map
(Map) method Int
Defined as:
method Int(Map:D: --> Int:D)
Returns the number of pairs stored in the Map (same as .elems).
my $m = Map.new('a' => 2, 'b' => 17);
say $m.Int;                                       # OUTPUT: «2»
class List
From List
(List) method Int
Defined as:
method Int(List:D: --> Int:D)
Returns the number of elements in the list (same as .elems).
say (1,2,3,4,5).Int; # OUTPUT: «5»
class Numeric
From Numeric
(Numeric) method Int
method Int(Numeric:D: --> Int:D)
If this Numeric is equivalent to a Real, return the equivalent of calling truncate on that Real to get an Int. Fail with X::Numeric::Real otherwise.
role Rational
From Rational
(Rational) method Int
Defined as:
method Int(Rational:D: --> Int:D)
Coerces the invocant to Int by truncating non-whole portion of the represented number, if any. If the denominator is zero, will fail with X::Numeric::DivideByZero.
class StrDistance
From StrDistance
(StrDistance) method Int
Defined as:
multi method Int(StrDistance:D:)
Returns the distance between the string before and after the transformation.