Data::Perl::Role::String(3pm)  User Contributed Perl Documentation  Data::Perl::Role::String(3pm)



NAME
       Data::Perl::Role::String - Wrapping class for Perl scalar strings.

VERSION
       version 0.002009

SYNOPSIS
         use Data::Perl qw/string/;

         my $string = string("foo\n");

         $string->chomp; # returns 1, $string == "foo"

DESCRIPTION
       This class provides a wrapper and methods for interacting with scalar strings.

PROVIDED METHODS
       ·   new($value)

           Constructs a new Data::Perl::String object, optionally initialized to $value if passed
           in, and returns it.

       ·   inc

           Increments the value stored in this slot using the magical string autoincrement
           operator. Note that Perl doesn't provide analogous behavior in "--", so "dec" is not
           available. This method returns the new value.

           This method does not accept any arguments.

       ·   append($string)

           Appends to the string, like ".=", and returns the new value.

           This method requires a single argument.

       ·   prepend($string)

           Prepends to the string and returns the new value.

           This method requires a single argument.

       ·   replace($pattern, $replacement)

           Performs a regexp substitution ("s" in perlop). There is no way to provide the "g"
           flag, but code references will be accepted for the replacement, causing the regex to
           be modified with a single "e". "/smxi" can be applied using the "qr" operator. This
           method returns the new value.

           This method requires two arguments.

       ·   match($pattern)

           Runs the regex against the string and returns the matching value(s).

           This method requires a single argument.

       ·   chop

           Just like "chop" in perlfunc. This method returns the chopped character.

           This method does not accept any arguments.

       ·   chomp

           Just like "chomp" in perlfunc. This method returns the number of characters removed.

           This method does not accept any arguments.

       ·   clear

           Sets the string to the empty string (not the value passed to "default").

           This method does not have a defined return value.

           This method does not accept any arguments.

       ·   length

           Just like "length" in perlfunc, returns the length of the string.

       ·   substr

           This acts just like "substr" in perlfunc. When called as a writer, it returns the
           substring that was replaced, just like the Perl builtin.

           This method requires at least one argument, and accepts no more than three.

SEE ALSO
       ·   Data::Perl

       ·   MooX::HandlesVia

AUTHOR
       Matthew Phillips <mattp AT cpan.org>

COPYRIGHT AND LICENSE
       This software is copyright (c) 2014 by Matthew Phillips <mattp AT cpan.org>.

       This is free software; you can redistribute it and/or modify it under the same terms as
       the Perl 5 programming language system itself.



perl v5.18.2                                2014-06-27              Data::Perl::Role::String(3pm)