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

       •   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.

       •   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);