clang-tools 20.0.0git
QueryParser.h
Go to the documentation of this file.
1//===--- QueryParser.h - clang-query ----------------------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8
9#ifndef LLVM_CLANG_TOOLS_EXTRA_CLANG_QUERY_QUERY_PARSER_H
10#define LLVM_CLANG_TOOLS_EXTRA_CLANG_QUERY_QUERY_PARSER_H
11
12#include "Query.h"
13#include "QuerySession.h"
14#include "llvm/LineEditor/LineEditor.h"
15#include <cstddef>
16
17namespace clang {
18namespace query {
19
20class QuerySession;
21
23public:
24 /// Parse \a Line as a query.
25 ///
26 /// \return A QueryRef representing the query, which may be an InvalidQuery.
27 static QueryRef parse(StringRef Line, const QuerySession &QS);
28
29 /// Compute a list of completions for \a Line assuming a cursor at
30 /// \param Pos characters past the start of \a Line, ordered from most
31 /// likely to least likely.
32 ///
33 /// \return A vector of completions for \a Line.
34 static std::vector<llvm::LineEditor::Completion>
35 complete(StringRef Line, size_t Pos, const QuerySession &QS);
36
37private:
38 QueryParser(StringRef Line, const QuerySession &QS)
39 : Line(Line), CompletionPos(nullptr), QS(QS) {}
40
41 StringRef lexWord();
42
43 template <typename T> struct LexOrCompleteWord;
44
45 QueryRef parseSetBool(bool QuerySession::*Var);
46 QueryRef parseSetTraversalKind(TraversalKind QuerySession::*Var);
47 template <typename QueryType> QueryRef parseSetOutputKind();
48 QueryRef completeMatcherExpression();
49
50 QueryRef endQuery(QueryRef Q);
51
52 /// Parse [\p Begin,\p End).
53 ///
54 /// \return A reference to the parsed query object, which may be an
55 /// \c InvalidQuery if a parse error occurs.
56 QueryRef doParse();
57
58 StringRef Line;
59
60 const char *CompletionPos;
61 std::vector<llvm::LineEditor::Completion> Completions;
62
63 const QuerySession &QS;
64};
65
66} // namespace query
67} // namespace clang
68
69#endif // LLVM_CLANG_TOOLS_EXTRA_CLANG_QUERY_QUERY_PARSER_H
size_t Pos
static QueryRef parse(StringRef Line, const QuerySession &QS)
Parse Line as a query.
static std::vector< llvm::LineEditor::Completion > complete(StringRef Line, size_t Pos, const QuerySession &QS)
Compute a list of completions for Line assuming a cursor at.
Represents the state for a particular clang-query session.
Definition: QuerySession.h:24
llvm::IntrusiveRefCntPtr< Query > QueryRef
Definition: Query.h:52
===– Representation.cpp - ClangDoc Representation --------—*- C++ -*-===//