NAME
Map::Match - Provide a Map where keys are regular expressions
SYNOPSIS
use Map::Match;
my %m is Map::Match = foo => 42, b16ar => 666, baz18 => 137;
.say for %m<a>; # 666137, same as / a /
.say for %m{ / \d >> / }; # 137
.say for %m{ / \d >> / }:k; # baz18
DESCRIPTION
Map::Match provides an implementation of the Map
interface where key values are interpreted as regular expressions. This has the following implications with regards to the normal behaviour of Map
s:
CAN RETURN MORE THAN ONE
Since a regular expression can match multiple times, you can receive more than one value back from a single key. Therefore, a Slip
will always be returned as the value.
ALWAYS A SLIP
The value returned from any Map
access is always a Slip
, albeit potentially empty. This is different from a normal Map
where Nil
would be returned when specifying a key that does not exist in the Map
.
NON-REGEX KEY ASSUMED TO BE REGEX
If you specify a Str
as a key, or something that can be coerced to a Str
, it will be interpreted as being interpolated in a Regex
with :ignorecase
and :ignoremark
enabled.
AUTHOR
Elizabeth Mattijsen liz@raku.rocks
Source can be located at: https://github.com/lizmat/Map-Match . Comments and Pull Requests are welcome.
If you like this module, or what I’m doing more generally, committing to a small sponsorship would mean a great deal to me!
COPYRIGHT AND LICENSE
Copyright 2021, 2022, 2023, 2024 Elizabeth Mattijsen
This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.