KinoSe...anQuery(3pm)

💖 KinoSearch1::Search::BooleanQuery — the whole vibe 💖

okay so bestie, this page is from the User Contributed Perl Documentation and it's literally about KinoSearch1::Search::BooleanQuery 🦋 — match boolean combinations of Queries. iykyk.

---

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

that's it, that's the vibe 🫶

---

🎀 DESCRIPTION 🎀

so BooleanQuery objects are like... the super-Query objects 👑. they match boolean combinations of other Queries. main character energy honestly.

one way to cook up 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' );

and no cap, 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. she's low maintenance like that.

---

💜 add_clause

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

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

• query — an object which belongs to a subclass of KinoSearch1::Search::Query. yes bestie, it has to be that type, don't try anything funny 🙈
• occur — must be one of three possible values: 'SHOULD', 'MUST', or 'MUST_NOT'. literally only those three, periodt 💅

---

👑 COPYRIGHT 👑

Copyright 2005-2010 Marvin Humphrey

---

🌈 LICENSE, DISCLAIMER, BUGS, etc. 🌈

See KinoSearch1 version 1.01. that's where the whole saga lives, go check it 🦋

---

ok and that's the page!! every flag, every param, every default, all present and accounted for ✅ obsessed with her honestly.

💖 bye bestie, go write some queries 💖

— from the Perl docs, perl v5.42.3, dated 2026-08-20. slay ⭐🌸