logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

MooseX::AttributeHelpers::Trait::String - simple string attribute

Author

       Stevan Little <stevan@iinteractive.com>

Description

       This module provides a simple string attribute, to which mutating string operations can be applied more
       easily (no need to make an lvalue attribute metaclass or use temporary variables). Additional methods are
       provided for completion.

       If your attribute definition does not include any of is, isa, default or provides but does use the
       "String" metaclass, then this module applies defaults as in the "SYNOPSIS" above. This allows for a very
       basic counter definition:

         has 'foo' => (metaclass => 'String');
         $obj->append_foo;

Methods

metamethod_providerhas_method_providerhelper_typeprocess_options_for_provides
           Run before its superclass method.

       check_provides_values
           Run after its superclass method.

Name

       MooseX::AttributeHelpers::Trait::String - simple string attribute

Provided Methods

       It  is  important  to  note  that  all  those methods do in place modification of the value stored in the
       attribute.

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

       append $string
           Append a string, like ".=".

       prepend $string
           Prepend a string.

       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.

       match $pattern
           Like replace but without the replacement. Provided mostly for completeness.

       "chop"
           "chop" in perlfunc

       "chomp"
           "chomp" in perlfunc

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

Support

       Bugs         may        be        submitted        through        the        RT        bug        tracker
       <https://rt.cpan.org/Public/Dist/Display.html?Name=MooseX-AttributeHelpers>                           (or
       bug-MooseX-AttributeHelpers@rt.cpan.org <mailto:bug-MooseX-AttributeHelpers@rt.cpan.org>).

       There    is    also    a    mailing    list    available    for    users   of   this   distribution,   at
       <http://lists.perl.org/list/moose.html>.

       There is also an irc channel available for users of this  distribution,  at  "#moose"  on  "irc.perl.org"
       <irc://irc.perl.org/#moose>.

Synopsis

         package MyHomePage;
         use Moose;
         use MooseX::AttributeHelpers;

         has 'text' => (
             metaclass => 'String',
             is        => 'rw',
             isa       => 'Str',
             default   => sub { '' },
             provides  => {
                 append => "add_text",
                 replace => "replace_text",
             }
         );

         my $page = MyHomePage->new();
         $page->add_text("foo"); # same as $page->text($page->text . "foo");

Version

       version 0.25

See Also