Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

plucene::search::booleanquery(3pm) [debian man page]

Plucene::Search::BooleanQuery(3pm)			User Contributed Perl Documentation			Plucene::Search::BooleanQuery(3pm)

NAME

       Plucene::Search::BooleanQuery - a boolean query

SYNOPSIS

	       # isa Plucene::Search::Query

	       $query->add(Plucene::Search::Query $query, $required, $prohibited);
	       $query->normalize($norm);

	       my	 @clauses = $query->clauses;
	       my $sum_sq_weights = $query->sum_squared_weights($searcher);
	       my      $as_string = $query->to_string($field);

DESCRIPTION

       A query that matches documents matching boolean combinations of other queries, typically TermQuerys or PhraseQuery

       A boolean query represents a composite query that may contains subqueries of arbitrary nesting level and with composition rules such as
       'and', 'or' or 'not'.

       Boolean queries are represented in Plucene API by instances of the BooleanQuery class. Each BooleanQuery object contains a list of
       subqueries that are linked using instances of the adaptor class BooleanClause. The subqueries may be of any Query type such as term query,
       phrase query and nested boolean queries.

       Each sub query of a boolean query has two binary qualifiers that controls how its super query is matched. These qualifiers are

       o   prohibited - when this flag is set, the matching status of the subquery is negated such that the query is considered as a match only
	   when the sub query does not match.

       o   required - when this flag is set, the sub query is required to match (or not to match if its 'prohibited' flag is set) for the super
	   query to match.  This this is a necessary but not sufficient condition for the super query to match.

METHODS

   add
	       $query->add(Plucene::Search::Query $query, $required, $prohibited);

       Adds a clause to a boolean query.  Clauses may be:

       required
	   which means that documents which do not match this sub-query will not match the boolean query;

       prohibited
	   which means that documents which do match this sub-query will not match the boolean query; or

	   neither, in which case matched documents are neither prohibited from nor required to match the sub-query.

       It is an error to specify a clause as both required and prohibited.

   add_clause
	       $self->add_clause(Plucene::Search::BooleanClause $c);

       Adds an already-formed clause onto the query.

   clauses
	       my @clauses = $query->clauses;

   sum_squared_weights
	       my $sum_sq_weights = $query->sum_squared_weights($searcher);

   normalize
	       $query->normalize($norm);

   to_string
	       my $as_string = $query->to_string($field);

perl v5.12.4							    2011-08-14					Plucene::Search::BooleanQuery(3pm)

Check Out this Related Man Page

KinoSearch1::Search::BooleanQuery(3pm)			User Contributed Perl Documentation		    KinoSearch1::Search::BooleanQuery(3pm)

NAME

       KinoSearch1::Search::BooleanQuery - match boolean combinations of Queries

SYNOPSIS

	   my $bool_query = KinoSearch1::Search::BooleanQuery->new;
	   $bool_query->add_clause( query => $term_query, occur => 'MUST' );
	   my $hits = $searcher->search( query => $bool_query );

DESCRIPTION

       BooleanQueries are super-Query objects which match boolean combinations of other Queries.

       One way of producing a BooleanQuery is to feed a query string along the lines of "this AND NOT that" to a QueryParser object:

	   my $bool_query = $query_parser->parse( 'this AND NOT that' );

       It's also possible to achieve the same end by manually constructing the query piece by piece:

	   my $bool_query = KinoSearch1::Search::BooleanQuery->new;

	   my $this_query = KinoSearch1::Search::TermQuery->new(
	       term => KinoSearch1::Index::Term->new( 'bodytext', 'this' ),
	   );
	   $bool_query->add_clause( query => $this_query, occur => 'MUST' );

	   my $that_query = KinoSearch1::Search::TermQuery->new(
	       term => KinoSearch1::Index::Term->new( 'bodytext', 'that' ),
	   );
	   $bool_query->add_clause( query => $that_query, occur => 'MUST_NOT' );

       QueryParser objects and hand-rolled Queries can work together:

	   my $general_query = $query_parser->parse($q);
	   my $news_only     = KinoSearch1::Search::TermQuery->new(
	       term => KinoSearch1::Index::Term->new( 'category', 'news' );
	   );
	   $bool_query->add_clause( query => $general_query, occur => 'MUST' );
	   $bool_query->add_clause( query => $news_only,     occur => 'MUST' );

METHODS

   new
	   my $bool_query = KinoSearch1::Search::BooleanQuery->new;

       Constructor. Takes no arguments.

   add_clause
	   $bool_query->add_clause(
	       query => $query, # required
	       occur => 'MUST', # default: 'SHOULD'
	   );

       Add a clause to the BooleanQuery.  Takes hash-style parameters:

       o   query - an object which belongs to a subclass of KinoSearch1::Search::Query.

       o   occur - must be one of three possible values: 'SHOULD', 'MUST', or 'MUST_NOT'.

COPYRIGHT

       Copyright 2005-2010 Marvin Humphrey

LICENSE, DISCLAIMER, BUGS, etc.
       See KinoSearch1 version 1.00.

perl v5.14.2							    2011-11-15				    KinoSearch1::Search::BooleanQuery(3pm)
Man Page