GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MOUSEX::NATIVETRAITS::STR (3)

.ds Aq ’

NAME

MouseX::NativeTraits::Str - Helper trait for Str attributes

CONTENTS

SYNOPSIS



  package MyHomePage;
  use Mouse;

  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");



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.

PROVIDED METHODS

These methods are implemented in MouseX::NativeTraits::MethodProvider::Str. It is important to note that all those methods do in place modification of the value stored in the attribute.
<B>incB> 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.
<B>append($string)B> Append a string, like .=.
<B>prepend($string)B> Prepend a string.
<B>replace($pattern, B>$replacement<B>)B> Performs a regexp substitution (s in perlop). A code references will be accepted for the replacement, causing the regexp to be modified with a single e. /smxi can be applied using the qr operator.
<B>replace($pattern, B>$replacement<B>)B> Performs a regexp substitution (s in perlop) with the g flag. A code references will be accepted for the replacement, causing the regexp to be modified with a single e. /smxi can be applied using the qr operator.
<B>match($pattern)B> Like replace but without the replacement. Provided mostly for completeness.
<B>chopB> chop in perlfunc
<B>chompB> chomp in perlfunc
<B>clearB> Sets the string to the empty string (not the value passed to default).
<B>lengthB> length in perlfunc
<B>substrB> substr in perlfunc. We go to some lengths to match the different functionality based on substr’s arity.

METHODS

<B>metaB>
<B>method_provider_classB>
<B>helper_typeB>

SEE ALSO

MouseX::NativeTraits
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MOUSEX::NATIVETRAITS::STR (3) 2012-11-26

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.