Tooling/Transformer/Parsing.h

0001 //===--- Parsing.h - Parsing library for Transformer ------------*- C++ -*-===//
0002 //
0003 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
0004 // See https://llvm.org/LICENSE.txt for license information.
0005 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
0006 //
0007 //===----------------------------------------------------------------------===//
0008 ///
0009 ///  \file
0010 ///  Defines parsing functions for Transformer types.
0011 ///  FIXME: Currently, only supports `RangeSelectors` but parsers for other
0012 ///  Transformer types are under development.
0013 ///
0014 //===----------------------------------------------------------------------===//
0015
0016 #ifndef LLVM_CLANG_TOOLING_TRANSFORMER_PARSING_H
0017 #define LLVM_CLANG_TOOLING_TRANSFORMER_PARSING_H
0018
0019 #include "clang/ASTMatchers/ASTMatchFinder.h"
0020 #include "clang/Basic/SourceLocation.h"
0021 #include "clang/Tooling/Transformer/RangeSelector.h"
0022 #include "llvm/Support/Error.h"
0023 #include <functional>
0024
0025 namespace clang {
0026 namespace transformer {
0027
0028 /// Parses a string representation of a \c RangeSelector. The grammar of these
0029 /// strings is closely based on the (sub)grammar of \c RangeSelectors as they'd
0030 /// appear in C++ code. However, this language constrains the set of permissible
0031 /// strings (for node ids) -- it does not support escapes in the
0032 /// string. Additionally, the \c charRange combinator is not supported, because
0033 /// there is no representation of values of type \c CharSourceRange in this
0034 /// (little) language.
0035 llvm::Expected<RangeSelector> parseRangeSelector(llvm::StringRef Input);
0036
0037 } // namespace transformer
0038 } // namespace clang
0039
0040 #endif // LLVM_CLANG_TOOLING_TRANSFORMER_PARSING_H