---
name: "Plucene::Search::PhraseQuery"
section: "3pm"
platform: "linux"
package: "libplucene-perl"
version: "1.25-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Plucene::Search::PhraseQuery"
---

# Plucene::Search::PhraseQuery(3pm)

A query that matchs a phrase

## NAME

Plucene::Search::PhraseQuery - A query that matchs a phrase

## SYNOPSIS

```
        # isa Plucene::Search::Query
```

## DESCRIPTION

A Query that matches documents containing a particular sequence of terms.

A phrase query represents a query that is matched against a consecutive  sequence of terms in the field. For example, the phrase query 'winding road'  should match 'winding road' but not 'road winding' (with the exception of  more relaxed slop factors).

Phrase queries are represented in Plucene's API by instances of the  PharseQuery class.  These instances contain an ordered list of Term objects  that represent the terms to match. For obvious reasons, all terms in a  PhraseQuery must refer to the same field.

A phrase query may have an optional boost factor and an optional slop  parameter (default = 0). The slop parameter can be used to relax the phrase  matching by accepting somewhat out of order sequences of the terms.

## METHODS

### add

Adds a term to the end of the query phrase.

### sum\_squared\_weights

The sum squared weights of this query.

### normalize

Normalize the query.

### to\_string

Prints a user-readable version of this query.
