Help language development. Donate to The Perl Foundation

P5reset zef:lizmat last updated on 2021-09-09

use v6.*;

unit module P5reset:ver<0.0.6>:auth<zef:lizmat>;

proto sub reset(|) is export {*}
multi sub reset(--> 1) { }
multi sub reset(Str() $pattern --> 1) {

    my $start;
    sub start-from() { my $value = $start; $start = Nil; $value }

    my $letters;
    for $pattern.comb -> $letter {
        $letter eq '-'
          ?? ($start = $letters.chop if $letters)
          !! $letters ~= $start
            ?? (start-from() .. $letter).join
            !! $letter;

    for CALLER::OUR::.kv -> \key, \value {
        if '[email protected]%'.contains(key.substr(0,1)) {
            if $letters.contains(key.substr(1,1)) {
                value = value ~~ Iterable || value ~~ Associative
                  ?? Empty
                  !! Nil

=begin pod

=head1 NAME

Raku port of Perl's reset() built-in


  use P5reset;

  reset("a");   # reset all "our" variables starting with "a"

  reset("a-z"); # reset all "our" variables starting with lowercase letter

  reset;        # does not reset any variables


This module tries to mimic the behaviour of Perl's C<reset> built-in
as closely as possible in the Raku Programming Language.


    reset EXPR
    reset   Generally used in a "continue" block at the end of a loop to clear
            variables and reset "??" searches so that they work again. The
            expression is interpreted as a list of single characters (hyphens
            allowed for ranges). All variables and arrays beginning with one
            of those letters are reset to their pristine state. If the
            expression is omitted, one-match searches ("?pattern?") are reset
            to match again. Only resets variables or searches in the current
            package. Always returns 1. Examples:

                reset 'X';      # reset all X variables
                reset 'a-z';    # reset lower case variables
                reset;          # just reset ?one-time? searches

            Resetting "A-Z" is not recommended because you'll wipe out your
            @ARGV and @INC arrays and your %ENV hash. Resets only package
            variables; lexical variables are unaffected, but they clean
            themselves up on scope exit anyway, so you'll probably want to use
            them instead. See "my".


Since Raku doesn't have the concept of C<?one time searches?>, the no-argument
form of C<reset> will not reset any variables at all.

=head1 AUTHOR

Elizabeth Mattijsen <[email protected]>

Source can be located at: . Comments and
Pull Requests are welcome.


Copyright 2018, 2019, 2020, 2021 Elizabeth Mattijsen

Re-imagined from Perl as part of the CPAN Butterfly Plan.

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.

=end pod

# vim: expandtab shiftwidth=4