Version: 2023.2
LanguageEnglish
  • C#

SearchQueryError

class in UnityEditor.Search

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

Represents a query parsing error.

This class is only used in the context of SearchProviders, when performing a search. It allows a SearchProvider to report error during the parsing of the search query. Here is an example of a SearchProvider that uses a QueryEngine and reports parsing errors:

public IEnumerable<T> Search(SearchContext context, SearchProvider provider, IEnumerable<T> subset = null)
{
    var query = m_QueryEngine.ParseQuery(context.searchQuery, true);
    if (!query.valid)
    {
        if (reportError)
            context.AddSearchQueryErrors(query.errors.Select(e => new SearchQueryError(e, context, provider)));
        return Enumerable.Empty<T>();
    }

    m_DoFuzzyMatch = query.HasToggle("fuzzy");
    IEnumerable<T> gameObjects = subset ?? m_Objects;
    return query.Apply(gameObjects, false);
}

In the previous example, the function "Search" would be called by the provider's fetchItem.

In the Search window, the errors are shown when there is no result available. .

Properties

contextThe context in which this error was logged.
indexIndex where the error occurred.
lengthLength of the block that was being parsed.
providerWhich search provider logged this error.
reasonThe reason for the error.
typeThe type of query error.

Constructors

SearchQueryErrorCreates a new SearchQueryError.