NAME

Markup::MatchNode - Comparison object of Markup::TreeNode.

SYNOPSIS

        use Markup::MatchNode;

        my $node = Markup::MatchNode->new( tagname => 'p', attr => { align => 'center' } );
        $_ = $node->compare_to(Markup::TreeNode->new( tagname => 'p', attr => { align => 'left' } ));

        print "Percent correct: $_\n";

DESCRIPTION

Pretty much exactly the same as Markup::TreeNode. The major difference is the compare_to method. Likely you won't need this module explicitly. It is mostly used with Markup::Content.

METHODS

All the same as Markup::TreeNode with the notable exception of compare_to, listed below.

Please note the following terminology:

A Major Error occurs when one of the following tag nodes is out of place: table, td, tr, tbody, map, object, img, body, head, title, and html.

A Minor Error is any error that is not a Major Error. This could be unmatched text an unmatched attribute, an unmatched tag node or any other error.

compare_to (Markup::TreeNode)

This compares the current MatchNode to the specified TreeNode. Generally you won't need to explicitly call this method or use this module unless you are performing some custom matching routines.

Returns: In scalar context it returns the percentage correct. The example under SYNOPSIS should yeild 75. In list context two references to arrays are returned. The first index is the complete stats on the minor errors. Index zero of this array reference is the total number of possible correct points. The second index is the total correct points. The following index is the percent correct. The last index of the array reference is a colon(:)-seperated list of reasons why the nodes did not match. The second array reference represents the major errors and the array indices exactly mirror the minor errors.

Example:

        my $node = Markup::MatchNode->new( tagname => 'p', attr => { align => 'center' } );

        # scalar context
        $_ = $node->compare_to(Markup::TreeNode->new( tagname => 'p', attr => { align => 'left' } ));
        print "Percent correct: $_%\n";

        # list context
        @_ = $node->compare_to(Markup::TreeNode->new( tagname => 'p', attr => { align => 'left' } ));
        $_[0]->[3] =~ s/:/\n\t\t\t\t\t/g;
        $_[1]->[3] =~ s/:/\n\t\t\t\t\t/g;
        $_ = int((($_[0]->[2] + $_[1]->[2]) / 2));
        print <<EOF;

        Error   Correct         Total   Percent Reasons
        ------------------------------------------------------------------------
        Minor   $_[0]->[1]      of      $_[0]->[0]      ($_[0]->[2]%)   $_[0]->[3]
        Major   $_[1]->[1]      of      $_[1]->[0]      ($_[1]->[2]%)   $_[1]->[3]
        Total                           ($_%)
        EOF

SEE ALSO

Markup::TreeNode, Markup::MatchTree, Markup::Tree, Markup::Content

AUTHOR

BPrudent (Brandon Prudent)

Email: xlacklusterx@hotmail.com