search::gin::query::set(3pm) [debian man page]

Search::GIN::Query::Set(3pm)				User Contributed Perl Documentation			      Search::GIN::Query::Set(3pm)

NAME

       Search::GIN::Query::Set - Create queries with set operations

VERSION

       version 0.08

SYNOPSIS

	   # build a query like:
	   # (type:pdf OR type:png) AND (name:Homer OR name:Bart)

	   use Search::GIN::Query::Set;
	   use Search::GIN::Query::Manual;

	   my $query = Search::GIN::Query::Set->new(
	       operation => 'INTERSECT',
	       subqueries => [
		   Search::GIN::Query::Manual->new(
		       values => {
			  type => [qw(pdf png)]
		       }
		   ),
		   Search::GIN::Query::Manual->new(
		       values => {
			  name => [qw(Homer Bart)]
		       }
		   ),
	       ]
	   );

DESCRIPTION

       Creates a manual GIN query that can be used to search using basic set theory, in order to build more complex queries.

       This query doesn't provide any specific search, it's just a set operator for subqueries. You can build complex queries by using other set
       queries as subqueries for a set query.

METHODS
/SUBROUTINES
   new
       Creates a new query.

ATTRIBUTES

   subqueries
       The subqueries to process

   operation
       One of the basic set operators: "UNION", "INTERSECT" and "EXCEPT". The default is "UNION"

AUTHOR

       Yuval Kogman <nothingmuch@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2010 by Yuval Kogman, Infinity Interactive.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.10.1							    2011-01-31					      Search::GIN::Query::Set(3pm)

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)