NAME

Search::Xapian::QueryParser - Parse a query string into a Search::Xapian::Query object

DESCRIPTION

This module turns a human readable string into something Xapian can understand. The syntax supported is designed to be similar to other web based search engines, so that users familiar with them don't have to learn a whole new syntax.

SYNOPSIS

  use Search::Xapian qw/:standard/;

  my $qp = new Search::Xapian::QueryParser( [$database] );
  $qp->set_stemmer(new Search::Xapian::Stem("english"));
  $qp->set_default_op(OP_AND);

  $database->enquire($qp->parse_query('a word OR two NEAR "a phrase" NOT (too difficult) +eh'));
 

METHODS

new <database>

QueryParser constructor.

set_stemmer <stemmer>

Set the Search::Xapian::Stem object to be used for stemming query terms.

set_stemming_strategy <strategy>

Set the stemming strategy. Valid values are STEM_ALL, STEM_SOME, STEM_NONE.

set_stopper <stopper>

Set the Search::Xapian::Stopper object to be used for identifying stopwords.

set_default_op <operator>

Set default operator for joining elements. Useful values are OP_AND and OP_OR. See Search::Xapian for descriptions of these constants.

get_default_op

Returns the default operator for joining elements.

set_database <database>

Pass a Search::Xapian::Database object which is used to check whether terms exist in some situations.

parse_query <query_string> [<flags>]

parses the query string according to the rules defined in the query parser documentation below. Allows you to specify certain flags to modify the searching behaviour:

  FLAG_BOOLEAN=1, FLAG_PHRASE=2, FLAG_LOVEHATE=4,
  FLAG_BOOLEAN_ANY_CASE=8, FLAG_WILDCARD = 16

default flags are FLAG_PHRASE, FLAG_BOOLEAN and FLAG_LOVEHATE

add_prefix <field> <prefix>

Add a probabilistic term prefix. E.g. $qp->add_prefix("author", "A");

Allows the user to search for author:orwell which will search for the term "Aorwel" (assuming English stemming is in use). Multiple fields can be mapped to the same prefix (so you can e.g. make title: and subject: aliases for each other).

Parameters: field The user visible field name prefix The term prefix to map this to

add_boolean_prefix <field> prefix

Add a boolean term prefix allowing the user to restrict a search with a boolean filter specified in the free text query. E.g. $p->add_boolean_prefix("site", "H");

Allows the user to restrict a search with site:xapian.org which will be converted to Hxapian.org combined with any probabilistic query with OP_FILTER.

Multiple fields can be mapped to the same prefix (so you can e.g. make site: and domain: aliases for each other).

Parameters: field The user visible field name prefix The term prefix to map this to

stoplist_begin

stoplist_end

unstem_begin

unstem_end

get_description

Returns a string describing this object. (for introspection)

REFERENCE

  http://www.xapian.org/docs/queryparser.html
  http://www.xapian.org/docs/sourcedoc/html/classXapian_1_1QueryParser.html