Venus::Replace

Replace Class

Replace Class for Perl 5

method: captures method: count method: evaluate method: explain method: get method: initial method: last_match_end method: last_match_start method: matched method: named_captures method: new method: prematched method: postmatched method: set

package main;

use Venus::Replace;

my $replace = Venus::Replace->new(
  string => 'hello world',
  regexp => '(world)',
  substr => 'universe',
);

# $replace->captures;

This package provides methods for manipulating regexp replacement data.

Venus::Kind::Utility

Venus::Role::Encaseable Venus::Role::Explainable

flags: rw, opt, Str, '' regexp: rw, opt, Regexp, qr// string: rw, opt, Str, '' substr: rw, opt, Str, ''

The captures method returns the capture groups from the result object which contains information about the results of the regular expression operation. This method can return a list of values in list-context.

captures() (arrayref)

{ since => '0.01', }

=example-1 captures

# given: synopsis;

my $captures = $replace->captures;

# ["world"]

The count method returns the number of match occurrences from the result object which contains information about the results of the regular expression operation.

count() (number)

{ since => '0.01', }

=example-1 count

# given: synopsis;

my $count = $replace->count;

# 1

The evaluate method performs the regular expression operation and returns an arrayref representation of the results.

evaluate() (arrayref)

{ since => '0.01', }

=example-1 evaluate

# given: synopsis;

my $evaluate = $replace->evaluate;

# [
#   "(world)",
#   "hello universe",
#   1,
#   [6, 6],
#   [11, 11],
#   {},
#   "hello world",
# ]

The explain method returns the subject of the regular expression operation and is used in stringification operations.

explain() (string)

{ since => '0.01', }

=example-1 explain

# given: synopsis;

my $explain = $replace->explain;

# "hello universe"

The get method returns the subject of the regular expression operation.

get() (string)

{ since => '0.01', }

=example-1 get

# given: synopsis;

my $get = $replace->get;

# "hello universe"

The initial method returns the unaltered string from the result object which contains information about the results of the regular expression operation.

initial() (string)

{ since => '0.01', }

=example-1 initial

# given: synopsis;

my $initial = $replace->initial;

# "hello world"

The last_match_end method returns an array of offset positions into the string where the capture(s) stopped matching from the result object which contains information about the results of the regular expression operation.

last_match_end() (maybe[within[arrayref, number]])

{ since => '0.01', }

=example-1 last_match_end

# given: synopsis;

my $last_match_end = $replace->last_match_end;

# [11, 11]

The last_match_start method returns an array of offset positions into the string where the capture(s) matched from the result object which contains information about the results of the regular expression operation.

last_match_start() (maybe[within[arrayref, number]])

{ since => '0.01', }

=example-1 last_match_start

# given: synopsis;

my $last_match_start = $replace->last_match_start;

# [6, 6]

The matched method returns the portion of the string that matched from the result object which contains information about the results of the regular expression operation.

matched() (maybe[string])

{ since => '0.01', }

=example-1 matched

# given: synopsis;

my $matched = $replace->matched;

# "world"

The named_captures method returns a hash containing the requested named regular expressions and captured string pairs from the result object which contains information about the results of the regular expression operation.

named_captures() (hashref)

{ since => '0.01', }

=example-1 named_captures

# given: synopsis;

my $named_captures = $replace->named_captures;

# {}

The new method constructs an instance of the package.

new(any @args) (Venus::Replace)

{ since => '4.15', }

The prematched method returns the portion of the string before the regular expression matched from the result object which contains information about the results of the regular expression operation.

prematched() (Maybe[string])

{ since => '0.01', }

=example-1 prematched

# given: synopsis;

my $prematched = $replace->prematched;

# "hello "

The postmatched method returns the portion of the string after the regular expression matched from the result object which contains information about the results of the regular expression operation.

postmatched() (Maybe[string])

{ since => '0.01', }

=example-1 postmatched

# given: synopsis;

my $postmatched = $replace->postmatched;

# ""

The set method sets the subject of the regular expression operation.

set(string $data) (string)

{ since => '0.01', }

=example-1 set

# given: synopsis;

my $set = $replace->set('hello universe');

# "hello universe"

package main;

use Venus::Replace;

my $replace = Venus::Replace->new(
  string => 'hello world',
  regexp => 'world',
  substr => 'universe',
  flags => 'i',
);

$replace->evaluate;

$replace->flags('q');

$replace->evaluate;

# Error! (on.evaluate)

This package overloads the . operator.

This package overloads the eq operator.

This package overloads the ne operator.

This package overloads the qr operator.

This package overloads the "" operator.

This package overloads the ~~ operator.

t/Venus.t: present: authors t/Venus.t: present: license

cpanm Venus

perl -MCPAN -e shell
install Venus