The boolean query is a useful combination of conjunction and disjunction queries. More...

#include <couchbase/boolean_query.hxx>

Inheritance diagram for boolean_query:

Public Member Functions
auto	must (conjunction_query query) -> boolean_query &
	Set conjunction_query that groups all queries the documents must satisfy.
template<typename... SearchQuery>
auto	must (SearchQuery... queries) -> boolean_query &
	Create conjunction_query with given queries and set it as must query.
auto	must () -> conjunction_query &
	Returns conjunction_query that groups all queries the documents must satisfy.
auto	should (disjunction_query query) -> boolean_query &
	Set disjunction_query that groups queries the documents should satisfy.
template<typename... SearchQuery>
auto	should (SearchQuery... queries) -> boolean_query &
	Create disjunction_query with given queries and set it as should query.
auto	should () -> disjunction_query &
	Returns disjunction_query that groups queries the documents should satisfy.
auto	must_not (disjunction_query query) -> boolean_query &
	Set disjunction_query that groups queries the documents must not satisfy.
template<typename... SearchQuery>
auto	must_not (SearchQuery... queries) -> boolean_query &
	Create disjunction_query with given queries and set it as must not query.
auto	must_not () -> disjunction_query &
	Returns disjunction_query that groups queries the documents should satisfy.
auto	encode () const -> encoded_search_query override
Public Member Functions inherited from search_query
virtual	~search_query ()=default
template<typename derived_query = search_query, std::enable_if_t< std::is_base_of_v< search_query, derived_query >, bool > = true>
auto	boost (double boost) -> derived_query &
	The boost parameter is used to increase the relative weight of a clause (with a boost greater than 1) or decrease the relative weight (with a boost between 0 and 1).

Additional Inherited Members
Protected Member Functions inherited from search_query
	search_query ()=default
Protected Attributes inherited from search_query
std::optional< double >	boost_ {}

Detailed Description

The boolean query is a useful combination of conjunction and disjunction queries.

A boolean query takes three lists of queries:

must - result documents must satisfy all of these queries.
should - result documents should satisfy these queries.
must not - result documents must not satisfy any of these queries.

At execution, a boolean query that has no child queries in any 3 categories is not allowed and will fail fast.

The inner representation of child queries in the must/must_not/should sections are respectively a conjunction_query and two disjunction_query.

In the example below the following rules enforced by the boolean query:

retrieved documents MUST match "hostel room" in their reviews.content field AND have true in free_breakfast field.
also the documents SHOULD have EITHER reviews.ratings.Overall > 4 OR reviews.ratings.Service > 5.
and finally, exclude documents with city "Padfield" or "Gilingham".

couchbase::boolean_query query;
query.must(couchbase::match_query("hostel room").field("reviews.content"),
           couchbase::boolean_field_query(true).field("free_breakfast"));
query.should(couchbase::numeric_range_query().field("reviews.ratings.Overall").min(4),
             couchbase::numeric_range_query().field("reviews.ratings.Service").min(5));
query.must_not(couchbase::match_query("Padfield Gilingham").field("city"));

See also: https://docs.couchbase.com/server/current/fts/fts-supported-queries-boolean-field-query.html server documentation

Since: 1.0.0

Committed: Generally available API and should be preferred in production

Member Function Documentation

◆ encode()

auto encode ( ) const -> encoded_search_query

nodiscardoverridevirtual

Returns: encoded representation of the query.

Since: 1.0.0

Internal: Internal interface

Implements search_query.

◆ must() [1/3]

auto must ( ) -> conjunction_query &

inline

Returns conjunction_query that groups all queries the documents must satisfy.

Use it to add more queries.

Returns: must-query

Since: 1.0.0

Committed: Generally available API and should be preferred in production

◆ must() [2/3]

auto must ( conjunction_query query ) -> boolean_query &

inline

Set conjunction_query that groups all queries the documents must satisfy.

Parameters

query must-query

Returns: this query for chaining purposes.

Since: 1.0.0

Committed: Generally available API and should be preferred in production

◆ must() [3/3]

template<typename... SearchQuery>

auto must ( SearchQuery... queries ) -> boolean_query &

inline

Create conjunction_query with given queries and set it as must query.

Template Parameters

SearchQuery any subclass of search_query

Parameters

queries

Returns: this query for chaining purposes.

Since: 1.0.0

Committed: Generally available API and should be preferred in production

◆ must_not() [1/3]

auto must_not ( ) -> disjunction_query &

inline

Returns disjunction_query that groups queries the documents should satisfy.

Use it to add more queries.

Returns: must_not-query

Since: 1.0.0

Committed: Generally available API and should be preferred in production

◆ must_not() [2/3]

auto must_not ( disjunction_query query ) -> boolean_query &

inline

Set disjunction_query that groups queries the documents must not satisfy.

Parameters

query must_not-query

Returns: this query for chaining purposes.

Since: 1.0.0

Committed: Generally available API and should be preferred in production

◆ must_not() [3/3]

template<typename... SearchQuery>

auto must_not ( SearchQuery... queries ) -> boolean_query &

inline

Create disjunction_query with given queries and set it as must not query.

Template Parameters

SearchQuery any subclass of search_query

Parameters

queries

Returns: this query for chaining purposes.

Since: 1.0.0

Committed: Generally available API and should be preferred in production

◆ should() [1/3]

auto should ( ) -> disjunction_query &

inline

Returns disjunction_query that groups queries the documents should satisfy.

Use it to add more queries or change min.

Returns: should-query

Since: 1.0.0

Committed: Generally available API and should be preferred in production

◆ should() [2/3]

auto should ( disjunction_query query ) -> boolean_query &

inline

Set disjunction_query that groups queries the documents should satisfy.

Parameters

query should-query

Returns: this query for chaining purposes.

Since: 1.0.0

Committed: Generally available API and should be preferred in production

◆ should() [3/3]

template<typename... SearchQuery>

auto should ( SearchQuery... queries ) -> boolean_query &

inline

Create disjunction_query with given queries and set it as should query.

Template Parameters

SearchQuery any subclass of search_query

Parameters

queries

Returns: this query for chaining purposes.

Since: 1.0.0

Committed: Generally available API and should be preferred in production

The documentation for this class was generated from the following file:

couchbase/boolean_query.hxx

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ encode()

◆ must() [1/3]

◆ must() [2/3]

◆ must() [3/3]

◆ must_not() [1/3]

◆ must_not() [2/3]

◆ must_not() [3/3]

◆ should() [1/3]

◆ should() [2/3]

◆ should() [3/3]