NAME

Text::Query::Solve - Base class for query resolution

SYNOPSIS

package Text::Query::SolveSource;

use Text::Query::Parse;

use vars qw(@ISA);

@ISA = qw(Text::Query::Solve);

DESCRIPTION

This module provides a virtual base class for query resolution.

It defines the match and matchscalar method that is called by the Text::Query object to apply a query on a data source.

METHODS

match (EXPR [TARGET])

If TARGET is a scalar, match returns a true value if the data source specified by TARGET matches the EXPR query expression. If TARGET is not given, the match is made against $_.

If TARGET is an array, match returns a (possibly empty) list of all matching elements. If the elements of the array are references to sub- arrays, the match is done against the first element of each sub-array. This allows arbitrary information (e.g. filenames) to be associated with each data source to match.

If TARGET is a reference to an array, match returns a reference to a (possibly empty) list of all matching elements.

matchscalar (EXPR [TARGET])

Behaves just like MATCH when TARGET is a scalar or is not given.

SEE ALSO

Text::Query(3)

AUTHORS

Eric Bohlman (ebohlman@netcom.com)

Loic Dachary (loic@senga.org)