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

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

a query that contains a term

## NAME

Plucene::Search::TermQuery - a query that contains a term

## SYNOPSIS

```
        # isa Plucene::Search::Query
        $term_query->normalize($norm);
        my       $ssw = $term_query->sum_squared_weights($searcher);
        my $as_string = $term_query->as_string($field);
```

## DESCRIPTION

A query that matches a document containing a term.

Term query are the simplest possible Plucene queries and are used to match a  single word. Term queries are represented by instances of the TermQuery class  and contain the desired term (word) and a field name, both are case sensitive.

The field specified in a Term query must be a document field that was specified  as 'indexible' during the indexing process. If the field was specified during  indexing as 'tokenized' than the term will be matched against each of tokens  (words) found in that field, otherwise, it will be matched against the entire  content of that field.

A term query may have an optional boost factor (default = 1.0) that allows to  increase or decrease the ranking of documents it matches.

## METHODS

### term / idf / weight

Get / set these attributes

### sum\_squared\_weights

```
        my $ssw = $term_query->sum_squared_weights($searcher);
```

This will return the sum squared weights for the passed in searcher.

### normalize

```
        $term_query->normalize($norm);
```

### to\_string

```
        my $as_string = $term_query->as_string($field);
```