## org.apache.lucene.search
Class WildcardQuery

    java.lang.Object
      org.apache.lucene.search.Query
          org.apache.lucene.search.MultiTermQuery
              org.apache.lucene.search.AutomatonQuery
                  org.apache.lucene.search.WildcardQuery

All Implemented Interfaces:
  Cloneable

    public class WildcardQuery

extends AutomatonQuery

Implements the wildcard search query. Supported wildcards are `*`, which matches any character sequence (including the empty one), and `?`, which matches any single character. '\' is the escape character.

Note this query can be slow, as it needs to iterate over many terms. In order to prevent extremely slow WildcardQueries, a Wildcard term should not start with the wildcard `*`

This query uses the `MultiTermQuery.CONSTANT_SCORE_AUTO_REWRITE_DEFAULT` rewrite method.

See Also:
  `AutomatonQuery`

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.lucene.search.MultiTermQuery
`MultiTermQuery.ConstantScoreAutoRewrite, MultiTermQuery.RewriteMethod, MultiTermQuery.TopTermsBoostOnlyBooleanQueryRewrite, MultiTermQuery.TopTermsScoringBooleanQueryRewrite`

Field Summary
`static char` `WILDCARD_CHAR` Char equality with support for wildcards
`static char` `WILDCARD_ESCAPE` Escape character
`static char` `WILDCARD_STRING` String equality with support for wildcards

Fields inherited from class org.apache.lucene.search.AutomatonQuery
`automaton, compiled, term`

Fields inherited from class org.apache.lucene.search.MultiTermQuery
`CONSTANT_SCORE_AUTO_REWRITE_DEFAULT, CONSTANT_SCORE_BOOLEAN_QUERY_REWRITE, CONSTANT_SCORE_FILTER_REWRITE, field, rewriteMethod, SCORING_BOOLEAN_QUERY_REWRITE`

Constructor Summary
`WildcardQuery(Term term)` Constructs a query for terms matching `term`.

Method Summary
`Term` `getTerm()` Returns the pattern term.
`static Automaton` `toAutomaton(Term wildcardquery)` Convert Lucene wildcard syntax into an automaton.
`String` `toString(String field)` Prints a user-readable version of this query.

Methods inherited from class org.apache.lucene.search.AutomatonQuery
`equals, getTermsEnum, hashCode`

Methods inherited from class org.apache.lucene.search.MultiTermQuery
`getField, getRewriteMethod, getTermsEnum, rewrite, setRewriteMethod`

Methods inherited from class org.apache.lucene.search.Query
`clone, createWeight, extractTerms, getBoost, setBoost, toString`

Methods inherited from class java.lang.Object
`finalize, getClass, notify, notifyAll, wait, wait, wait`

Field Detail

### WILDCARD_STRING

    public static final char WILDCARD_STRING

  String equality with support for wildcards

  See Also:
    Constant Field Values

### WILDCARD_CHAR

    public static final char WILDCARD_CHAR

  Char equality with support for wildcards

  See Also:
    Constant Field Values

### WILDCARD_ESCAPE

    public static final char WILDCARD_ESCAPE

  Escape character

  See Also:
    Constant Field Values

Constructor Detail

### WildcardQuery

    public WildcardQuery(Term term)

  Constructs a query for terms matching `term`.

Method Detail

### toAutomaton

    public static Automaton toAutomaton(Term wildcardquery)

  Convert Lucene wildcard syntax into an automaton.

  NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.

### getTerm

    public Term getTerm()

  Returns the pattern term.

### toString

    public String toString(String field)

  Prints a user-readable version of this query.

  Overrides:
    `toString` in class `AutomatonQuery`

Copyright © 2000-2013 Apache Software Foundation. All Rights Reserved.