Moose::Meta::Attribute::Native::Trait::String - Helper trait for Str attributes
version 2.2201
package MyHomePage;
use Moose;
has 'text' => (
traits => ['String'],
is => 'rw',
isa => 'Str',
default => q{},
handles => {
add_text => 'append',
replace_text => 'replace',
},
);
my $page = MyHomePage->new();
$page->add_text("foo"); # same as $page->text($page->text . "foo");
This trait provides native delegation methods for strings.
If you don't provide an isa value for your attribute, it will default to
Str .
- 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 (perlop/s). 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 perlfunc/chop. This method returns the chopped character.
This method does not accept any arguments.
- chomp
Just like perlfunc/chomp. 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 perlfunc/length, returns the length of the string.
- substr
This acts just like perlfunc/substr. 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 Moose/BUGS for details on reporting bugs.
This software is copyright (c) 2006 by Infinity Interactive, Inc.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
|