Text::Query::SolveAdvancedString - Apply query expression on strings

Text-Query documentation Contained in the Text-Query distribution.

Index

Code Index:

NAME

Top

Text::Query::SolveAdvancedString - Apply query expression on strings

SYNOPSIS

Top

  use Text::Query;
  my $q=new Text::Query('hello and world',
                        -parse => 'Text::Query::ParseAdvanced',
                        -solve => 'Text::Query::SolveAdvancedString',
                        -build => 'Text::Query::BuildAdvancedString');

  $q->match('this hello is a world')

DESCRIPTION

Top

Applies an expression built by Text::Query::BuildAdvancedString to a list of strings.

METHODS

Top

match ([TARGET])

If TARGET is a scalar, match returns a true value if the string specified by TARGET matches the query object's 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 string to match.

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

matchscalar ([TARGET])

Behaves just like MATCH when TARGET is a scalar or is not given. Slightly faster than MATCH under these circumstances.

AUTHORS

Top

Eric Bohlman (ebohlman@netcom.com)

Loic Dachary (loic@senga.org)

Text-Query documentation Contained in the Text-Query distribution. 
#
#   Copyright (C) 1999 Eric Bohlman, Loic Dachary
#
#   This program is free software; you can redistribute it and/or modify it
#   under the terms of the GNU General Public License as published by the
#   Free Software Foundation; either version 2, or (at your option) any
#   later version.  You may also use, redistribute and/or modify it
#   under the terms of the Artistic License supplied with your Perl
#   distribution
#
#   This program is distributed in the hope that it will be useful,
#   but WITHOUT ANY WARRANTY; without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#   GNU General Public License for more details.
#
#   You should have received a copy of the GNU General Public License
#   along with this program; if not, write to the Free Software
#   Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. 
#
# 
# $Header: /usr/local/cvsroot/Text-Query/lib/Text/Query/SolveAdvancedString.pm,v 1.2 1999/06/14 12:53:58 loic Exp $
#
package Text::Query::SolveAdvancedString;

use strict;

use Text::Query::Solve;

use vars qw(@ISA);

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

sub initialize {
}

sub match {
    my($self) = shift;
    my($expr) = shift;

    return $expr->(shift || $_) if(@_ <= 1 && ref($_[0]) ne 'ARRAY');

    my($pa) = (@_ == 1 && ref($_[0]) eq 'ARRAY') ? shift : \@_;

    my(@ra);
    if(ref($pa->[0]) eq 'ARRAY') {
	@ra = grep { $expr->($_[0]) } @$pa;
    } else {
	@ra = grep { $expr->($_) } @$pa;
    }
    return wantarray ? @ra : \@ra;
}

sub matchscalar {
    my($self) = shift;
    my($expr) = shift;

    return $expr->(shift || $_);
}

1;

__END__


# Local Variables: ***
# mode: perl ***
# End: ***