Data::Object::Role::Regexp - Regexp Object Role for Perl 5
version 0.59
use Data::Object::Class; with 'Data::Object::Role::Regexp';
Data::Object::Role::Regexp provides routines for operating on Perl 5 regular expressions.
# given $regexp $regexp->data; # original value
The data method returns the original and underlying value contained by the object. This method is an alias to the detract method.
# given $regexp $regexp->defined; # 1
The defined method returns true if the object represents a value that meets the criteria for being defined, otherwise it returns false. This method returns a number object.
# given $regexp $regexp->detract; # original value
The detract method returns the original and underlying value contained by the object.
# given qr(test) $regexp->dump; # qr/(?^u:test)/
The dump method returns returns a string representation of the object. This method returns a string value.
# given qr(test) $regexp->eq(qr(test)); # 1
The eq method returns true if the argument provided is equal to the value represented by the object. This method returns a number value.
# given qr(test) $regexp->ge(qr(test)); # 1
The ge method returns true if the argument provided is greater-than or equal-to the value represented by the object. This method returns a Data::Object::Number object.
# given qr(test) $regexp->gt(qr(test)); # 0
The gt method returns true if the argument provided is greater-than the value represented by the object. This method returns a number value.
# given qr(test) $regexp->le(qr(test)); # 1
The le method returns true if the argument provided is less-than or equal-to the value represented by the object. This method returns a Data::Object::Number object.
# given qr(test) $regexp->lt(qr(test)); # 0
The lt method returns true if the argument provided is less-than the value represented by the object. This method returns a number value.
# given $regexp $regexp->methods;
The methods method returns the list of methods attached to object. This method returns an array value.
# given qr(test) $regexp->ne(qr(test)); # 1
The ne method returns true if the argument provided is not equal to the value represented by the object. This method returns a number value.
# given qr(something to match against) my $re = Data::Object::Regexp->new(qr(something to match against));
The new method expects a regular-expression object and returns a new class instance.
# given qr(test) $regexp->print; # 'qr/(?^u:test)/'
The print method outputs the value represented by the object to STDOUT and returns true. This method returns a number value.
# given qr(test) $re->replace('this is a test', 'drill'); $re->replace('test 1 test 2 test 3', 'drill', 'gi');
The replace method performs a regular expression substitution on the given string. The first argument is the string to match against. The second argument is the replacement string. The optional third argument might be a string representing flags to append to the s///x operator, such as 'g' or 'e'. This method will always return a regexp::Result object which can be used to introspect the result of the operation.
# given $regexp $regexp->roles;
The roles method returns the list of roles attached to object. This method returns an array value.
# given qr(test) $regexp->say; # 'qr/(?^u:test)/\n'
The say method outputs the value represented by the object appended with a newline to STDOUT and returns true. This method returns a Data::Object::Number object.
# given qr((test)) $re->search('this is a test'); $re->search('this does not match', 'gi');
The search method performs a regular expression match against the given string This method will always return a regexp::Result object which can be used to introspect the result of the operation.
# given $regexp $regexp->throw;
The throw method terminates the program using the core die keyword, passing the object to the Data::Object::Exception class as the named parameter object. If captured this method returns an exception value.
object
# given $regexp $regexp->type; # REGEXP
The type method returns a string representing the internal data type object name. This method returns a string value.
This package is comprised of the following roles.
Data::Object::Role::Alphabetic
Data::Object::Role::Comparison
Data::Object::Role::Defined
Data::Object::Role::Detract
Data::Object::Role::Dumper
Data::Object::Role::Item
Data::Object::Role::Output
Data::Object::Role::Throwable
Data::Object::Role::Type
Data::Object::Role::Value
Data::Object::Array
Data::Object::Class
Data::Object::Class::Syntax
Data::Object::Code
Data::Object::Float
Data::Object::Hash
Data::Object::Integer
Data::Object::Number
Data::Object::Role
Data::Object::Role::Syntax
Data::Object::Regexp
Data::Object::Scalar
Data::Object::String
Data::Object::Undef
Data::Object::Universal
Data::Object::Autobox
Data::Object::Immutable
Data::Object::Library
Data::Object::Prototype
Data::Object::Signatures
Al Newkirk <anewkirk@ana.io>
This software is copyright (c) 2014 by Al Newkirk.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Data::Object, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Data::Object
CPAN shell
perl -MCPAN -e shell install Data::Object
For more information on module installation, please visit the detailed CPAN module installation guide.