Math::Symbolic::Custom::Pattern::Export - Export method to MS::Custom
use Math::Symbolic::Custom::Pattern; # later: my $pattern = $tree->to_pattern(); # and even later: $another_tree->is_of_form($pattern);
This module is an extension to the Math::Symbolic module. A basic familiarity with that module is required.
Please have a look at the Math::Symbolic::Custom::Pattern module first. This is an internal module only. It manages to add two new methods to all Math::Symbolic objects: is_of_form and to_pattern. It uses the Math::Symbolic::Custom mechanism for that.
is_of_form
to_pattern
In a way, this module exports the is_of_form and to_pattern methods to Math::Symbolic::Base. Please look at Math::Symbolic::Custom.
This method can be called on any Math::Symbolic tree. First argument must be a pattern. Returns true if the pattern matches the tree and false if not. As with the match() method on Math::Symbolic::Custom::Pattern objects, the true value returned reflects the way the pattern matched. Please see Math::Symbolic::Custom::Pattern for details.
match()
The pattern may either be a Math::Symbolic::Custom::Pattern object (fastest) or a Math::Symbolic tree representing a pattern (decent speed, since only the pattern object needs to be constructed) or a string to be parsed as a Math::Symbolic tree (very slow since the string has to be parsed).
For details on patterns, please refer to the documentation of Math::Symbolic::Custom::Pattern.
This method always throws fatal errors since returning a boolean is used for valid, non-error return values. Therefore, if you plan to pass unvalidated objects or strings to be parsed, consider wrapping calls to this method in eval {} blocks. (Note that eval BLOCK is the safer brother of the much despised eval STRING. See perlfunc.)
eval {}
eval BLOCK
eval STRING
Generates a Math::Symbolic::Custom::Pattern object from the Math::Symbolic tree to_pattern is called on. The pattern can be used with the is_of_form() method or like any other Math::Symbolic::Custom::Pattern object. (See that package for details on patterns.)
is_of_form()
New versions of this module can be found on http://steffen-mueller.net or CPAN.
Math::Symbolic::Custom::Pattern for details on usage.
Math::Symbolic
Math::Symbolic::Custom and Math::Symbolic::Custom::Base for details on enhancing Math::Symbolic.
Steffen M�ller, <symbolic-module at steffen-mueller dot net>
Copyright (C) 2005, 2006, 2013 by Steffen M�ller
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or, at your option, any later version of Perl 5 you may have available.
To install Math::Symbolic::Custom::Pattern, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Math::Symbolic::Custom::Pattern
CPAN shell
perl -MCPAN -e shell install Math::Symbolic::Custom::Pattern
For more information on module installation, please visit the detailed CPAN module installation guide.