Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MouseX::NativeTraits::User3Contributed Perl DocumeMouseX::NativeTraits::Str(3)

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

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.

       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.

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

       prepend($string)
	   Prepend a string.

       replace($pattern, $replacement)
	   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.

       replace($pattern, $replacement)
	   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.

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

       length
	   "length" in perlfunc

       substr
	   "substr" in perlfunc. We go to some lengths to match	the different
	   functionality based on "substr"'s arity.

METHODS
       meta
       method_provider_class
       helper_type

SEE ALSO
       MouseX::NativeTraits

perl v5.24.1			  2012-11-26	  MouseX::NativeTraits::Str(3)

NAME | SYNOPSIS | DESCRIPTION | PROVIDED METHODS | METHODS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=MouseX::NativeTraits::Str&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help