/build/source/clang/include/clang/AST/NestedNameSpecifier.h

Bug Summary

File:	build/source/clang/include/clang/AST/NestedNameSpecifier.h
Warning:	line 386, column 7 Attempt to free released memory

Annotated Source Code

Press '?' to see keyboard shortcuts

Show analyzer invocation

clang -cc1 -cc1 -triple x86_64-pc-linux-gnu -analyze -disable-free -clear-ast-before-backend -disable-llvm-verifier -discard-value-names -main-file-name SemaCodeComplete.cpp -analyzer-checker=core -analyzer-checker=apiModeling -analyzer-checker=unix -analyzer-checker=deadcode -analyzer-checker=cplusplus -analyzer-checker=security.insecureAPI.UncheckedReturn -analyzer-checker=security.insecureAPI.getpw -analyzer-checker=security.insecureAPI.gets -analyzer-checker=security.insecureAPI.mktemp -analyzer-checker=security.insecureAPI.mkstemp -analyzer-checker=security.insecureAPI.vfork -analyzer-checker=nullability.NullPassedToNonnull -analyzer-checker=nullability.NullReturnedFromNonnull -analyzer-output plist -w -setup-static-analyzer -analyzer-config-compatibility-mode=true -mrelocation-model pic -pic-level 2 -mframe-pointer=none -relaxed-aliasing -fmath-errno -ffp-contract=on -fno-rounding-math -mconstructor-aliases -funwind-tables=2 -target-cpu x86-64 -tune-cpu generic -debugger-tuning=gdb -ffunction-sections -fdata-sections -fcoverage-compilation-dir=/build/source/build-llvm -resource-dir /usr/lib/llvm-17/lib/clang/17 -I tools/clang/lib/Sema -I /build/source/clang/lib/Sema -I /build/source/clang/include -I tools/clang/include -I include -I /build/source/llvm/include -D _DEBUG -D _GLIBCXX_ASSERTIONS -D _GNU_SOURCE -D _LIBCPP_ENABLE_ASSERTIONS -D __STDC_CONSTANT_MACROS -D __STDC_FORMAT_MACROS -D __STDC_LIMIT_MACROS -D _FORTIFY_SOURCE=2 -D NDEBUG -U NDEBUG -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/10/../../../../include/c++/10 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/10/../../../../include/x86_64-linux-gnu/c++/10 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/10/../../../../include/c++/10/backward -internal-isystem /usr/lib/llvm-17/lib/clang/17/include -internal-isystem /usr/local/include -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/10/../../../../x86_64-linux-gnu/include -internal-externc-isystem /usr/include/x86_64-linux-gnu -internal-externc-isystem /include -internal-externc-isystem /usr/include -fmacro-prefix-map=/build/source/build-llvm=build-llvm -fmacro-prefix-map=/build/source/= -fcoverage-prefix-map=/build/source/build-llvm=build-llvm -fcoverage-prefix-map=/build/source/= -O3 -Wno-unused-command-line-argument -Wno-unused-parameter -Wwrite-strings -Wno-missing-field-initializers -Wno-long-long -Wno-maybe-uninitialized -Wno-class-memaccess -Wno-redundant-move -Wno-pessimizing-move -Wno-noexcept-type -Wno-comment -Wno-misleading-indentation -std=c++17 -fdeprecated-macro -fdebug-compilation-dir=/build/source/build-llvm -fdebug-prefix-map=/build/source/build-llvm=build-llvm -fdebug-prefix-map=/build/source/= -fdebug-prefix-map=/build/source/build-llvm=build-llvm -fdebug-prefix-map=/build/source/= -ferror-limit 19 -fvisibility-inlines-hidden -stack-protector 2 -fgnuc-version=4.2.1 -fcolor-diagnostics -vectorize-loops -vectorize-slp -analyzer-output=html -analyzer-config stable-report-filename=true -faddrsig -D__GCC_HAVE_DWARF2_CFI_ASM=1 -o /tmp/scan-build-2023-05-10-133810-16478-1 -x c++ /build/source/clang/lib/Sema/SemaCodeComplete.cpp

/build/source/clang/lib/Sema/SemaCodeComplete.cpp

→

1//===---------------- SemaCodeComplete.cpp - Code Completion ----*- 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//  This file defines the code-completion semantic actions.
10//
11//===----------------------------------------------------------------------===//
12#include "clang/AST/ASTConcept.h"
13#include "clang/AST/Decl.h"
14#include "clang/AST/DeclBase.h"
15#include "clang/AST/DeclCXX.h"
16#include "clang/AST/DeclObjC.h"
17#include "clang/AST/DeclTemplate.h"
18#include "clang/AST/Expr.h"
19#include "clang/AST/ExprCXX.h"
20#include "clang/AST/ExprConcepts.h"
21#include "clang/AST/ExprObjC.h"
22#include "clang/AST/NestedNameSpecifier.h"
23#include "clang/AST/QualTypeNames.h"
24#include "clang/AST/RecursiveASTVisitor.h"
25#include "clang/AST/Type.h"
26#include "clang/Basic/AttributeCommonInfo.h"
27#include "clang/Basic/CharInfo.h"
28#include "clang/Basic/OperatorKinds.h"
29#include "clang/Basic/Specifiers.h"
30#include "clang/Lex/HeaderSearch.h"
31#include "clang/Lex/MacroInfo.h"
32#include "clang/Lex/Preprocessor.h"
33#include "clang/Sema/CodeCompleteConsumer.h"
34#include "clang/Sema/DeclSpec.h"
35#include "clang/Sema/Designator.h"
36#include "clang/Sema/Lookup.h"
37#include "clang/Sema/Overload.h"
38#include "clang/Sema/ParsedAttr.h"
39#include "clang/Sema/ParsedTemplate.h"
40#include "clang/Sema/Scope.h"
41#include "clang/Sema/ScopeInfo.h"
42#include "clang/Sema/Sema.h"
43#include "clang/Sema/SemaInternal.h"
44#include "llvm/ADT/ArrayRef.h"
45#include "llvm/ADT/DenseSet.h"
46#include "llvm/ADT/SmallBitVector.h"
47#include "llvm/ADT/SmallPtrSet.h"
48#include "llvm/ADT/SmallString.h"
49#include "llvm/ADT/StringExtras.h"
50#include "llvm/ADT/StringSwitch.h"
51#include "llvm/ADT/Twine.h"
52#include "llvm/ADT/iterator_range.h"
53#include "llvm/Support/Casting.h"
54#include "llvm/Support/Path.h"
55#include "llvm/Support/raw_ostream.h"

57#include <list>
58#include <map>
59#include <optional>
60#include <string>
61#include <vector>

63using namespace clang;
64using namespace sema;

66namespace {
67/// A container of code-completion results.
68class ResultBuilder {
69public:
/// The type of a name-lookup filter, which can be provided to the
/// name-lookup routines to specify which declarations should be included in
/// the result set (when it returns true) and which declarations should be
/// filtered out (returns false).
typedef bool (ResultBuilder::*LookupFilter)(const NamedDecl *) const;

typedef CodeCompletionResult Result;

78private:
/// The actual results we have found.
std::vector<Result> Results;

/// A record of all of the declarations we have found and placed
/// into the result set, used to ensure that no declaration ever gets into
/// the result set twice.
llvm::SmallPtrSet<const Decl *, 16> AllDeclsFound;

typedef std::pair<const NamedDecl *, unsigned> DeclIndexPair;

/// An entry in the shadow map, which is optimized to store
/// a single (declaration, index) mapping (the common case) but
/// can also store a list of (declaration, index) mappings.
class ShadowMapEntry {
  typedef SmallVector<DeclIndexPair, 4> DeclIndexPairVector;

  /// Contains either the solitary NamedDecl * or a vector
  /// of (declaration, index) pairs.
  llvm::PointerUnion<const NamedDecl *, DeclIndexPairVector *> DeclOrVector;

  /// When the entry contains a single declaration, this is
  /// the index associated with that entry.
  unsigned SingleDeclIndex;

public:
  ShadowMapEntry() : SingleDeclIndex(0) {}
  ShadowMapEntry(const ShadowMapEntry &) = delete;
  ShadowMapEntry(ShadowMapEntry &&Move) { *this = std::move(Move); }
  ShadowMapEntry &operator=(const ShadowMapEntry &) = delete;
  ShadowMapEntry &operator=(ShadowMapEntry &&Move) {
    SingleDeclIndex = Move.SingleDeclIndex;
    DeclOrVector = Move.DeclOrVector;
    Move.DeclOrVector = nullptr;
    return *this;
  }

  void Add(const NamedDecl *ND, unsigned Index) {
    if (DeclOrVector.isNull()) {
      // 0 - > 1 elements: just set the single element information.
      DeclOrVector = ND;
      SingleDeclIndex = Index;
      return;
    }

    if (const NamedDecl *PrevND =
            DeclOrVector.dyn_cast<const NamedDecl *>()) {
      // 1 -> 2 elements: create the vector of results and push in the
      // existing declaration.
      DeclIndexPairVector *Vec = new DeclIndexPairVector;
      Vec->push_back(DeclIndexPair(PrevND, SingleDeclIndex));
      DeclOrVector = Vec;
    }

    // Add the new element to the end of the vector.
    DeclOrVector.get<DeclIndexPairVector *>()->push_back(
        DeclIndexPair(ND, Index));
  }

  ~ShadowMapEntry() {
    if (DeclIndexPairVector *Vec =
            DeclOrVector.dyn_cast<DeclIndexPairVector *>()) {
      delete Vec;
      DeclOrVector = ((NamedDecl *)nullptr);
    }
  }

  // Iteration.
  class iterator;
  iterator begin() const;
  iterator end() const;
};

/// A mapping from declaration names to the declarations that have
/// this name within a particular scope and their index within the list of
/// results.
typedef llvm::DenseMap<DeclarationName, ShadowMapEntry> ShadowMap;

/// The semantic analysis object for which results are being
/// produced.
Sema &SemaRef;

/// The allocator used to allocate new code-completion strings.
CodeCompletionAllocator &Allocator;

CodeCompletionTUInfo &CCTUInfo;

/// If non-NULL, a filter function used to remove any code-completion
/// results that are not desirable.
LookupFilter Filter;

/// Whether we should allow declarations as
/// nested-name-specifiers that would otherwise be filtered out.
bool AllowNestedNameSpecifiers;

/// If set, the type that we would prefer our resulting value
/// declarations to have.
///
/// Closely matching the preferred type gives a boost to a result's
/// priority.
CanQualType PreferredType;

/// A list of shadow maps, which is used to model name hiding at
/// different levels of, e.g., the inheritance hierarchy.
std::list<ShadowMap> ShadowMaps;

/// Overloaded C++ member functions found by SemaLookup.
/// Used to determine when one overload is dominated by another.
llvm::DenseMap<std::pair<DeclContext *, /*Name*/uintptr_t>, ShadowMapEntry>
    OverloadMap;

/// If we're potentially referring to a C++ member function, the set
/// of qualifiers applied to the object type.
Qualifiers ObjectTypeQualifiers;
/// The kind of the object expression, for rvalue/lvalue overloads.
ExprValueKind ObjectKind;

/// Whether the \p ObjectTypeQualifiers field is active.
bool HasObjectTypeQualifiers;

/// The selector that we prefer.
Selector PreferredSelector;

/// The completion context in which we are gathering results.
CodeCompletionContext CompletionContext;

/// If we are in an instance method definition, the \@implementation
/// object.
ObjCImplementationDecl *ObjCImplementation;

void AdjustResultPriorityForDecl(Result &R);

void MaybeAddConstructorResults(Result R);

212public:
explicit ResultBuilder(Sema &SemaRef, CodeCompletionAllocator &Allocator,
                       CodeCompletionTUInfo &CCTUInfo,
                       const CodeCompletionContext &CompletionContext,
                       LookupFilter Filter = nullptr)
    : SemaRef(SemaRef), Allocator(Allocator), CCTUInfo(CCTUInfo),
      Filter(Filter), AllowNestedNameSpecifiers(false),
      HasObjectTypeQualifiers(false), CompletionContext(CompletionContext),
      ObjCImplementation(nullptr) {
  // If this is an Objective-C instance method definition, dig out the
  // corresponding implementation.
  switch (CompletionContext.getKind()) {
  case CodeCompletionContext::CCC_Expression:
  case CodeCompletionContext::CCC_ObjCMessageReceiver:
  case CodeCompletionContext::CCC_ParenthesizedExpression:
  case CodeCompletionContext::CCC_Statement:
  case CodeCompletionContext::CCC_Recovery:
    if (ObjCMethodDecl *Method = SemaRef.getCurMethodDecl())
      if (Method->isInstanceMethod())
        if (ObjCInterfaceDecl *Interface = Method->getClassInterface())
          ObjCImplementation = Interface->getImplementation();
    break;

  default:
    break;
  }
}

/// Determine the priority for a reference to the given declaration.
unsigned getBasePriority(const NamedDecl *D);

/// Whether we should include code patterns in the completion
/// results.
bool includeCodePatterns() const {
  return SemaRef.CodeCompleter &&
         SemaRef.CodeCompleter->includeCodePatterns();
}

/// Set the filter used for code-completion results.
void setFilter(LookupFilter Filter) { this->Filter = Filter; }

Result *data() { return Results.empty() ? nullptr : &Results.front(); }
unsigned size() const { return Results.size(); }
bool empty() const { return Results.empty(); }

/// Specify the preferred type.
void setPreferredType(QualType T) {
  PreferredType = SemaRef.Context.getCanonicalType(T);
}

/// Set the cv-qualifiers on the object type, for us in filtering
/// calls to member functions.
///
/// When there are qualifiers in this set, they will be used to filter
/// out member functions that aren't available (because there will be a
/// cv-qualifier mismatch) or prefer functions with an exact qualifier
/// match.
void setObjectTypeQualifiers(Qualifiers Quals, ExprValueKind Kind) {
  ObjectTypeQualifiers = Quals;
  ObjectKind = Kind;
  HasObjectTypeQualifiers = true;
}

/// Set the preferred selector.
///
/// When an Objective-C method declaration result is added, and that
/// method's selector matches this preferred selector, we give that method
/// a slight priority boost.
void setPreferredSelector(Selector Sel) { PreferredSelector = Sel; }

/// Retrieve the code-completion context for which results are
/// being collected.
const CodeCompletionContext &getCompletionContext() const {
  return CompletionContext;
}

/// Specify whether nested-name-specifiers are allowed.
void allowNestedNameSpecifiers(bool Allow = true) {
  AllowNestedNameSpecifiers = Allow;
}

/// Return the semantic analysis object for which we are collecting
/// code completion results.
Sema &getSema() const { return SemaRef; }

/// Retrieve the allocator used to allocate code completion strings.
CodeCompletionAllocator &getAllocator() const { return Allocator; }

CodeCompletionTUInfo &getCodeCompletionTUInfo() const { return CCTUInfo; }

/// Determine whether the given declaration is at all interesting
/// as a code-completion result.
///
/// \param ND the declaration that we are inspecting.
///
/// \param AsNestedNameSpecifier will be set true if this declaration is
/// only interesting when it is a nested-name-specifier.
bool isInterestingDecl(const NamedDecl *ND,
                       bool &AsNestedNameSpecifier) const;

/// Check whether the result is hidden by the Hiding declaration.
///
/// \returns true if the result is hidden and cannot be found, false if
/// the hidden result could still be found. When false, \p R may be
/// modified to describe how the result can be found (e.g., via extra
/// qualification).
bool CheckHiddenResult(Result &R, DeclContext *CurContext,
                       const NamedDecl *Hiding);

/// Add a new result to this result set (if it isn't already in one
/// of the shadow maps), or replace an existing result (for, e.g., a
/// redeclaration).
///
/// \param R the result to add (if it is unique).
///
/// \param CurContext the context in which this result will be named.
void MaybeAddResult(Result R, DeclContext *CurContext = nullptr);

/// Add a new result to this result set, where we already know
/// the hiding declaration (if any).
///
/// \param R the result to add (if it is unique).
///
/// \param CurContext the context in which this result will be named.
///
/// \param Hiding the declaration that hides the result.
///
/// \param InBaseClass whether the result was found in a base
/// class of the searched context.
void AddResult(Result R, DeclContext *CurContext, NamedDecl *Hiding,
               bool InBaseClass);

/// Add a new non-declaration result to this result set.
void AddResult(Result R);

/// Enter into a new scope.
void EnterNewScope();

/// Exit from the current scope.
void ExitScope();

/// Ignore this declaration, if it is seen again.
void Ignore(const Decl *D) { AllDeclsFound.insert(D->getCanonicalDecl()); }

/// Add a visited context.
void addVisitedContext(DeclContext *Ctx) {
  CompletionContext.addVisitedContext(Ctx);
}

/// \name Name lookup predicates
///
/// These predicates can be passed to the name lookup functions to filter the
/// results of name lookup. All of the predicates have the same type, so that
///
//@{
bool IsOrdinaryName(const NamedDecl *ND) const;
bool IsOrdinaryNonTypeName(const NamedDecl *ND) const;
bool IsIntegralConstantValue(const NamedDecl *ND) const;
bool IsOrdinaryNonValueName(const NamedDecl *ND) const;
bool IsNestedNameSpecifier(const NamedDecl *ND) const;
bool IsEnum(const NamedDecl *ND) const;
bool IsClassOrStruct(const NamedDecl *ND) const;
bool IsUnion(const NamedDecl *ND) const;
bool IsNamespace(const NamedDecl *ND) const;
bool IsNamespaceOrAlias(const NamedDecl *ND) const;
bool IsType(const NamedDecl *ND) const;
bool IsMember(const NamedDecl *ND) const;
bool IsObjCIvar(const NamedDecl *ND) const;
bool IsObjCMessageReceiver(const NamedDecl *ND) const;
bool IsObjCMessageReceiverOrLambdaCapture(const NamedDecl *ND) const;
bool IsObjCCollection(const NamedDecl *ND) const;
bool IsImpossibleToSatisfy(const NamedDecl *ND) const;
//@}
385};
386} // namespace

388void PreferredTypeBuilder::enterReturn(Sema &S, SourceLocation Tok) {
if (!Enabled)
  return;
if (isa<BlockDecl>(S.CurContext)) {
  if (sema::BlockScopeInfo *BSI = S.getCurBlock()) {
    ComputeType = nullptr;
    Type = BSI->ReturnType;
    ExpectedLoc = Tok;
  }
} else if (const auto *Function = dyn_cast<FunctionDecl>(S.CurContext)) {
  ComputeType = nullptr;
  Type = Function->getReturnType();
  ExpectedLoc = Tok;
} else if (const auto *Method = dyn_cast<ObjCMethodDecl>(S.CurContext)) {
  ComputeType = nullptr;
  Type = Method->getReturnType();
  ExpectedLoc = Tok;
}
406}

408void PreferredTypeBuilder::enterVariableInit(SourceLocation Tok, Decl *D) {
if (!Enabled)
  return;
auto *VD = llvm::dyn_cast_or_null<ValueDecl>(D);
ComputeType = nullptr;
Type = VD ? VD->getType() : QualType();
ExpectedLoc = Tok;
415}

417static QualType getDesignatedType(QualType BaseType, const Designation &Desig);

419void PreferredTypeBuilder::enterDesignatedInitializer(SourceLocation Tok,
                                                    QualType BaseType,
                                                    const Designation &D) {
if (!Enabled)
  return;
ComputeType = nullptr;
Type = getDesignatedType(BaseType, D);
ExpectedLoc = Tok;
427}

429void PreferredTypeBuilder::enterFunctionArgument(
  SourceLocation Tok, llvm::function_ref<QualType()> ComputeType) {
if (!Enabled)
  return;
this->ComputeType = ComputeType;
Type = QualType();
ExpectedLoc = Tok;
436}

438void PreferredTypeBuilder::enterParenExpr(SourceLocation Tok,
                                        SourceLocation LParLoc) {
if (!Enabled)
  return;
// expected type for parenthesized expression does not change.
if (ExpectedLoc == LParLoc)
  ExpectedLoc = Tok;
445}

447static QualType getPreferredTypeOfBinaryRHS(Sema &S, Expr *LHS,
                                          tok::TokenKind Op) {
if (!LHS)
  return QualType();

QualType LHSType = LHS->getType();
if (LHSType->isPointerType()) {
  if (Op == tok::plus || Op == tok::plusequal || Op == tok::minusequal)
    return S.getASTContext().getPointerDiffType();
  // Pointer difference is more common than subtracting an int from a pointer.
  if (Op == tok::minus)
    return LHSType;
}

switch (Op) {
// No way to infer the type of RHS from LHS.
case tok::comma:
  return QualType();
// Prefer the type of the left operand for all of these.
// Arithmetic operations.
case tok::plus:
case tok::plusequal:
case tok::minus:
case tok::minusequal:
case tok::percent:
case tok::percentequal:
case tok::slash:
case tok::slashequal:
case tok::star:
case tok::starequal:
// Assignment.
case tok::equal:
// Comparison operators.
case tok::equalequal:
case tok::exclaimequal:
case tok::less:
case tok::lessequal:
case tok::greater:
case tok::greaterequal:
case tok::spaceship:
  return LHS->getType();
// Binary shifts are often overloaded, so don't try to guess those.
case tok::greatergreater:
case tok::greatergreaterequal:
case tok::lessless:
case tok::lesslessequal:
  if (LHSType->isIntegralOrEnumerationType())
    return S.getASTContext().IntTy;
  return QualType();
// Logical operators, assume we want bool.
case tok::ampamp:
case tok::pipepipe:
case tok::caretcaret:
  return S.getASTContext().BoolTy;
// Operators often used for bit manipulation are typically used with the type
// of the left argument.
case tok::pipe:
case tok::pipeequal:
case tok::caret:
case tok::caretequal:
case tok::amp:
case tok::ampequal:
  if (LHSType->isIntegralOrEnumerationType())
    return LHSType;
  return QualType();
// RHS should be a pointer to a member of the 'LHS' type, but we can't give
// any particular type here.
case tok::periodstar:
case tok::arrowstar:
  return QualType();
default:
  // FIXME(ibiryukov): handle the missing op, re-add the assertion.
  // assert(false && "unhandled binary op");
  return QualType();
}
522}

524/// Get preferred type for an argument of an unary expression. \p ContextType is
525/// preferred type of the whole unary expression.
526static QualType getPreferredTypeOfUnaryArg(Sema &S, QualType ContextType,
                                         tok::TokenKind Op) {
switch (Op) {
case tok::exclaim:
  return S.getASTContext().BoolTy;
case tok::amp:
  if (!ContextType.isNull() && ContextType->isPointerType())
    return ContextType->getPointeeType();
  return QualType();
case tok::star:
  if (ContextType.isNull())
    return QualType();
  return S.getASTContext().getPointerType(ContextType.getNonReferenceType());
case tok::plus:
case tok::minus:
case tok::tilde:
case tok::minusminus:
case tok::plusplus:
  if (ContextType.isNull())
    return S.getASTContext().IntTy;
  // leave as is, these operators typically return the same type.
  return ContextType;
case tok::kw___real:
case tok::kw___imag:
  return QualType();
default:
  assert(false && "unhandled unary op")(static_cast <bool> (false && "unhandled unary op"
) ? void (0) : __assert_fail ("false && \"unhandled unary op\""
, "clang/lib/Sema/SemaCodeComplete.cpp", 552, __extension__ __PRETTY_FUNCTION__
));
  return QualType();
}
555}

557void PreferredTypeBuilder::enterBinary(Sema &S, SourceLocation Tok, Expr *LHS,
                                     tok::TokenKind Op) {
if (!Enabled)
  return;
ComputeType = nullptr;
Type = getPreferredTypeOfBinaryRHS(S, LHS, Op);
ExpectedLoc = Tok;
564}

566void PreferredTypeBuilder::enterMemAccess(Sema &S, SourceLocation Tok,
                                        Expr *Base) {
if (!Enabled || !Base)
  return;
// Do we have expected type for Base?
if (ExpectedLoc != Base->getBeginLoc())
  return;
// Keep the expected type, only update the location.
ExpectedLoc = Tok;
575}

577void PreferredTypeBuilder::enterUnary(Sema &S, SourceLocation Tok,
                                    tok::TokenKind OpKind,
                                    SourceLocation OpLoc) {
if (!Enabled)
  return;
ComputeType = nullptr;
Type = getPreferredTypeOfUnaryArg(S, this->get(OpLoc), OpKind);
ExpectedLoc = Tok;
585}

587void PreferredTypeBuilder::enterSubscript(Sema &S, SourceLocation Tok,
                                        Expr *LHS) {
if (!Enabled)
  return;
ComputeType = nullptr;
Type = S.getASTContext().IntTy;
ExpectedLoc = Tok;
594}

596void PreferredTypeBuilder::enterTypeCast(SourceLocation Tok,
                                       QualType CastType) {
if (!Enabled)
  return;
ComputeType = nullptr;
Type = !CastType.isNull() ? CastType.getCanonicalType() : QualType();
ExpectedLoc = Tok;
603}

605void PreferredTypeBuilder::enterCondition(Sema &S, SourceLocation Tok) {
if (!Enabled)
  return;
ComputeType = nullptr;
Type = S.getASTContext().BoolTy;
ExpectedLoc = Tok;
611}

613class ResultBuilder::ShadowMapEntry::iterator {
llvm::PointerUnion<const NamedDecl *, const DeclIndexPair *> DeclOrIterator;
unsigned SingleDeclIndex;

617public:
typedef DeclIndexPair value_type;
typedef value_type reference;
typedef std::ptrdiff_t difference_type;
typedef std::input_iterator_tag iterator_category;

class pointer {
  DeclIndexPair Value;

public:
  pointer(const DeclIndexPair &Value) : Value(Value) {}

  const DeclIndexPair *operator->() const { return &Value; }
};

iterator() : DeclOrIterator((NamedDecl *)nullptr), SingleDeclIndex(0) {}

iterator(const NamedDecl *SingleDecl, unsigned Index)
    : DeclOrIterator(SingleDecl), SingleDeclIndex(Index) {}

iterator(const DeclIndexPair *Iterator)
    : DeclOrIterator(Iterator), SingleDeclIndex(0) {}

iterator &operator++() {
  if (DeclOrIterator.is<const NamedDecl *>()) {
    DeclOrIterator = (NamedDecl *)nullptr;
    SingleDeclIndex = 0;
    return *this;
  }

  const DeclIndexPair *I = DeclOrIterator.get<const DeclIndexPair *>();
  ++I;
  DeclOrIterator = I;
  return *this;
}

/*iterator operator++(int) {
  iterator tmp(*this);
  ++(*this);
  return tmp;
}*/

reference operator*() const {
  if (const NamedDecl *ND = DeclOrIterator.dyn_cast<const NamedDecl *>())
    return reference(ND, SingleDeclIndex);

  return *DeclOrIterator.get<const DeclIndexPair *>();
}

pointer operator->() const { return pointer(**this); }

friend bool operator==(const iterator &X, const iterator &Y) {
  return X.DeclOrIterator.getOpaqueValue() ==
             Y.DeclOrIterator.getOpaqueValue() &&
         X.SingleDeclIndex == Y.SingleDeclIndex;
}

friend bool operator!=(const iterator &X, const iterator &Y) {
  return !(X == Y);
}
677};

679ResultBuilder::ShadowMapEntry::iterator
680ResultBuilder::ShadowMapEntry::begin() const {
if (DeclOrVector.isNull())
  return iterator();

if (const NamedDecl *ND = DeclOrVector.dyn_cast<const NamedDecl *>())
  return iterator(ND, SingleDeclIndex);

return iterator(DeclOrVector.get<DeclIndexPairVector *>()->begin());
688}

690ResultBuilder::ShadowMapEntry::iterator
691ResultBuilder::ShadowMapEntry::end() const {
if (DeclOrVector.is<const NamedDecl *>() || DeclOrVector.isNull())
  return iterator();

return iterator(DeclOrVector.get<DeclIndexPairVector *>()->end());
696}

698/// Compute the qualification required to get from the current context
699/// (\p CurContext) to the target context (\p TargetContext).
700///
701/// \param Context the AST context in which the qualification will be used.
702///
703/// \param CurContext the context where an entity is being named, which is
704/// typically based on the current scope.
705///
706/// \param TargetContext the context in which the named entity actually
707/// resides.
708///
709/// \returns a nested name specifier that refers into the target context, or
710/// NULL if no qualification is needed.
711static NestedNameSpecifier *
712getRequiredQualification(ASTContext &Context, const DeclContext *CurContext,
                       const DeclContext *TargetContext) {
SmallVector<const DeclContext *, 4> TargetParents;

for (const DeclContext *CommonAncestor = TargetContext;
     CommonAncestor && !CommonAncestor->Encloses(CurContext);
     CommonAncestor = CommonAncestor->getLookupParent()) {
  if (CommonAncestor->isTransparentContext() ||
      CommonAncestor->isFunctionOrMethod())
    continue;

  TargetParents.push_back(CommonAncestor);
}

NestedNameSpecifier *Result = nullptr;
while (!TargetParents.empty()) {
  const DeclContext *Parent = TargetParents.pop_back_val();

  if (const auto *Namespace = dyn_cast<NamespaceDecl>(Parent)) {
    if (!Namespace->getIdentifier())
      continue;

    Result = NestedNameSpecifier::Create(Context, Result, Namespace);
  } else if (const auto *TD = dyn_cast<TagDecl>(Parent))
    Result = NestedNameSpecifier::Create(
        Context, Result, false, Context.getTypeDeclType(TD).getTypePtr());
}
return Result;
740}

742// Some declarations have reserved names that we don't want to ever show.
743// Filter out names reserved for the implementation if they come from a
744// system header.
745static bool shouldIgnoreDueToReservedName(const NamedDecl *ND, Sema &SemaRef) {
ReservedIdentifierStatus Status = ND->isReserved(SemaRef.getLangOpts());
// Ignore reserved names for compiler provided decls.
if (isReservedInAllContexts(Status) && ND->getLocation().isInvalid())
  return true;

// For system headers ignore only double-underscore names.
// This allows for system headers providing private symbols with a single
// underscore.
if (Status == ReservedIdentifierStatus::StartsWithDoubleUnderscore &&
    SemaRef.SourceMgr.isInSystemHeader(
        SemaRef.SourceMgr.getSpellingLoc(ND->getLocation())))
  return true;

return false;
760}

762bool ResultBuilder::isInterestingDecl(const NamedDecl *ND,
                                    bool &AsNestedNameSpecifier) const {
AsNestedNameSpecifier = false;

auto *Named = ND;
ND = ND->getUnderlyingDecl();

// Skip unnamed entities.
if (!ND->getDeclName())
  return false;

// Friend declarations and declarations introduced due to friends are never
// added as results.
if (ND->getFriendObjectKind() == Decl::FOK_Undeclared)
  return false;

// Class template (partial) specializations are never added as results.
if (isa<ClassTemplateSpecializationDecl>(ND) ||
    isa<ClassTemplatePartialSpecializationDecl>(ND))
  return false;

// Using declarations themselves are never added as results.
if (isa<UsingDecl>(ND))
  return false;

if (shouldIgnoreDueToReservedName(ND, SemaRef))
  return false;

if (Filter == &ResultBuilder::IsNestedNameSpecifier ||
    (isa<NamespaceDecl>(ND) && Filter != &ResultBuilder::IsNamespace &&
     Filter != &ResultBuilder::IsNamespaceOrAlias && Filter != nullptr))
  AsNestedNameSpecifier = true;

// Filter out any unwanted results.
if (Filter && !(this->*Filter)(Named)) {
  // Check whether it is interesting as a nested-name-specifier.
  if (AllowNestedNameSpecifiers && SemaRef.getLangOpts().CPlusPlus &&
      IsNestedNameSpecifier(ND) &&
      (Filter != &ResultBuilder::IsMember ||
       (isa<CXXRecordDecl>(ND) &&
        cast<CXXRecordDecl>(ND)->isInjectedClassName()))) {
    AsNestedNameSpecifier = true;
    return true;
  }

  return false;
}
// ... then it must be interesting!
return true;
811}

813bool ResultBuilder::CheckHiddenResult(Result &R, DeclContext *CurContext,
                                    const NamedDecl *Hiding) {
// In C, there is no way to refer to a hidden name.
// FIXME: This isn't true; we can find a tag name hidden by an ordinary
// name if we introduce the tag type.
if (!SemaRef.getLangOpts().CPlusPlus)
  return true;

const DeclContext *HiddenCtx =
    R.Declaration->getDeclContext()->getRedeclContext();

// There is no way to qualify a name declared in a function or method.
if (HiddenCtx->isFunctionOrMethod())
  return true;

if (HiddenCtx == Hiding->getDeclContext()->getRedeclContext())
  return true;

// We can refer to the result with the appropriate qualification. Do it.
R.Hidden = true;
R.QualifierIsInformative = false;

if (!R.Qualifier)
  R.Qualifier = getRequiredQualification(SemaRef.Context, CurContext,
                                         R.Declaration->getDeclContext());
return false;
839}

841/// A simplified classification of types used to determine whether two
842/// types are "similar enough" when adjusting priorities.
843SimplifiedTypeClass clang::getSimplifiedTypeClass(CanQualType T) {
switch (T->getTypeClass()) {
case Type::Builtin:
  switch (cast<BuiltinType>(T)->getKind()) {
  case BuiltinType::Void:
    return STC_Void;

  case BuiltinType::NullPtr:
    return STC_Pointer;

  case BuiltinType::Overload:
  case BuiltinType::Dependent:
    return STC_Other;

  case BuiltinType::ObjCId:
  case BuiltinType::ObjCClass:
  case BuiltinType::ObjCSel:
    return STC_ObjectiveC;

  default:
    return STC_Arithmetic;
  }

case Type::Complex:
  return STC_Arithmetic;

case Type::Pointer:
  return STC_Pointer;

case Type::BlockPointer:
  return STC_Block;

case Type::LValueReference:
case Type::RValueReference:
  return getSimplifiedTypeClass(T->getAs<ReferenceType>()->getPointeeType());

case Type::ConstantArray:
case Type::IncompleteArray:
case Type::VariableArray:
case Type::DependentSizedArray:
  return STC_Array;

case Type::DependentSizedExtVector:
case Type::Vector:
case Type::ExtVector:
  return STC_Arithmetic;

case Type::FunctionProto:
case Type::FunctionNoProto:
  return STC_Function;

case Type::Record:
  return STC_Record;

case Type::Enum:
  return STC_Arithmetic;

case Type::ObjCObject:
case Type::ObjCInterface:
case Type::ObjCObjectPointer:
  return STC_ObjectiveC;

default:
  return STC_Other;
}
908}

910/// Get the type that a given expression will have if this declaration
911/// is used as an expression in its "typical" code-completion form.
912QualType clang::getDeclUsageType(ASTContext &C, const NamedDecl *ND) {
ND = ND->getUnderlyingDecl();

if (const auto *Type = dyn_cast<TypeDecl>(ND))
  return C.getTypeDeclType(Type);
if (const auto *Iface = dyn_cast<ObjCInterfaceDecl>(ND))
  return C.getObjCInterfaceType(Iface);

QualType T;
if (const FunctionDecl *Function = ND->getAsFunction())
  T = Function->getCallResultType();
else if (const auto *Method = dyn_cast<ObjCMethodDecl>(ND))
  T = Method->getSendResultType();
else if (const auto *Enumerator = dyn_cast<EnumConstantDecl>(ND))
  T = C.getTypeDeclType(cast<EnumDecl>(Enumerator->getDeclContext()));
else if (const auto *Property = dyn_cast<ObjCPropertyDecl>(ND))
  T = Property->getType();
else if (const auto *Value = dyn_cast<ValueDecl>(ND))
  T = Value->getType();

if (T.isNull())
  return QualType();

// Dig through references, function pointers, and block pointers to
// get down to the likely type of an expression when the entity is
// used.
do {
  if (const auto *Ref = T->getAs<ReferenceType>()) {
    T = Ref->getPointeeType();
    continue;
  }

  if (const auto *Pointer = T->getAs<PointerType>()) {
    if (Pointer->getPointeeType()->isFunctionType()) {
      T = Pointer->getPointeeType();
      continue;
    }

    break;
  }

  if (const auto *Block = T->getAs<BlockPointerType>()) {
    T = Block->getPointeeType();
    continue;
  }

  if (const auto *Function = T->getAs<FunctionType>()) {
    T = Function->getReturnType();
    continue;
  }

  break;
} while (true);

return T;
967}

969unsigned ResultBuilder::getBasePriority(const NamedDecl *ND) {
if (!ND)
  return CCP_Unlikely;

// Context-based decisions.
const DeclContext *LexicalDC = ND->getLexicalDeclContext();
if (LexicalDC->isFunctionOrMethod()) {
  // _cmd is relatively rare
  if (const auto *ImplicitParam = dyn_cast<ImplicitParamDecl>(ND))
    if (ImplicitParam->getIdentifier() &&
        ImplicitParam->getIdentifier()->isStr("_cmd"))
      return CCP_ObjC_cmd;

  return CCP_LocalDeclaration;
}

const DeclContext *DC = ND->getDeclContext()->getRedeclContext();
if (DC->isRecord() || isa<ObjCContainerDecl>(DC)) {
  // Explicit destructor calls are very rare.
  if (isa<CXXDestructorDecl>(ND))
    return CCP_Unlikely;
  // Explicit operator and conversion function calls are also very rare.
  auto DeclNameKind = ND->getDeclName().getNameKind();
  if (DeclNameKind == DeclarationName::CXXOperatorName ||
      DeclNameKind == DeclarationName::CXXLiteralOperatorName ||
      DeclNameKind == DeclarationName::CXXConversionFunctionName)
    return CCP_Unlikely;
  return CCP_MemberDeclaration;
}

// Content-based decisions.
if (isa<EnumConstantDecl>(ND))
  return CCP_Constant;

// Use CCP_Type for type declarations unless we're in a statement, Objective-C
// message receiver, or parenthesized expression context. There, it's as
// likely that the user will want to write a type as other declarations.
if ((isa<TypeDecl>(ND) || isa<ObjCInterfaceDecl>(ND)) &&
    !(CompletionContext.getKind() == CodeCompletionContext::CCC_Statement ||
      CompletionContext.getKind() ==
          CodeCompletionContext::CCC_ObjCMessageReceiver ||
      CompletionContext.getKind() ==
          CodeCompletionContext::CCC_ParenthesizedExpression))
  return CCP_Type;

return CCP_Declaration;
1015}

1017void ResultBuilder::AdjustResultPriorityForDecl(Result &R) {
// If this is an Objective-C method declaration whose selector matches our
// preferred selector, give it a priority boost.
if (!PreferredSelector.isNull())
  if (const auto *Method = dyn_cast<ObjCMethodDecl>(R.Declaration))
    if (PreferredSelector == Method->getSelector())
      R.Priority += CCD_SelectorMatch;

// If we have a preferred type, adjust the priority for results with exactly-
// matching or nearly-matching types.
if (!PreferredType.isNull()) {
  QualType T = getDeclUsageType(SemaRef.Context, R.Declaration);
  if (!T.isNull()) {
    CanQualType TC = SemaRef.Context.getCanonicalType(T);
    // Check for exactly-matching types (modulo qualifiers).
    if (SemaRef.Context.hasSameUnqualifiedType(PreferredType, TC))
      R.Priority /= CCF_ExactTypeMatch;
    // Check for nearly-matching types, based on classification of each.
    else if ((getSimplifiedTypeClass(PreferredType) ==
              getSimplifiedTypeClass(TC)) &&
             !(PreferredType->isEnumeralType() && TC->isEnumeralType()))
      R.Priority /= CCF_SimilarTypeMatch;
  }
}
1041}

1043static DeclContext::lookup_result getConstructors(ASTContext &Context,
                                                const CXXRecordDecl *Record) {
QualType RecordTy = Context.getTypeDeclType(Record);
DeclarationName ConstructorName =
    Context.DeclarationNames.getCXXConstructorName(
        Context.getCanonicalType(RecordTy));
return Record->lookup(ConstructorName);
1050}

1052void ResultBuilder::MaybeAddConstructorResults(Result R) {
if (!SemaRef.getLangOpts().CPlusPlus || !R.Declaration ||
    !CompletionContext.wantConstructorResults())
  return;

const NamedDecl *D = R.Declaration;
const CXXRecordDecl *Record = nullptr;
if (const ClassTemplateDecl *ClassTemplate = dyn_cast<ClassTemplateDecl>(D))
  Record = ClassTemplate->getTemplatedDecl();
else if ((Record = dyn_cast<CXXRecordDecl>(D))) {
  // Skip specializations and partial specializations.
  if (isa<ClassTemplateSpecializationDecl>(Record))
    return;
} else {
  // There are no constructors here.
  return;
}

Record = Record->getDefinition();
if (!Record)
  return;

for (NamedDecl *Ctor : getConstructors(SemaRef.Context, Record)) {
  R.Declaration = Ctor;
  R.CursorKind = getCursorKindForDecl(R.Declaration);
  Results.push_back(R);
}
1079}

1081static bool isConstructor(const Decl *ND) {
if (const auto *Tmpl = dyn_cast<FunctionTemplateDecl>(ND))
  ND = Tmpl->getTemplatedDecl();
return isa<CXXConstructorDecl>(ND);
1085}

1087void ResultBuilder::MaybeAddResult(Result R, DeclContext *CurContext) {
assert(!ShadowMaps.empty() && "Must enter into a results scope")(static_cast <bool> (!ShadowMaps.empty() && "Must enter into a results scope"
) ? void (0) : __assert_fail ("!ShadowMaps.empty() && \"Must enter into a results scope\""
, "clang/lib/Sema/SemaCodeComplete.cpp", 1088, __extension__ __PRETTY_FUNCTION__
));

if (R.Kind != Result::RK_Declaration) {
  // For non-declaration results, just add the result.
  Results.push_back(R);
  return;
}

// Look through using declarations.
if (const UsingShadowDecl *Using = dyn_cast<UsingShadowDecl>(R.Declaration)) {
  CodeCompletionResult Result(Using->getTargetDecl(),
                              getBasePriority(Using->getTargetDecl()),
                              R.Qualifier, false,
                              (R.Availability == CXAvailability_Available ||
                               R.Availability == CXAvailability_Deprecated),
                              std::move(R.FixIts));
  Result.ShadowDecl = Using;
  MaybeAddResult(Result, CurContext);
  return;
}

const Decl *CanonDecl = R.Declaration->getCanonicalDecl();
unsigned IDNS = CanonDecl->getIdentifierNamespace();

bool AsNestedNameSpecifier = false;
if (!isInterestingDecl(R.Declaration, AsNestedNameSpecifier))
  return;

// C++ constructors are never found by name lookup.
if (isConstructor(R.Declaration))
  return;

ShadowMap &SMap = ShadowMaps.back();
ShadowMapEntry::iterator I, IEnd;
ShadowMap::iterator NamePos = SMap.find(R.Declaration->getDeclName());
if (NamePos != SMap.end()) {
  I = NamePos->second.begin();
  IEnd = NamePos->second.end();
}

for (; I != IEnd; ++I) {
  const NamedDecl *ND = I->first;
  unsigned Index = I->second;
  if (ND->getCanonicalDecl() == CanonDecl) {
    // This is a redeclaration. Always pick the newer declaration.
    Results[Index].Declaration = R.Declaration;

    // We're done.
    return;
  }
}

// This is a new declaration in this scope. However, check whether this
// declaration name is hidden by a similarly-named declaration in an outer
// scope.
std::list<ShadowMap>::iterator SM, SMEnd = ShadowMaps.end();
--SMEnd;
for (SM = ShadowMaps.begin(); SM != SMEnd; ++SM) {
  ShadowMapEntry::iterator I, IEnd;
  ShadowMap::iterator NamePos = SM->find(R.Declaration->getDeclName());
  if (NamePos != SM->end()) {
    I = NamePos->second.begin();
    IEnd = NamePos->second.end();
  }
  for (; I != IEnd; ++I) {
    // A tag declaration does not hide a non-tag declaration.
    if (I->first->hasTagIdentifierNamespace() &&
        (IDNS & (Decl::IDNS_Member | Decl::IDNS_Ordinary |
                 Decl::IDNS_LocalExtern | Decl::IDNS_ObjCProtocol)))
      continue;

    // Protocols are in distinct namespaces from everything else.
    if (((I->first->getIdentifierNamespace() & Decl::IDNS_ObjCProtocol) ||
         (IDNS & Decl::IDNS_ObjCProtocol)) &&
        I->first->getIdentifierNamespace() != IDNS)
      continue;

    // The newly-added result is hidden by an entry in the shadow map.
    if (CheckHiddenResult(R, CurContext, I->first))
      return;

    break;
  }
}

// Make sure that any given declaration only shows up in the result set once.
if (!AllDeclsFound.insert(CanonDecl).second)
  return;

// If the filter is for nested-name-specifiers, then this result starts a
// nested-name-specifier.
if (AsNestedNameSpecifier) {
  R.StartsNestedNameSpecifier = true;
  R.Priority = CCP_NestedNameSpecifier;
} else
  AdjustResultPriorityForDecl(R);

// If this result is supposed to have an informative qualifier, add one.
if (R.QualifierIsInformative && !R.Qualifier &&
    !R.StartsNestedNameSpecifier) {
  const DeclContext *Ctx = R.Declaration->getDeclContext();
  if (const NamespaceDecl *Namespace = dyn_cast<NamespaceDecl>(Ctx))
    R.Qualifier =
        NestedNameSpecifier::Create(SemaRef.Context, nullptr, Namespace);
  else if (const TagDecl *Tag = dyn_cast<TagDecl>(Ctx))
    R.Qualifier = NestedNameSpecifier::Create(
        SemaRef.Context, nullptr, false,
        SemaRef.Context.getTypeDeclType(Tag).getTypePtr());
  else
    R.QualifierIsInformative = false;
}

// Insert this result into the set of results and into the current shadow
// map.
SMap[R.Declaration->getDeclName()].Add(R.Declaration, Results.size());
Results.push_back(R);

if (!AsNestedNameSpecifier)
  MaybeAddConstructorResults(R);
1207}

1209static void setInBaseClass(ResultBuilder::Result &R) {
R.Priority += CCD_InBaseClass;
R.InBaseClass = true;
1212}

1214enum class OverloadCompare { BothViable, Dominates, Dominated };
1215// Will Candidate ever be called on the object, when overloaded with Incumbent?
1216// Returns Dominates if Candidate is always called, Dominated if Incumbent is
1217// always called, BothViable if either may be called depending on arguments.
1218// Precondition: must actually be overloads!
1219static OverloadCompare compareOverloads(const CXXMethodDecl &Candidate,
                                      const CXXMethodDecl &Incumbent,
                                      const Qualifiers &ObjectQuals,
                                      ExprValueKind ObjectKind) {
// Base/derived shadowing is handled elsewhere.
if (Candidate.getDeclContext() != Incumbent.getDeclContext())
  return OverloadCompare::BothViable;
if (Candidate.isVariadic() != Incumbent.isVariadic() ||
    Candidate.getNumParams() != Incumbent.getNumParams() ||
    Candidate.getMinRequiredArguments() !=
        Incumbent.getMinRequiredArguments())
  return OverloadCompare::BothViable;
for (unsigned I = 0, E = Candidate.getNumParams(); I != E; ++I)
  if (Candidate.parameters()[I]->getType().getCanonicalType() !=
      Incumbent.parameters()[I]->getType().getCanonicalType())
    return OverloadCompare::BothViable;
if (!Candidate.specific_attrs<EnableIfAttr>().empty() ||
    !Incumbent.specific_attrs<EnableIfAttr>().empty())
  return OverloadCompare::BothViable;
// At this point, we know calls can't pick one or the other based on
// arguments, so one of the two must win. (Or both fail, handled elsewhere).
RefQualifierKind CandidateRef = Candidate.getRefQualifier();
RefQualifierKind IncumbentRef = Incumbent.getRefQualifier();
if (CandidateRef != IncumbentRef) {
  // If the object kind is LValue/RValue, there's one acceptable ref-qualifier
  // and it can't be mixed with ref-unqualified overloads (in valid code).

  // For xvalue objects, we prefer the rvalue overload even if we have to
  // add qualifiers (which is rare, because const&& is rare).
  if (ObjectKind == clang::VK_XValue)
    return CandidateRef == RQ_RValue ? OverloadCompare::Dominates
                                     : OverloadCompare::Dominated;
}
// Now the ref qualifiers are the same (or we're in some invalid state).
// So make some decision based on the qualifiers.
Qualifiers CandidateQual = Candidate.getMethodQualifiers();
Qualifiers IncumbentQual = Incumbent.getMethodQualifiers();
bool CandidateSuperset = CandidateQual.compatiblyIncludes(IncumbentQual);
bool IncumbentSuperset = IncumbentQual.compatiblyIncludes(CandidateQual);
if (CandidateSuperset == IncumbentSuperset)
  return OverloadCompare::BothViable;
return IncumbentSuperset ? OverloadCompare::Dominates
                         : OverloadCompare::Dominated;
1262}

1264void ResultBuilder::AddResult(Result R, DeclContext *CurContext,
                            NamedDecl *Hiding, bool InBaseClass = false) {
if (R.Kind != Result::RK_Declaration) {
  // For non-declaration results, just add the result.
  Results.push_back(R);
  return;
}

// Look through using declarations.
if (const auto *Using = dyn_cast<UsingShadowDecl>(R.Declaration)) {
  CodeCompletionResult Result(Using->getTargetDecl(),
                              getBasePriority(Using->getTargetDecl()),
                              R.Qualifier, false,
                              (R.Availability == CXAvailability_Available ||
                               R.Availability == CXAvailability_Deprecated),
                              std::move(R.FixIts));
  Result.ShadowDecl = Using;
  AddResult(Result, CurContext, Hiding);
  return;
}

bool AsNestedNameSpecifier = false;
if (!isInterestingDecl(R.Declaration, AsNestedNameSpecifier))
  return;

// C++ constructors are never found by name lookup.
if (isConstructor(R.Declaration))
  return;

if (Hiding && CheckHiddenResult(R, CurContext, Hiding))
  return;

// Make sure that any given declaration only shows up in the result set once.
if (!AllDeclsFound.insert(R.Declaration->getCanonicalDecl()).second)
  return;

// If the filter is for nested-name-specifiers, then this result starts a
// nested-name-specifier.
if (AsNestedNameSpecifier) {
  R.StartsNestedNameSpecifier = true;
  R.Priority = CCP_NestedNameSpecifier;
} else if (Filter == &ResultBuilder::IsMember && !R.Qualifier &&
           InBaseClass &&
           isa<CXXRecordDecl>(
               R.Declaration->getDeclContext()->getRedeclContext()))
  R.QualifierIsInformative = true;

// If this result is supposed to have an informative qualifier, add one.
if (R.QualifierIsInformative && !R.Qualifier &&
    !R.StartsNestedNameSpecifier) {
  const DeclContext *Ctx = R.Declaration->getDeclContext();
  if (const auto *Namespace = dyn_cast<NamespaceDecl>(Ctx))
    R.Qualifier =
        NestedNameSpecifier::Create(SemaRef.Context, nullptr, Namespace);
  else if (const auto *Tag = dyn_cast<TagDecl>(Ctx))
    R.Qualifier = NestedNameSpecifier::Create(
        SemaRef.Context, nullptr, false,
        SemaRef.Context.getTypeDeclType(Tag).getTypePtr());
  else
    R.QualifierIsInformative = false;
}

// Adjust the priority if this result comes from a base class.
if (InBaseClass)
  setInBaseClass(R);

AdjustResultPriorityForDecl(R);

if (HasObjectTypeQualifiers)
  if (const auto *Method = dyn_cast<CXXMethodDecl>(R.Declaration))
    if (Method->isInstance()) {
      Qualifiers MethodQuals = Method->getMethodQualifiers();
      if (ObjectTypeQualifiers == MethodQuals)
        R.Priority += CCD_ObjectQualifierMatch;
      else if (ObjectTypeQualifiers - MethodQuals) {
        // The method cannot be invoked, because doing so would drop
        // qualifiers.
        return;
      }
      // Detect cases where a ref-qualified method cannot be invoked.
      switch (Method->getRefQualifier()) {
        case RQ_LValue:
          if (ObjectKind != VK_LValue && !MethodQuals.hasConst())
            return;
          break;
        case RQ_RValue:
          if (ObjectKind == VK_LValue)
            return;
          break;
        case RQ_None:
          break;
      }

      /// Check whether this dominates another overloaded method, which should
      /// be suppressed (or vice versa).
      /// Motivating case is const_iterator begin() const vs iterator begin().
      auto &OverloadSet = OverloadMap[std::make_pair(
          CurContext, Method->getDeclName().getAsOpaqueInteger())];
      for (const DeclIndexPair Entry : OverloadSet) {
        Result &Incumbent = Results[Entry.second];
        switch (compareOverloads(*Method,
                                 *cast<CXXMethodDecl>(Incumbent.Declaration),
                                 ObjectTypeQualifiers, ObjectKind)) {
        case OverloadCompare::Dominates:
          // Replace the dominated overload with this one.
          // FIXME: if the overload dominates multiple incumbents then we
          // should remove all. But two overloads is by far the common case.
          Incumbent = std::move(R);
          return;
        case OverloadCompare::Dominated:
          // This overload can't be called, drop it.
          return;
        case OverloadCompare::BothViable:
          break;
        }
      }
      OverloadSet.Add(Method, Results.size());
    }

// When completing a non-static member function (and not via
// dot/arrow member access) and we're not inside that class' scope,
// it can't be a call.
if (CompletionContext.getKind() == clang::CodeCompletionContext::CCC_Symbol) {
  const auto *Method = dyn_cast<CXXMethodDecl>(R.getDeclaration());
  if (Method && !Method->isStatic()) {
    // Find the class scope that we're currently in.
    // We could e.g. be inside a lambda, so walk up the DeclContext until we
    // find a CXXMethodDecl.
    const auto *CurrentClassScope = [&]() -> const CXXRecordDecl * {
      for (DeclContext *Ctx = SemaRef.CurContext; Ctx;
           Ctx = Ctx->getParent()) {
        const auto *CtxMethod = llvm::dyn_cast<CXXMethodDecl>(Ctx);
        if (CtxMethod && !CtxMethod->getParent()->isLambda()) {
          return CtxMethod->getParent();
        }
      }
      return nullptr;
    }();

    R.FunctionCanBeCall =
        CurrentClassScope &&
        (CurrentClassScope == Method->getParent() ||
         CurrentClassScope->isDerivedFrom(Method->getParent()));
  }
}

// Insert this result into the set of results.
Results.push_back(R);

if (!AsNestedNameSpecifier)
  MaybeAddConstructorResults(R);
1415}

1417void ResultBuilder::AddResult(Result R) {
assert(R.Kind != Result::RK_Declaration &&(static_cast <bool> (R.Kind != Result::RK_Declaration &&
 "Declaration results need more context") ? void (0) : __assert_fail
 ("R.Kind != Result::RK_Declaration && \"Declaration results need more context\""
, "clang/lib/Sema/SemaCodeComplete.cpp", 1419, __extension__ __PRETTY_FUNCTION__
))
       "Declaration results need more context")(static_cast <bool> (R.Kind != Result::RK_Declaration &&
 "Declaration results need more context") ? void (0) : __assert_fail
 ("R.Kind != Result::RK_Declaration && \"Declaration results need more context\""
, "clang/lib/Sema/SemaCodeComplete.cpp", 1419, __extension__ __PRETTY_FUNCTION__
));
Results.push_back(R);
1421}

1423/// Enter into a new scope.
1424void ResultBuilder::EnterNewScope() { ShadowMaps.emplace_back(); }

1426/// Exit from the current scope.
1427void ResultBuilder::ExitScope() {
ShadowMaps.pop_back();
1429}

1431/// Determines whether this given declaration will be found by
1432/// ordinary name lookup.
1433bool ResultBuilder::IsOrdinaryName(const NamedDecl *ND) const {
ND = ND->getUnderlyingDecl();

// If name lookup finds a local extern declaration, then we are in a
// context where it behaves like an ordinary name.
unsigned IDNS = Decl::IDNS_Ordinary | Decl::IDNS_LocalExtern;
if (SemaRef.getLangOpts().CPlusPlus)
  IDNS |= Decl::IDNS_Tag | Decl::IDNS_Namespace | Decl::IDNS_Member;
else if (SemaRef.getLangOpts().ObjC) {
  if (isa<ObjCIvarDecl>(ND))
    return true;
}

return ND->getIdentifierNamespace() & IDNS;
1447}

1449/// Determines whether this given declaration will be found by
1450/// ordinary name lookup but is not a type name.
1451bool ResultBuilder::IsOrdinaryNonTypeName(const NamedDecl *ND) const {
ND = ND->getUnderlyingDecl();
if (isa<TypeDecl>(ND))
  return false;
// Objective-C interfaces names are not filtered by this method because they
// can be used in a class property expression. We can still filter out
// @class declarations though.
if (const auto *ID = dyn_cast<ObjCInterfaceDecl>(ND)) {
  if (!ID->getDefinition())
    return false;
}

unsigned IDNS = Decl::IDNS_Ordinary | Decl::IDNS_LocalExtern;
if (SemaRef.getLangOpts().CPlusPlus)
  IDNS |= Decl::IDNS_Tag | Decl::IDNS_Namespace | Decl::IDNS_Member;
else if (SemaRef.getLangOpts().ObjC) {
  if (isa<ObjCIvarDecl>(ND))
    return true;
}

return ND->getIdentifierNamespace() & IDNS;
1472}

1474bool ResultBuilder::IsIntegralConstantValue(const NamedDecl *ND) const {
if (!IsOrdinaryNonTypeName(ND))
  return false;

if (const auto *VD = dyn_cast<ValueDecl>(ND->getUnderlyingDecl()))
  if (VD->getType()->isIntegralOrEnumerationType())
    return true;

return false;
1483}

1485/// Determines whether this given declaration will be found by
1486/// ordinary name lookup.
1487bool ResultBuilder::IsOrdinaryNonValueName(const NamedDecl *ND) const {
ND = ND->getUnderlyingDecl();

unsigned IDNS = Decl::IDNS_Ordinary | Decl::IDNS_LocalExtern;
if (SemaRef.getLangOpts().CPlusPlus)
  IDNS |= Decl::IDNS_Tag | Decl::IDNS_Namespace;

return (ND->getIdentifierNamespace() & IDNS) && !isa<ValueDecl>(ND) &&
       !isa<FunctionTemplateDecl>(ND) && !isa<ObjCPropertyDecl>(ND);
1496}

1498/// Determines whether the given declaration is suitable as the
1499/// start of a C++ nested-name-specifier, e.g., a class or namespace.
1500bool ResultBuilder::IsNestedNameSpecifier(const NamedDecl *ND) const {
// Allow us to find class templates, too.
if (const auto *ClassTemplate = dyn_cast<ClassTemplateDecl>(ND))
  ND = ClassTemplate->getTemplatedDecl();

return SemaRef.isAcceptableNestedNameSpecifier(ND);
1506}

1508/// Determines whether the given declaration is an enumeration.
1509bool ResultBuilder::IsEnum(const NamedDecl *ND) const {
return isa<EnumDecl>(ND);
1511}

1513/// Determines whether the given declaration is a class or struct.
1514bool ResultBuilder::IsClassOrStruct(const NamedDecl *ND) const {
// Allow us to find class templates, too.
if (const auto *ClassTemplate = dyn_cast<ClassTemplateDecl>(ND))
  ND = ClassTemplate->getTemplatedDecl();

// For purposes of this check, interfaces match too.
if (const auto *RD = dyn_cast<RecordDecl>(ND))
  return RD->getTagKind() == TTK_Class || RD->getTagKind() == TTK_Struct ||
         RD->getTagKind() == TTK_Interface;

return false;
1525}

1527/// Determines whether the given declaration is a union.
1528bool ResultBuilder::IsUnion(const NamedDecl *ND) const {
// Allow us to find class templates, too.
if (const auto *ClassTemplate = dyn_cast<ClassTemplateDecl>(ND))
  ND = ClassTemplate->getTemplatedDecl();

if (const auto *RD = dyn_cast<RecordDecl>(ND))
  return RD->getTagKind() == TTK_Union;

return false;
1537}

1539/// Determines whether the given declaration is a namespace.
1540bool ResultBuilder::IsNamespace(const NamedDecl *ND) const {
return isa<NamespaceDecl>(ND);
1542}

1544/// Determines whether the given declaration is a namespace or
1545/// namespace alias.
1546bool ResultBuilder::IsNamespaceOrAlias(const NamedDecl *ND) const {
return isa<NamespaceDecl>(ND->getUnderlyingDecl());
1548}

1550/// Determines whether the given declaration is a type.
1551bool ResultBuilder::IsType(const NamedDecl *ND) const {
ND = ND->getUnderlyingDecl();
return isa<TypeDecl>(ND) || isa<ObjCInterfaceDecl>(ND);
1554}

1556/// Determines which members of a class should be visible via
1557/// "." or "->".  Only value declarations, nested name specifiers, and
1558/// using declarations thereof should show up.
1559bool ResultBuilder::IsMember(const NamedDecl *ND) const {
ND = ND->getUnderlyingDecl();
return isa<ValueDecl>(ND) || isa<FunctionTemplateDecl>(ND) ||
       isa<ObjCPropertyDecl>(ND);
1563}

1565static bool isObjCReceiverType(ASTContext &C, QualType T) {
T = C.getCanonicalType(T);
switch (T->getTypeClass()) {
case Type::ObjCObject:
case Type::ObjCInterface:
case Type::ObjCObjectPointer:
  return true;

case Type::Builtin:
  switch (cast<BuiltinType>(T)->getKind()) {
  case BuiltinType::ObjCId:
  case BuiltinType::ObjCClass:
  case BuiltinType::ObjCSel:
    return true;

  default:
    break;
  }
  return false;

default:
  break;
}

if (!C.getLangOpts().CPlusPlus)
  return false;

// FIXME: We could perform more analysis here to determine whether a
// particular class type has any conversions to Objective-C types. For now,
// just accept all class types.
return T->isDependentType() || T->isRecordType();
1596}

1598bool ResultBuilder::IsObjCMessageReceiver(const NamedDecl *ND) const {
QualType T = getDeclUsageType(SemaRef.Context, ND);
if (T.isNull())
  return false;

T = SemaRef.Context.getBaseElementType(T);
return isObjCReceiverType(SemaRef.Context, T);
1605}

1607bool ResultBuilder::IsObjCMessageReceiverOrLambdaCapture(
  const NamedDecl *ND) const {
if (IsObjCMessageReceiver(ND))
  return true;

const auto *Var = dyn_cast<VarDecl>(ND);
if (!Var)
  return false;

return Var->hasLocalStorage() && !Var->hasAttr<BlocksAttr>();
1617}

1619bool ResultBuilder::IsObjCCollection(const NamedDecl *ND) const {
if ((SemaRef.getLangOpts().CPlusPlus && !IsOrdinaryName(ND)) ||
    (!SemaRef.getLangOpts().CPlusPlus && !IsOrdinaryNonTypeName(ND)))
  return false;

QualType T = getDeclUsageType(SemaRef.Context, ND);
if (T.isNull())
  return false;

T = SemaRef.Context.getBaseElementType(T);
return T->isObjCObjectType() || T->isObjCObjectPointerType() ||
       T->isObjCIdType() ||
       (SemaRef.getLangOpts().CPlusPlus && T->isRecordType());
1632}

1634bool ResultBuilder::IsImpossibleToSatisfy(const NamedDecl *ND) const {
return false;
1636}

1638/// Determines whether the given declaration is an Objective-C
1639/// instance variable.
1640bool ResultBuilder::IsObjCIvar(const NamedDecl *ND) const {
return isa<ObjCIvarDecl>(ND);
1642}

1644namespace {

1646/// Visible declaration consumer that adds a code-completion result
1647/// for each visible declaration.
1648class CodeCompletionDeclConsumer : public VisibleDeclConsumer {
ResultBuilder &Results;
DeclContext *InitialLookupCtx;
// NamingClass and BaseType are used for access-checking. See
// Sema::IsSimplyAccessible for details.
CXXRecordDecl *NamingClass;
QualType BaseType;
std::vector<FixItHint> FixIts;

1657public:
CodeCompletionDeclConsumer(
    ResultBuilder &Results, DeclContext *InitialLookupCtx,
    QualType BaseType = QualType(),
    std::vector<FixItHint> FixIts = std::vector<FixItHint>())
    : Results(Results), InitialLookupCtx(InitialLookupCtx),
      FixIts(std::move(FixIts)) {
  NamingClass = llvm::dyn_cast<CXXRecordDecl>(InitialLookupCtx);
  // If BaseType was not provided explicitly, emulate implicit 'this->'.
  if (BaseType.isNull()) {
    auto ThisType = Results.getSema().getCurrentThisType();
    if (!ThisType.isNull()) {
      assert(ThisType->isPointerType())(static_cast <bool> (ThisType->isPointerType()) ? void
 (0) : __assert_fail ("ThisType->isPointerType()", "clang/lib/Sema/SemaCodeComplete.cpp"
, 1669, __extension__ __PRETTY_FUNCTION__));
      BaseType = ThisType->getPointeeType();
      if (!NamingClass)
        NamingClass = BaseType->getAsCXXRecordDecl();
    }
  }
  this->BaseType = BaseType;
}

void FoundDecl(NamedDecl *ND, NamedDecl *Hiding, DeclContext *Ctx,
               bool InBaseClass) override {
  ResultBuilder::Result Result(ND, Results.getBasePriority(ND), nullptr,
                               false, IsAccessible(ND, Ctx), FixIts);
  Results.AddResult(Result, InitialLookupCtx, Hiding, InBaseClass);
}

void EnteredContext(DeclContext *Ctx) override {
  Results.addVisitedContext(Ctx);
}

1689private:
bool IsAccessible(NamedDecl *ND, DeclContext *Ctx) {
  // Naming class to use for access check. In most cases it was provided
  // explicitly (e.g. member access (lhs.foo) or qualified lookup (X::)),
  // for unqualified lookup we fallback to the \p Ctx in which we found the
  // member.
  auto *NamingClass = this->NamingClass;
  QualType BaseType = this->BaseType;
  if (auto *Cls = llvm::dyn_cast_or_null<CXXRecordDecl>(Ctx)) {
    if (!NamingClass)
      NamingClass = Cls;
    // When we emulate implicit 'this->' in an unqualified lookup, we might
    // end up with an invalid naming class. In that case, we avoid emulating
    // 'this->' qualifier to satisfy preconditions of the access checking.
    if (NamingClass->getCanonicalDecl() != Cls->getCanonicalDecl() &&
        !NamingClass->isDerivedFrom(Cls)) {
      NamingClass = Cls;
      BaseType = QualType();
    }
  } else {
    // The decl was found outside the C++ class, so only ObjC access checks
    // apply. Those do not rely on NamingClass and BaseType, so we clear them
    // out.
    NamingClass = nullptr;
    BaseType = QualType();
  }
  return Results.getSema().IsSimplyAccessible(ND, NamingClass, BaseType);
}
1717};
1718} // namespace

1720/// Add type specifiers for the current language as keyword results.
1721static void AddTypeSpecifierResults(const LangOptions &LangOpts,
                                  ResultBuilder &Results) {
typedef CodeCompletionResult Result;
Results.AddResult(Result("short", CCP_Type));
Results.AddResult(Result("long", CCP_Type));
Results.AddResult(Result("signed", CCP_Type));
Results.AddResult(Result("unsigned", CCP_Type));
Results.AddResult(Result("void", CCP_Type));
Results.AddResult(Result("char", CCP_Type));
Results.AddResult(Result("int", CCP_Type));
Results.AddResult(Result("float", CCP_Type));
Results.AddResult(Result("double", CCP_Type));
Results.AddResult(Result("enum", CCP_Type));
Results.AddResult(Result("struct", CCP_Type));
Results.AddResult(Result("union", CCP_Type));
Results.AddResult(Result("const", CCP_Type));
Results.AddResult(Result("volatile", CCP_Type));

if (LangOpts.C99) {
  // C99-specific
  Results.AddResult(Result("_Complex", CCP_Type));
  Results.AddResult(Result("_Imaginary", CCP_Type));
  Results.AddResult(Result("_Bool", CCP_Type));
  Results.AddResult(Result("restrict", CCP_Type));
}

CodeCompletionBuilder Builder(Results.getAllocator(),
                              Results.getCodeCompletionTUInfo());
if (LangOpts.CPlusPlus) {
  // C++-specific
  Results.AddResult(
      Result("bool", CCP_Type + (LangOpts.ObjC ? CCD_bool_in_ObjC : 0)));
  Results.AddResult(Result("class", CCP_Type));
  Results.AddResult(Result("wchar_t", CCP_Type));

  // typename name
  Builder.AddTypedTextChunk("typename");
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("name");
  Results.AddResult(Result(Builder.TakeString()));

  if (LangOpts.CPlusPlus11) {
    Results.AddResult(Result("auto", CCP_Type));
    Results.AddResult(Result("char16_t", CCP_Type));
    Results.AddResult(Result("char32_t", CCP_Type));

    Builder.AddTypedTextChunk("decltype");
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("expression");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Results.AddResult(Result(Builder.TakeString()));
  }
} else
  Results.AddResult(Result("__auto_type", CCP_Type));

// GNU keywords
if (LangOpts.GNUKeywords) {
  // FIXME: Enable when we actually support decimal floating point.
  //    Results.AddResult(Result("_Decimal32"));
  //    Results.AddResult(Result("_Decimal64"));
  //    Results.AddResult(Result("_Decimal128"));

  Builder.AddTypedTextChunk("typeof");
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("expression");
  Results.AddResult(Result(Builder.TakeString()));

  Builder.AddTypedTextChunk("typeof");
  Builder.AddChunk(CodeCompletionString::CK_LeftParen);
  Builder.AddPlaceholderChunk("type");
  Builder.AddChunk(CodeCompletionString::CK_RightParen);
  Results.AddResult(Result(Builder.TakeString()));
}

// Nullability
Results.AddResult(Result("_Nonnull", CCP_Type));
Results.AddResult(Result("_Null_unspecified", CCP_Type));
Results.AddResult(Result("_Nullable", CCP_Type));
1799}

1801static void AddStorageSpecifiers(Sema::ParserCompletionContext CCC,
                               const LangOptions &LangOpts,
                               ResultBuilder &Results) {
typedef CodeCompletionResult Result;
// Note: we don't suggest either "auto" or "register", because both
// are pointless as storage specifiers. Elsewhere, we suggest "auto"
// in C++0x as a type specifier.
Results.AddResult(Result("extern"));
Results.AddResult(Result("static"));

if (LangOpts.CPlusPlus11) {
  CodeCompletionAllocator &Allocator = Results.getAllocator();
  CodeCompletionBuilder Builder(Allocator, Results.getCodeCompletionTUInfo());

  // alignas
  Builder.AddTypedTextChunk("alignas");
  Builder.AddChunk(CodeCompletionString::CK_LeftParen);
  Builder.AddPlaceholderChunk("expression");
  Builder.AddChunk(CodeCompletionString::CK_RightParen);
  Results.AddResult(Result(Builder.TakeString()));

  Results.AddResult(Result("constexpr"));
  Results.AddResult(Result("thread_local"));
}
1825}

1827static void AddFunctionSpecifiers(Sema::ParserCompletionContext CCC,
                                const LangOptions &LangOpts,
                                ResultBuilder &Results) {
typedef CodeCompletionResult Result;
switch (CCC) {
case Sema::PCC_Class:
case Sema::PCC_MemberTemplate:
  if (LangOpts.CPlusPlus) {
    Results.AddResult(Result("explicit"));
    Results.AddResult(Result("friend"));
    Results.AddResult(Result("mutable"));
    Results.AddResult(Result("virtual"));
  }
  [[fallthrough]];

case Sema::PCC_ObjCInterface:
case Sema::PCC_ObjCImplementation:
case Sema::PCC_Namespace:
case Sema::PCC_Template:
  if (LangOpts.CPlusPlus || LangOpts.C99)
    Results.AddResult(Result("inline"));
  break;

case Sema::PCC_ObjCInstanceVariableList:
case Sema::PCC_Expression:
case Sema::PCC_Statement:
case Sema::PCC_ForInit:
case Sema::PCC_Condition:
case Sema::PCC_RecoveryInFunction:
case Sema::PCC_Type:
case Sema::PCC_ParenthesizedExpression:
case Sema::PCC_LocalDeclarationSpecifiers:
  break;
}
1861}

1863static void AddObjCExpressionResults(ResultBuilder &Results, bool NeedAt);
1864static void AddObjCStatementResults(ResultBuilder &Results, bool NeedAt);
1865static void AddObjCVisibilityResults(const LangOptions &LangOpts,
                                   ResultBuilder &Results, bool NeedAt);
1867static void AddObjCImplementationResults(const LangOptions &LangOpts,
                                       ResultBuilder &Results, bool NeedAt);
1869static void AddObjCInterfaceResults(const LangOptions &LangOpts,
                                  ResultBuilder &Results, bool NeedAt);
1871static void AddObjCTopLevelResults(ResultBuilder &Results, bool NeedAt);

1873static void AddTypedefResult(ResultBuilder &Results) {
CodeCompletionBuilder Builder(Results.getAllocator(),
                              Results.getCodeCompletionTUInfo());
Builder.AddTypedTextChunk("typedef");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("type");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("name");
Builder.AddChunk(CodeCompletionString::CK_SemiColon);
Results.AddResult(CodeCompletionResult(Builder.TakeString()));
1883}

1885// using name = type
1886static void AddUsingAliasResult(CodeCompletionBuilder &Builder,
                              ResultBuilder &Results) {
Builder.AddTypedTextChunk("using");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("name");
Builder.AddChunk(CodeCompletionString::CK_Equal);
Builder.AddPlaceholderChunk("type");
Builder.AddChunk(CodeCompletionString::CK_SemiColon);
Results.AddResult(CodeCompletionResult(Builder.TakeString()));
1895}

1897static bool WantTypesInContext(Sema::ParserCompletionContext CCC,
                             const LangOptions &LangOpts) {
switch (CCC) {
case Sema::PCC_Namespace:
case Sema::PCC_Class:
case Sema::PCC_ObjCInstanceVariableList:
case Sema::PCC_Template:
case Sema::PCC_MemberTemplate:
case Sema::PCC_Statement:
case Sema::PCC_RecoveryInFunction:
case Sema::PCC_Type:
case Sema::PCC_ParenthesizedExpression:
case Sema::PCC_LocalDeclarationSpecifiers:
  return true;

case Sema::PCC_Expression:
case Sema::PCC_Condition:
  return LangOpts.CPlusPlus;

case Sema::PCC_ObjCInterface:
case Sema::PCC_ObjCImplementation:
  return false;

case Sema::PCC_ForInit:
  return LangOpts.CPlusPlus || LangOpts.ObjC || LangOpts.C99;
}

llvm_unreachable("Invalid ParserCompletionContext!")::llvm::llvm_unreachable_internal("Invalid ParserCompletionContext!"
, "clang/lib/Sema/SemaCodeComplete.cpp", 1924);
1925}

1927static PrintingPolicy getCompletionPrintingPolicy(const ASTContext &Context,
                                                const Preprocessor &PP) {
PrintingPolicy Policy = Sema::getPrintingPolicy(Context, PP);
Policy.AnonymousTagLocations = false;
Policy.SuppressStrongLifetime = true;
Policy.SuppressUnwrittenScope = true;
Policy.SuppressScope = true;
Policy.CleanUglifiedParameters = true;
return Policy;
1936}

1938/// Retrieve a printing policy suitable for code completion.
1939static PrintingPolicy getCompletionPrintingPolicy(Sema &S) {
return getCompletionPrintingPolicy(S.Context, S.PP);
1941}

1943/// Retrieve the string representation of the given type as a string
1944/// that has the appropriate lifetime for code completion.
1945///
1946/// This routine provides a fast path where we provide constant strings for
1947/// common type names.
1948static const char *GetCompletionTypeString(QualType T, ASTContext &Context,
                                         const PrintingPolicy &Policy,
                                         CodeCompletionAllocator &Allocator) {
if (!T.getLocalQualifiers()) {
  // Built-in type names are constant strings.
  if (const BuiltinType *BT = dyn_cast<BuiltinType>(T))
    return BT->getNameAsCString(Policy);

  // Anonymous tag types are constant strings.
  if (const TagType *TagT = dyn_cast<TagType>(T))
    if (TagDecl *Tag = TagT->getDecl())
      if (!Tag->hasNameForLinkage()) {
        switch (Tag->getTagKind()) {
        case TTK_Struct:
          return "struct <anonymous>";
        case TTK_Interface:
          return "__interface <anonymous>";
        case TTK_Class:
          return "class <anonymous>";
        case TTK_Union:
          return "union <anonymous>";
        case TTK_Enum:
          return "enum <anonymous>";
        }
      }
}

// Slow path: format the type as a string.
std::string Result;
T.getAsStringInternal(Result, Policy);
return Allocator.CopyString(Result);
1979}

1981/// Add a completion for "this", if we're in a member function.
1982static void addThisCompletion(Sema &S, ResultBuilder &Results) {
QualType ThisTy = S.getCurrentThisType();
if (ThisTy.isNull())
  return;

CodeCompletionAllocator &Allocator = Results.getAllocator();
CodeCompletionBuilder Builder(Allocator, Results.getCodeCompletionTUInfo());
PrintingPolicy Policy = getCompletionPrintingPolicy(S);
Builder.AddResultTypeChunk(
    GetCompletionTypeString(ThisTy, S.Context, Policy, Allocator));
Builder.AddTypedTextChunk("this");
Results.AddResult(CodeCompletionResult(Builder.TakeString()));
1994}

1996static void AddStaticAssertResult(CodeCompletionBuilder &Builder,
                                ResultBuilder &Results,
                                const LangOptions &LangOpts) {
if (!LangOpts.CPlusPlus11)
  return;

Builder.AddTypedTextChunk("static_assert");
Builder.AddChunk(CodeCompletionString::CK_LeftParen);
Builder.AddPlaceholderChunk("expression");
Builder.AddChunk(CodeCompletionString::CK_Comma);
Builder.AddPlaceholderChunk("message");
Builder.AddChunk(CodeCompletionString::CK_RightParen);
Builder.AddChunk(CodeCompletionString::CK_SemiColon);
Results.AddResult(CodeCompletionResult(Builder.TakeString()));
2010}

2012static void AddOverrideResults(ResultBuilder &Results,
                             const CodeCompletionContext &CCContext,
                             CodeCompletionBuilder &Builder) {
Sema &S = Results.getSema();
const auto *CR = llvm::dyn_cast<CXXRecordDecl>(S.CurContext);
// If not inside a class/struct/union return empty.
if (!CR)
  return;
// First store overrides within current class.
// These are stored by name to make querying fast in the later step.
llvm::StringMap<std::vector<FunctionDecl *>> Overrides;
for (auto *Method : CR->methods()) {
  if (!Method->isVirtual() || !Method->getIdentifier())
    continue;
  Overrides[Method->getName()].push_back(Method);
}

for (const auto &Base : CR->bases()) {
  const auto *BR = Base.getType().getTypePtr()->getAsCXXRecordDecl();
  if (!BR)
    continue;
  for (auto *Method : BR->methods()) {
    if (!Method->isVirtual() || !Method->getIdentifier())
      continue;
    const auto it = Overrides.find(Method->getName());
    bool IsOverriden = false;
    if (it != Overrides.end()) {
      for (auto *MD : it->second) {
        // If the method in current body is not an overload of this virtual
        // function, then it overrides this one.
        if (!S.IsOverload(MD, Method, false)) {
          IsOverriden = true;
          break;
        }
      }
    }
    if (!IsOverriden) {
      // Generates a new CodeCompletionResult by taking this function and
      // converting it into an override declaration with only one chunk in the
      // final CodeCompletionString as a TypedTextChunk.
      std::string OverrideSignature;
      llvm::raw_string_ostream OS(OverrideSignature);
      CodeCompletionResult CCR(Method, 0);
      PrintingPolicy Policy =
          getCompletionPrintingPolicy(S.getASTContext(), S.getPreprocessor());
      auto *CCS = CCR.createCodeCompletionStringForOverride(
          S.getPreprocessor(), S.getASTContext(), Builder,
          /*IncludeBriefComments=*/false, CCContext, Policy);
      Results.AddResult(CodeCompletionResult(CCS, Method, CCP_CodePattern));
    }
  }
}
2064}

2066/// Add language constructs that show up for "ordinary" names.
2067static void AddOrdinaryNameResults(Sema::ParserCompletionContext CCC, Scope *S,
                                 Sema &SemaRef, ResultBuilder &Results) {
CodeCompletionAllocator &Allocator = Results.getAllocator();
CodeCompletionBuilder Builder(Allocator, Results.getCodeCompletionTUInfo());

typedef CodeCompletionResult Result;
switch (CCC) {
case Sema::PCC_Namespace:
  if (SemaRef.getLangOpts().CPlusPlus) {
    if (Results.includeCodePatterns()) {
      // namespace <identifier> { declarations }
      Builder.AddTypedTextChunk("namespace");
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      Builder.AddPlaceholderChunk("identifier");
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
      Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
      Builder.AddPlaceholderChunk("declarations");
      Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
      Builder.AddChunk(CodeCompletionString::CK_RightBrace);
      Results.AddResult(Result(Builder.TakeString()));
    }

    // namespace identifier = identifier ;
    Builder.AddTypedTextChunk("namespace");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("name");
    Builder.AddChunk(CodeCompletionString::CK_Equal);
    Builder.AddPlaceholderChunk("namespace");
    Builder.AddChunk(CodeCompletionString::CK_SemiColon);
    Results.AddResult(Result(Builder.TakeString()));

    // Using directives
    Builder.AddTypedTextChunk("using namespace");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("identifier");
    Builder.AddChunk(CodeCompletionString::CK_SemiColon);
    Results.AddResult(Result(Builder.TakeString()));

    // asm(string-literal)
    Builder.AddTypedTextChunk("asm");
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("string-literal");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Results.AddResult(Result(Builder.TakeString()));

    if (Results.includeCodePatterns()) {
      // Explicit template instantiation
      Builder.AddTypedTextChunk("template");
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      Builder.AddPlaceholderChunk("declaration");
      Results.AddResult(Result(Builder.TakeString()));
    } else {
      Results.AddResult(Result("template", CodeCompletionResult::RK_Keyword));
    }
  }

  if (SemaRef.getLangOpts().ObjC)
    AddObjCTopLevelResults(Results, true);

  AddTypedefResult(Results);
  [[fallthrough]];

case Sema::PCC_Class:
  if (SemaRef.getLangOpts().CPlusPlus) {
    // Using declaration
    Builder.AddTypedTextChunk("using");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("qualifier");
    Builder.AddTextChunk("::");
    Builder.AddPlaceholderChunk("name");
    Builder.AddChunk(CodeCompletionString::CK_SemiColon);
    Results.AddResult(Result(Builder.TakeString()));

    if (SemaRef.getLangOpts().CPlusPlus11)
      AddUsingAliasResult(Builder, Results);

    // using typename qualifier::name (only in a dependent context)
    if (SemaRef.CurContext->isDependentContext()) {
      Builder.AddTypedTextChunk("using typename");
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      Builder.AddPlaceholderChunk("qualifier");
      Builder.AddTextChunk("::");
      Builder.AddPlaceholderChunk("name");
      Builder.AddChunk(CodeCompletionString::CK_SemiColon);
      Results.AddResult(Result(Builder.TakeString()));
    }

    AddStaticAssertResult(Builder, Results, SemaRef.getLangOpts());

    if (CCC == Sema::PCC_Class) {
      AddTypedefResult(Results);

      bool IsNotInheritanceScope = !S->isClassInheritanceScope();
      // public:
      Builder.AddTypedTextChunk("public");
      if (IsNotInheritanceScope && Results.includeCodePatterns())
        Builder.AddChunk(CodeCompletionString::CK_Colon);
      Results.AddResult(Result(Builder.TakeString()));

      // protected:
      Builder.AddTypedTextChunk("protected");
      if (IsNotInheritanceScope && Results.includeCodePatterns())
        Builder.AddChunk(CodeCompletionString::CK_Colon);
      Results.AddResult(Result(Builder.TakeString()));

      // private:
      Builder.AddTypedTextChunk("private");
      if (IsNotInheritanceScope && Results.includeCodePatterns())
        Builder.AddChunk(CodeCompletionString::CK_Colon);
      Results.AddResult(Result(Builder.TakeString()));

      // FIXME: This adds override results only if we are at the first word of
      // the declaration/definition. Also call this from other sides to have
      // more use-cases.
      AddOverrideResults(Results, CodeCompletionContext::CCC_ClassStructUnion,
                         Builder);
    }
  }
  [[fallthrough]];

case Sema::PCC_Template:
case Sema::PCC_MemberTemplate:
  if (SemaRef.getLangOpts().CPlusPlus && Results.includeCodePatterns()) {
    // template < parameters >
    Builder.AddTypedTextChunk("template");
    Builder.AddChunk(CodeCompletionString::CK_LeftAngle);
    Builder.AddPlaceholderChunk("parameters");
    Builder.AddChunk(CodeCompletionString::CK_RightAngle);
    Results.AddResult(Result(Builder.TakeString()));
  } else {
    Results.AddResult(Result("template", CodeCompletionResult::RK_Keyword));
  }

  AddStorageSpecifiers(CCC, SemaRef.getLangOpts(), Results);
  AddFunctionSpecifiers(CCC, SemaRef.getLangOpts(), Results);
  break;

case Sema::PCC_ObjCInterface:
  AddObjCInterfaceResults(SemaRef.getLangOpts(), Results, true);
  AddStorageSpecifiers(CCC, SemaRef.getLangOpts(), Results);
  AddFunctionSpecifiers(CCC, SemaRef.getLangOpts(), Results);
  break;

case Sema::PCC_ObjCImplementation:
  AddObjCImplementationResults(SemaRef.getLangOpts(), Results, true);
  AddStorageSpecifiers(CCC, SemaRef.getLangOpts(), Results);
  AddFunctionSpecifiers(CCC, SemaRef.getLangOpts(), Results);
  break;

case Sema::PCC_ObjCInstanceVariableList:
  AddObjCVisibilityResults(SemaRef.getLangOpts(), Results, true);
  break;

case Sema::PCC_RecoveryInFunction:
case Sema::PCC_Statement: {
  if (SemaRef.getLangOpts().CPlusPlus11)
    AddUsingAliasResult(Builder, Results);

  AddTypedefResult(Results);

  if (SemaRef.getLangOpts().CPlusPlus && Results.includeCodePatterns() &&
      SemaRef.getLangOpts().CXXExceptions) {
    Builder.AddTypedTextChunk("try");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddPlaceholderChunk("statements");
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddChunk(CodeCompletionString::CK_RightBrace);
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddTextChunk("catch");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("declaration");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddPlaceholderChunk("statements");
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddChunk(CodeCompletionString::CK_RightBrace);
    Results.AddResult(Result(Builder.TakeString()));
  }
  if (SemaRef.getLangOpts().ObjC)
    AddObjCStatementResults(Results, true);

  if (Results.includeCodePatterns()) {
    // if (condition) { statements }
    Builder.AddTypedTextChunk("if");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    if (SemaRef.getLangOpts().CPlusPlus)
      Builder.AddPlaceholderChunk("condition");
    else
      Builder.AddPlaceholderChunk("expression");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddPlaceholderChunk("statements");
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddChunk(CodeCompletionString::CK_RightBrace);
    Results.AddResult(Result(Builder.TakeString()));

    // switch (condition) { }
    Builder.AddTypedTextChunk("switch");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    if (SemaRef.getLangOpts().CPlusPlus)
      Builder.AddPlaceholderChunk("condition");
    else
      Builder.AddPlaceholderChunk("expression");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddPlaceholderChunk("cases");
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddChunk(CodeCompletionString::CK_RightBrace);
    Results.AddResult(Result(Builder.TakeString()));
  }

  // Switch-specific statements.
  if (SemaRef.getCurFunction() &&
      !SemaRef.getCurFunction()->SwitchStack.empty()) {
    // case expression:
    Builder.AddTypedTextChunk("case");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("expression");
    Builder.AddChunk(CodeCompletionString::CK_Colon);
    Results.AddResult(Result(Builder.TakeString()));

    // default:
    Builder.AddTypedTextChunk("default");
    Builder.AddChunk(CodeCompletionString::CK_Colon);
    Results.AddResult(Result(Builder.TakeString()));
  }

  if (Results.includeCodePatterns()) {
    /// while (condition) { statements }
    Builder.AddTypedTextChunk("while");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    if (SemaRef.getLangOpts().CPlusPlus)
      Builder.AddPlaceholderChunk("condition");
    else
      Builder.AddPlaceholderChunk("expression");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddPlaceholderChunk("statements");
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddChunk(CodeCompletionString::CK_RightBrace);
    Results.AddResult(Result(Builder.TakeString()));

    // do { statements } while ( expression );
    Builder.AddTypedTextChunk("do");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddPlaceholderChunk("statements");
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddChunk(CodeCompletionString::CK_RightBrace);
    Builder.AddTextChunk("while");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("expression");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Results.AddResult(Result(Builder.TakeString()));

    // for ( for-init-statement ; condition ; expression ) { statements }
    Builder.AddTypedTextChunk("for");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    if (SemaRef.getLangOpts().CPlusPlus || SemaRef.getLangOpts().C99)
      Builder.AddPlaceholderChunk("init-statement");
    else
      Builder.AddPlaceholderChunk("init-expression");
    Builder.AddChunk(CodeCompletionString::CK_SemiColon);
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("condition");
    Builder.AddChunk(CodeCompletionString::CK_SemiColon);
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("inc-expression");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddPlaceholderChunk("statements");
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddChunk(CodeCompletionString::CK_RightBrace);
    Results.AddResult(Result(Builder.TakeString()));

    if (SemaRef.getLangOpts().CPlusPlus11 || SemaRef.getLangOpts().ObjC) {
      // for ( range_declaration (:|in) range_expression ) { statements }
      Builder.AddTypedTextChunk("for");
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddPlaceholderChunk("range-declaration");
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      if (SemaRef.getLangOpts().ObjC)
        Builder.AddTextChunk("in");
      else
        Builder.AddChunk(CodeCompletionString::CK_Colon);
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      Builder.AddPlaceholderChunk("range-expression");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
      Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
      Builder.AddPlaceholderChunk("statements");
      Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
      Builder.AddChunk(CodeCompletionString::CK_RightBrace);
      Results.AddResult(Result(Builder.TakeString()));
    }
  }

  if (S->getContinueParent()) {
    // continue ;
    Builder.AddTypedTextChunk("continue");
    Builder.AddChunk(CodeCompletionString::CK_SemiColon);
    Results.AddResult(Result(Builder.TakeString()));
  }

  if (S->getBreakParent()) {
    // break ;
    Builder.AddTypedTextChunk("break");
    Builder.AddChunk(CodeCompletionString::CK_SemiColon);
    Results.AddResult(Result(Builder.TakeString()));
  }

  // "return expression ;" or "return ;", depending on the return type.
  QualType ReturnType;
  if (const auto *Function = dyn_cast<FunctionDecl>(SemaRef.CurContext))
    ReturnType = Function->getReturnType();
  else if (const auto *Method = dyn_cast<ObjCMethodDecl>(SemaRef.CurContext))
    ReturnType = Method->getReturnType();
  else if (SemaRef.getCurBlock() &&
           !SemaRef.getCurBlock()->ReturnType.isNull())
    ReturnType = SemaRef.getCurBlock()->ReturnType;;
  if (ReturnType.isNull() || ReturnType->isVoidType()) {
    Builder.AddTypedTextChunk("return");
    Builder.AddChunk(CodeCompletionString::CK_SemiColon);
    Results.AddResult(Result(Builder.TakeString()));
  } else {
    assert(!ReturnType.isNull())(static_cast <bool> (!ReturnType.isNull()) ? void (0) :
 __assert_fail ("!ReturnType.isNull()", "clang/lib/Sema/SemaCodeComplete.cpp"
, 2414, __extension__ __PRETTY_FUNCTION__));
    // "return expression ;"
    Builder.AddTypedTextChunk("return");
    Builder.AddChunk(clang::CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("expression");
    Builder.AddChunk(CodeCompletionString::CK_SemiColon);
    Results.AddResult(Result(Builder.TakeString()));
    // When boolean, also add 'return true;' and 'return false;'.
    if (ReturnType->isBooleanType()) {
      Builder.AddTypedTextChunk("return true");
      Builder.AddChunk(CodeCompletionString::CK_SemiColon);
      Results.AddResult(Result(Builder.TakeString()));

      Builder.AddTypedTextChunk("return false");
      Builder.AddChunk(CodeCompletionString::CK_SemiColon);
      Results.AddResult(Result(Builder.TakeString()));
    }
    // For pointers, suggest 'return nullptr' in C++.
    if (SemaRef.getLangOpts().CPlusPlus11 &&
        (ReturnType->isPointerType() || ReturnType->isMemberPointerType())) {
      Builder.AddTypedTextChunk("return nullptr");
      Builder.AddChunk(CodeCompletionString::CK_SemiColon);
      Results.AddResult(Result(Builder.TakeString()));
    }
  }

  // goto identifier ;
  Builder.AddTypedTextChunk("goto");
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("label");
  Builder.AddChunk(CodeCompletionString::CK_SemiColon);
  Results.AddResult(Result(Builder.TakeString()));

  // Using directives
  Builder.AddTypedTextChunk("using namespace");
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("identifier");
  Builder.AddChunk(CodeCompletionString::CK_SemiColon);
  Results.AddResult(Result(Builder.TakeString()));

  AddStaticAssertResult(Builder, Results, SemaRef.getLangOpts());
}
  [[fallthrough]];

// Fall through (for statement expressions).
case Sema::PCC_ForInit:
case Sema::PCC_Condition:
  AddStorageSpecifiers(CCC, SemaRef.getLangOpts(), Results);
  // Fall through: conditions and statements can have expressions.
  [[fallthrough]];

case Sema::PCC_ParenthesizedExpression:
  if (SemaRef.getLangOpts().ObjCAutoRefCount &&
      CCC == Sema::PCC_ParenthesizedExpression) {
    // (__bridge <type>)<expression>
    Builder.AddTypedTextChunk("__bridge");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("type");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddPlaceholderChunk("expression");
    Results.AddResult(Result(Builder.TakeString()));

    // (__bridge_transfer <Objective-C type>)<expression>
    Builder.AddTypedTextChunk("__bridge_transfer");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("Objective-C type");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddPlaceholderChunk("expression");
    Results.AddResult(Result(Builder.TakeString()));

    // (__bridge_retained <CF type>)<expression>
    Builder.AddTypedTextChunk("__bridge_retained");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("CF type");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddPlaceholderChunk("expression");
    Results.AddResult(Result(Builder.TakeString()));
  }
  // Fall through
  [[fallthrough]];

case Sema::PCC_Expression: {
  if (SemaRef.getLangOpts().CPlusPlus) {
    // 'this', if we're in a non-static member function.
    addThisCompletion(SemaRef, Results);

    // true
    Builder.AddResultTypeChunk("bool");
    Builder.AddTypedTextChunk("true");
    Results.AddResult(Result(Builder.TakeString()));

    // false
    Builder.AddResultTypeChunk("bool");
    Builder.AddTypedTextChunk("false");
    Results.AddResult(Result(Builder.TakeString()));

    if (SemaRef.getLangOpts().RTTI) {
      // dynamic_cast < type-id > ( expression )
      Builder.AddTypedTextChunk("dynamic_cast");
      Builder.AddChunk(CodeCompletionString::CK_LeftAngle);
      Builder.AddPlaceholderChunk("type");
      Builder.AddChunk(CodeCompletionString::CK_RightAngle);
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddPlaceholderChunk("expression");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
      Results.AddResult(Result(Builder.TakeString()));
    }

    // static_cast < type-id > ( expression )
    Builder.AddTypedTextChunk("static_cast");
    Builder.AddChunk(CodeCompletionString::CK_LeftAngle);
    Builder.AddPlaceholderChunk("type");
    Builder.AddChunk(CodeCompletionString::CK_RightAngle);
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("expression");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Results.AddResult(Result(Builder.TakeString()));

    // reinterpret_cast < type-id > ( expression )
    Builder.AddTypedTextChunk("reinterpret_cast");
    Builder.AddChunk(CodeCompletionString::CK_LeftAngle);
    Builder.AddPlaceholderChunk("type");
    Builder.AddChunk(CodeCompletionString::CK_RightAngle);
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("expression");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Results.AddResult(Result(Builder.TakeString()));

    // const_cast < type-id > ( expression )
    Builder.AddTypedTextChunk("const_cast");
    Builder.AddChunk(CodeCompletionString::CK_LeftAngle);
    Builder.AddPlaceholderChunk("type");
    Builder.AddChunk(CodeCompletionString::CK_RightAngle);
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("expression");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Results.AddResult(Result(Builder.TakeString()));

    if (SemaRef.getLangOpts().RTTI) {
      // typeid ( expression-or-type )
      Builder.AddResultTypeChunk("std::type_info");
      Builder.AddTypedTextChunk("typeid");
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddPlaceholderChunk("expression-or-type");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
      Results.AddResult(Result(Builder.TakeString()));
    }

    // new T ( ... )
    Builder.AddTypedTextChunk("new");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("type");
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("expressions");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Results.AddResult(Result(Builder.TakeString()));

    // new T [ ] ( ... )
    Builder.AddTypedTextChunk("new");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("type");
    Builder.AddChunk(CodeCompletionString::CK_LeftBracket);
    Builder.AddPlaceholderChunk("size");
    Builder.AddChunk(CodeCompletionString::CK_RightBracket);
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("expressions");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Results.AddResult(Result(Builder.TakeString()));

    // delete expression
    Builder.AddResultTypeChunk("void");
    Builder.AddTypedTextChunk("delete");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("expression");
    Results.AddResult(Result(Builder.TakeString()));

    // delete [] expression
    Builder.AddResultTypeChunk("void");
    Builder.AddTypedTextChunk("delete");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftBracket);
    Builder.AddChunk(CodeCompletionString::CK_RightBracket);
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("expression");
    Results.AddResult(Result(Builder.TakeString()));

    if (SemaRef.getLangOpts().CXXExceptions) {
      // throw expression
      Builder.AddResultTypeChunk("void");
      Builder.AddTypedTextChunk("throw");
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      Builder.AddPlaceholderChunk("expression");
      Results.AddResult(Result(Builder.TakeString()));
    }

    // FIXME: Rethrow?

    if (SemaRef.getLangOpts().CPlusPlus11) {
      // nullptr
      Builder.AddResultTypeChunk("std::nullptr_t");
      Builder.AddTypedTextChunk("nullptr");
      Results.AddResult(Result(Builder.TakeString()));

      // alignof
      Builder.AddResultTypeChunk("size_t");
      Builder.AddTypedTextChunk("alignof");
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddPlaceholderChunk("type");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
      Results.AddResult(Result(Builder.TakeString()));

      // noexcept
      Builder.AddResultTypeChunk("bool");
      Builder.AddTypedTextChunk("noexcept");
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddPlaceholderChunk("expression");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
      Results.AddResult(Result(Builder.TakeString()));

      // sizeof... expression
      Builder.AddResultTypeChunk("size_t");
      Builder.AddTypedTextChunk("sizeof...");
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddPlaceholderChunk("parameter-pack");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
      Results.AddResult(Result(Builder.TakeString()));
    }
  }

  if (SemaRef.getLangOpts().ObjC) {
    // Add "super", if we're in an Objective-C class with a superclass.
    if (ObjCMethodDecl *Method = SemaRef.getCurMethodDecl()) {
      // The interface can be NULL.
      if (ObjCInterfaceDecl *ID = Method->getClassInterface())
        if (ID->getSuperClass()) {
          std::string SuperType;
          SuperType = ID->getSuperClass()->getNameAsString();
          if (Method->isInstanceMethod())
            SuperType += " *";

          Builder.AddResultTypeChunk(Allocator.CopyString(SuperType));
          Builder.AddTypedTextChunk("super");
          Results.AddResult(Result(Builder.TakeString()));
        }
    }

    AddObjCExpressionResults(Results, true);
  }

  if (SemaRef.getLangOpts().C11) {
    // _Alignof
    Builder.AddResultTypeChunk("size_t");
    if (SemaRef.PP.isMacroDefined("alignof"))
      Builder.AddTypedTextChunk("alignof");
    else
      Builder.AddTypedTextChunk("_Alignof");
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("type");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Results.AddResult(Result(Builder.TakeString()));
  }

  if (SemaRef.getLangOpts().C2x) {
    // nullptr
    Builder.AddResultTypeChunk("nullptr_t");
    Builder.AddTypedTextChunk("nullptr");
    Results.AddResult(Result(Builder.TakeString()));
  }

  // sizeof expression
  Builder.AddResultTypeChunk("size_t");
  Builder.AddTypedTextChunk("sizeof");
  Builder.AddChunk(CodeCompletionString::CK_LeftParen);
  Builder.AddPlaceholderChunk("expression-or-type");
  Builder.AddChunk(CodeCompletionString::CK_RightParen);
  Results.AddResult(Result(Builder.TakeString()));
  break;
}

case Sema::PCC_Type:
case Sema::PCC_LocalDeclarationSpecifiers:
  break;
}

if (WantTypesInContext(CCC, SemaRef.getLangOpts()))
  AddTypeSpecifierResults(SemaRef.getLangOpts(), Results);

if (SemaRef.getLangOpts().CPlusPlus && CCC != Sema::PCC_Type)
  Results.AddResult(Result("operator"));
2703}

2705/// If the given declaration has an associated type, add it as a result
2706/// type chunk.
2707static void AddResultTypeChunk(ASTContext &Context,
                             const PrintingPolicy &Policy,
                             const NamedDecl *ND, QualType BaseType,
                             CodeCompletionBuilder &Result) {
if (!ND)
  return;

// Skip constructors and conversion functions, which have their return types
// built into their names.
if (isConstructor(ND) || isa<CXXConversionDecl>(ND))
  return;

// Determine the type of the declaration (if it has a type).
QualType T;
if (const FunctionDecl *Function = ND->getAsFunction())
  T = Function->getReturnType();
else if (const auto *Method = dyn_cast<ObjCMethodDecl>(ND)) {
  if (!BaseType.isNull())
    T = Method->getSendResultType(BaseType);
  else
    T = Method->getReturnType();
} else if (const auto *Enumerator = dyn_cast<EnumConstantDecl>(ND)) {
  T = Context.getTypeDeclType(cast<TypeDecl>(Enumerator->getDeclContext()));
  T = clang::TypeName::getFullyQualifiedType(T, Context);
} else if (isa<UnresolvedUsingValueDecl>(ND)) {
  /* Do nothing: ignore unresolved using declarations*/
} else if (const auto *Ivar = dyn_cast<ObjCIvarDecl>(ND)) {
  if (!BaseType.isNull())
    T = Ivar->getUsageType(BaseType);
  else
    T = Ivar->getType();
} else if (const auto *Value = dyn_cast<ValueDecl>(ND)) {
  T = Value->getType();
} else if (const auto *Property = dyn_cast<ObjCPropertyDecl>(ND)) {
  if (!BaseType.isNull())
    T = Property->getUsageType(BaseType);
  else
    T = Property->getType();
}

if (T.isNull() || Context.hasSameType(T, Context.DependentTy))
  return;

Result.AddResultTypeChunk(
    GetCompletionTypeString(T, Context, Policy, Result.getAllocator()));
2752}

2754static void MaybeAddSentinel(Preprocessor &PP,
                           const NamedDecl *FunctionOrMethod,
                           CodeCompletionBuilder &Result) {
if (SentinelAttr *Sentinel = FunctionOrMethod->getAttr<SentinelAttr>())
  if (Sentinel->getSentinel() == 0) {
    if (PP.getLangOpts().ObjC && PP.isMacroDefined("nil"))
      Result.AddTextChunk(", nil");
    else if (PP.isMacroDefined("NULL"))
      Result.AddTextChunk(", NULL");
    else
      Result.AddTextChunk(", (void*)0");
  }
2766}

2768static std::string formatObjCParamQualifiers(unsigned ObjCQuals,
                                           QualType &Type) {
std::string Result;
if (ObjCQuals & Decl::OBJC_TQ_In)
  Result += "in ";
else if (ObjCQuals & Decl::OBJC_TQ_Inout)
  Result += "inout ";
else if (ObjCQuals & Decl::OBJC_TQ_Out)
  Result += "out ";
if (ObjCQuals & Decl::OBJC_TQ_Bycopy)
  Result += "bycopy ";
else if (ObjCQuals & Decl::OBJC_TQ_Byref)
  Result += "byref ";
if (ObjCQuals & Decl::OBJC_TQ_Oneway)
  Result += "oneway ";
if (ObjCQuals & Decl::OBJC_TQ_CSNullability) {
  if (auto nullability = AttributedType::stripOuterNullability(Type)) {
    switch (*nullability) {
    case NullabilityKind::NonNull:
      Result += "nonnull ";
      break;

    case NullabilityKind::Nullable:
      Result += "nullable ";
      break;

    case NullabilityKind::Unspecified:
      Result += "null_unspecified ";
      break;

    case NullabilityKind::NullableResult:
      llvm_unreachable("Not supported as a context-sensitive keyword!")::llvm::llvm_unreachable_internal("Not supported as a context-sensitive keyword!"
, "clang/lib/Sema/SemaCodeComplete.cpp", 2799);
      break;
    }
  }
}
return Result;
2805}

2807/// Tries to find the most appropriate type location for an Objective-C
2808/// block placeholder.
2809///
2810/// This function ignores things like typedefs and qualifiers in order to
2811/// present the most relevant and accurate block placeholders in code completion
2812/// results.
2813static void findTypeLocationForBlockDecl(const TypeSourceInfo *TSInfo,
                                       FunctionTypeLoc &Block,
                                       FunctionProtoTypeLoc &BlockProto,
                                       bool SuppressBlock = false) {
if (!TSInfo)
  return;
TypeLoc TL = TSInfo->getTypeLoc().getUnqualifiedLoc();
while (true) {
  // Look through typedefs.
  if (!SuppressBlock) {
    if (TypedefTypeLoc TypedefTL = TL.getAsAdjusted<TypedefTypeLoc>()) {
      if (TypeSourceInfo *InnerTSInfo =
              TypedefTL.getTypedefNameDecl()->getTypeSourceInfo()) {
        TL = InnerTSInfo->getTypeLoc().getUnqualifiedLoc();
        continue;
      }
    }

    // Look through qualified types
    if (QualifiedTypeLoc QualifiedTL = TL.getAs<QualifiedTypeLoc>()) {
      TL = QualifiedTL.getUnqualifiedLoc();
      continue;
    }

    if (AttributedTypeLoc AttrTL = TL.getAs<AttributedTypeLoc>()) {
      TL = AttrTL.getModifiedLoc();
      continue;
    }
  }

  // Try to get the function prototype behind the block pointer type,
  // then we're done.
  if (BlockPointerTypeLoc BlockPtr = TL.getAs<BlockPointerTypeLoc>()) {
    TL = BlockPtr.getPointeeLoc().IgnoreParens();
    Block = TL.getAs<FunctionTypeLoc>();
    BlockProto = TL.getAs<FunctionProtoTypeLoc>();
  }
  break;
}
2852}

2854static std::string formatBlockPlaceholder(
  const PrintingPolicy &Policy, const NamedDecl *BlockDecl,
  FunctionTypeLoc &Block, FunctionProtoTypeLoc &BlockProto,
  bool SuppressBlockName = false, bool SuppressBlock = false,
  std::optional<ArrayRef<QualType>> ObjCSubsts = std::nullopt);

2860static std::string FormatFunctionParameter(
  const PrintingPolicy &Policy, const DeclaratorDecl *Param,
  bool SuppressName = false, bool SuppressBlock = false,
  std::optional<ArrayRef<QualType>> ObjCSubsts = std::nullopt) {
// Params are unavailable in FunctionTypeLoc if the FunctionType is invalid.
// It would be better to pass in the param Type, which is usually available.
// But this case is rare, so just pretend we fell back to int as elsewhere.
if (!Param)
  return "int";
Decl::ObjCDeclQualifier ObjCQual = Decl::OBJC_TQ_None;
if (const auto *PVD = dyn_cast<ParmVarDecl>(Param))
  ObjCQual = PVD->getObjCDeclQualifier();
bool ObjCMethodParam = isa<ObjCMethodDecl>(Param->getDeclContext());
if (Param->getType()->isDependentType() ||
    !Param->getType()->isBlockPointerType()) {
  // The argument for a dependent or non-block parameter is a placeholder
  // containing that parameter's type.
  std::string Result;

  if (Param->getIdentifier() && !ObjCMethodParam && !SuppressName)
    Result = std::string(Param->getIdentifier()->deuglifiedName());

  QualType Type = Param->getType();
  if (ObjCSubsts)
    Type = Type.substObjCTypeArgs(Param->getASTContext(), *ObjCSubsts,
                                  ObjCSubstitutionContext::Parameter);
  if (ObjCMethodParam) {
    Result = "(" + formatObjCParamQualifiers(ObjCQual, Type);
    Result += Type.getAsString(Policy) + ")";
    if (Param->getIdentifier() && !SuppressName)
      Result += Param->getIdentifier()->deuglifiedName();
  } else {
    Type.getAsStringInternal(Result, Policy);
  }
  return Result;
}

// The argument for a block pointer parameter is a block literal with
// the appropriate type.
FunctionTypeLoc Block;
FunctionProtoTypeLoc BlockProto;
findTypeLocationForBlockDecl(Param->getTypeSourceInfo(), Block, BlockProto,
                             SuppressBlock);
// Try to retrieve the block type information from the property if this is a
// parameter in a setter.
if (!Block && ObjCMethodParam &&
    cast<ObjCMethodDecl>(Param->getDeclContext())->isPropertyAccessor()) {
  if (const auto *PD = cast<ObjCMethodDecl>(Param->getDeclContext())
                           ->findPropertyDecl(/*CheckOverrides=*/false))
    findTypeLocationForBlockDecl(PD->getTypeSourceInfo(), Block, BlockProto,
                                 SuppressBlock);
}

if (!Block) {
  // We were unable to find a FunctionProtoTypeLoc with parameter names
  // for the block; just use the parameter type as a placeholder.
  std::string Result;
  if (!ObjCMethodParam && Param->getIdentifier())
    Result = std::string(Param->getIdentifier()->deuglifiedName());

  QualType Type = Param->getType().getUnqualifiedType();

  if (ObjCMethodParam) {
    Result = Type.getAsString(Policy);
    std::string Quals = formatObjCParamQualifiers(ObjCQual, Type);
    if (!Quals.empty())
      Result = "(" + Quals + " " + Result + ")";
    if (Result.back() != ')')
      Result += " ";
    if (Param->getIdentifier())
      Result += Param->getIdentifier()->deuglifiedName();
  } else {
    Type.getAsStringInternal(Result, Policy);
  }

  return Result;
}

// We have the function prototype behind the block pointer type, as it was
// written in the source.
return formatBlockPlaceholder(Policy, Param, Block, BlockProto,
                              /*SuppressBlockName=*/false, SuppressBlock,
                              ObjCSubsts);
2943}

2945/// Returns a placeholder string that corresponds to an Objective-C block
2946/// declaration.
2947///
2948/// \param BlockDecl A declaration with an Objective-C block type.
2949///
2950/// \param Block The most relevant type location for that block type.
2951///
2952/// \param SuppressBlockName Determines whether or not the name of the block
2953/// declaration is included in the resulting string.
2954static std::string
2955formatBlockPlaceholder(const PrintingPolicy &Policy, const NamedDecl *BlockDecl,
                     FunctionTypeLoc &Block, FunctionProtoTypeLoc &BlockProto,
                     bool SuppressBlockName, bool SuppressBlock,
                     std::optional<ArrayRef<QualType>> ObjCSubsts) {
std::string Result;
QualType ResultType = Block.getTypePtr()->getReturnType();
if (ObjCSubsts)
  ResultType =
      ResultType.substObjCTypeArgs(BlockDecl->getASTContext(), *ObjCSubsts,
                                   ObjCSubstitutionContext::Result);
if (!ResultType->isVoidType() || SuppressBlock)
  ResultType.getAsStringInternal(Result, Policy);

// Format the parameter list.
std::string Params;
if (!BlockProto || Block.getNumParams() == 0) {
  if (BlockProto && BlockProto.getTypePtr()->isVariadic())
    Params = "(...)";
  else
    Params = "(void)";
} else {
  Params += "(";
  for (unsigned I = 0, N = Block.getNumParams(); I != N; ++I) {
    if (I)
      Params += ", ";
    Params += FormatFunctionParameter(Policy, Block.getParam(I),
                                      /*SuppressName=*/false,
                                      /*SuppressBlock=*/true, ObjCSubsts);

    if (I == N - 1 && BlockProto.getTypePtr()->isVariadic())
      Params += ", ...";
  }
  Params += ")";
}

if (SuppressBlock) {
  // Format as a parameter.
  Result = Result + " (^";
  if (!SuppressBlockName && BlockDecl->getIdentifier())
    Result += BlockDecl->getIdentifier()->getName();
  Result += ")";
  Result += Params;
} else {
  // Format as a block literal argument.
  Result = '^' + Result;
  Result += Params;

  if (!SuppressBlockName && BlockDecl->getIdentifier())
    Result += BlockDecl->getIdentifier()->getName();
}

return Result;
3007}

3009static std::string GetDefaultValueString(const ParmVarDecl *Param,
                                       const SourceManager &SM,
                                       const LangOptions &LangOpts) {
const SourceRange SrcRange = Param->getDefaultArgRange();
CharSourceRange CharSrcRange = CharSourceRange::getTokenRange(SrcRange);
bool Invalid = CharSrcRange.isInvalid();
if (Invalid)
  return "";
StringRef srcText =
    Lexer::getSourceText(CharSrcRange, SM, LangOpts, &Invalid);
if (Invalid)
  return "";

if (srcText.empty() || srcText == "=") {
  // Lexer can't determine the value.
  // This happens if the code is incorrect (for example class is forward
  // declared).
  return "";
}
std::string DefValue(srcText.str());
// FIXME: remove this check if the Lexer::getSourceText value is fixed and
// this value always has (or always does not have) '=' in front of it
if (DefValue.at(0) != '=') {
  // If we don't have '=' in front of value.
  // Lexer returns built-in types values without '=' and user-defined types
  // values with it.
  return " = " + DefValue;
}
return " " + DefValue;
3038}

3040/// Add function parameter chunks to the given code completion string.
3041static void AddFunctionParameterChunks(Preprocessor &PP,
                                     const PrintingPolicy &Policy,
                                     const FunctionDecl *Function,
                                     CodeCompletionBuilder &Result,
                                     unsigned Start = 0,
                                     bool InOptional = false) {
bool FirstParameter = true;

for (unsigned P = Start, N = Function->getNumParams(); P != N; ++P) {
  const ParmVarDecl *Param = Function->getParamDecl(P);

  if (Param->hasDefaultArg() && !InOptional) {
    // When we see an optional default argument, put that argument and
    // the remaining default arguments into a new, optional string.
    CodeCompletionBuilder Opt(Result.getAllocator(),
                              Result.getCodeCompletionTUInfo());
    if (!FirstParameter)
      Opt.AddChunk(CodeCompletionString::CK_Comma);
    AddFunctionParameterChunks(PP, Policy, Function, Opt, P, true);
    Result.AddOptionalChunk(Opt.TakeString());
    break;
  }

  if (FirstParameter)
    FirstParameter = false;
  else
    Result.AddChunk(CodeCompletionString::CK_Comma);

  InOptional = false;

  // Format the placeholder string.
  std::string PlaceholderStr = FormatFunctionParameter(Policy, Param);
  if (Param->hasDefaultArg())
    PlaceholderStr +=
        GetDefaultValueString(Param, PP.getSourceManager(), PP.getLangOpts());

  if (Function->isVariadic() && P == N - 1)
    PlaceholderStr += ", ...";

  // Add the placeholder string.
  Result.AddPlaceholderChunk(
      Result.getAllocator().CopyString(PlaceholderStr));
}

if (const auto *Proto = Function->getType()->getAs<FunctionProtoType>())
  if (Proto->isVariadic()) {
    if (Proto->getNumParams() == 0)
      Result.AddPlaceholderChunk("...");

    MaybeAddSentinel(PP, Function, Result);
  }
3092}

3094/// Add template parameter chunks to the given code completion string.
3095static void AddTemplateParameterChunks(
  ASTContext &Context, const PrintingPolicy &Policy,
  const TemplateDecl *Template, CodeCompletionBuilder &Result,
  unsigned MaxParameters = 0, unsigned Start = 0, bool InDefaultArg = false) {
bool FirstParameter = true;

// Prefer to take the template parameter names from the first declaration of
// the template.
Template = cast<TemplateDecl>(Template->getCanonicalDecl());

TemplateParameterList *Params = Template->getTemplateParameters();
TemplateParameterList::iterator PEnd = Params->end();
if (MaxParameters)
  PEnd = Params->begin() + MaxParameters;
for (TemplateParameterList::iterator P = Params->begin() + Start; P != PEnd;
     ++P) {
  bool HasDefaultArg = false;
  std::string PlaceholderStr;
  if (TemplateTypeParmDecl *TTP = dyn_cast<TemplateTypeParmDecl>(*P)) {
    if (TTP->wasDeclaredWithTypename())
      PlaceholderStr = "typename";
    else if (const auto *TC = TTP->getTypeConstraint()) {
      llvm::raw_string_ostream OS(PlaceholderStr);
      TC->print(OS, Policy);
      OS.flush();
    } else
      PlaceholderStr = "class";

    if (TTP->getIdentifier()) {
      PlaceholderStr += ' ';
      PlaceholderStr += TTP->getIdentifier()->deuglifiedName();
    }

    HasDefaultArg = TTP->hasDefaultArgument();
  } else if (NonTypeTemplateParmDecl *NTTP =
                 dyn_cast<NonTypeTemplateParmDecl>(*P)) {
    if (NTTP->getIdentifier())
      PlaceholderStr = std::string(NTTP->getIdentifier()->deuglifiedName());
    NTTP->getType().getAsStringInternal(PlaceholderStr, Policy);
    HasDefaultArg = NTTP->hasDefaultArgument();
  } else {
    assert(isa<TemplateTemplateParmDecl>(*P))(static_cast <bool> (isa<TemplateTemplateParmDecl>
(*P)) ? void (0) : __assert_fail ("isa<TemplateTemplateParmDecl>(*P)"
, "clang/lib/Sema/SemaCodeComplete.cpp", 3136, __extension__ __PRETTY_FUNCTION__
));
    TemplateTemplateParmDecl *TTP = cast<TemplateTemplateParmDecl>(*P);

    // Since putting the template argument list into the placeholder would
    // be very, very long, we just use an abbreviation.
    PlaceholderStr = "template<...> class";
    if (TTP->getIdentifier()) {
      PlaceholderStr += ' ';
      PlaceholderStr += TTP->getIdentifier()->deuglifiedName();
    }

    HasDefaultArg = TTP->hasDefaultArgument();
  }

  if (HasDefaultArg && !InDefaultArg) {
    // When we see an optional default argument, put that argument and
    // the remaining default arguments into a new, optional string.
    CodeCompletionBuilder Opt(Result.getAllocator(),
                              Result.getCodeCompletionTUInfo());
    if (!FirstParameter)
      Opt.AddChunk(CodeCompletionString::CK_Comma);
    AddTemplateParameterChunks(Context, Policy, Template, Opt, MaxParameters,
                               P - Params->begin(), true);
    Result.AddOptionalChunk(Opt.TakeString());
    break;
  }

  InDefaultArg = false;

  if (FirstParameter)
    FirstParameter = false;
  else
    Result.AddChunk(CodeCompletionString::CK_Comma);

  // Add the placeholder string.
  Result.AddPlaceholderChunk(
      Result.getAllocator().CopyString(PlaceholderStr));
}
3174}

3176/// Add a qualifier to the given code-completion string, if the
3177/// provided nested-name-specifier is non-NULL.
3178static void AddQualifierToCompletionString(CodeCompletionBuilder &Result,
                                         NestedNameSpecifier *Qualifier,
                                         bool QualifierIsInformative,
                                         ASTContext &Context,
                                         const PrintingPolicy &Policy) {
if (!Qualifier)
  return;

std::string PrintedNNS;
{
  llvm::raw_string_ostream OS(PrintedNNS);
  Qualifier->print(OS, Policy);
}
if (QualifierIsInformative)
  Result.AddInformativeChunk(Result.getAllocator().CopyString(PrintedNNS));
else
  Result.AddTextChunk(Result.getAllocator().CopyString(PrintedNNS));
3195}

3197static void
3198AddFunctionTypeQualsToCompletionString(CodeCompletionBuilder &Result,
                                     const FunctionDecl *Function) {
const auto *Proto = Function->getType()->getAs<FunctionProtoType>();
if (!Proto || !Proto->getMethodQuals())
  return;

// FIXME: Add ref-qualifier!

// Handle single qualifiers without copying
if (Proto->getMethodQuals().hasOnlyConst()) {
  Result.AddInformativeChunk(" const");
  return;
}

if (Proto->getMethodQuals().hasOnlyVolatile()) {
  Result.AddInformativeChunk(" volatile");
  return;
}

if (Proto->getMethodQuals().hasOnlyRestrict()) {
  Result.AddInformativeChunk(" restrict");
  return;
}

// Handle multiple qualifiers.
std::string QualsStr;
if (Proto->isConst())
  QualsStr += " const";
if (Proto->isVolatile())
  QualsStr += " volatile";
if (Proto->isRestrict())
  QualsStr += " restrict";
Result.AddInformativeChunk(Result.getAllocator().CopyString(QualsStr));
3231}

3233/// Add the name of the given declaration
3234static void AddTypedNameChunk(ASTContext &Context, const PrintingPolicy &Policy,
                            const NamedDecl *ND,
                            CodeCompletionBuilder &Result) {
DeclarationName Name = ND->getDeclName();
if (!Name)
  return;

switch (Name.getNameKind()) {
case DeclarationName::CXXOperatorName: {
  const char *OperatorName = nullptr;
  switch (Name.getCXXOverloadedOperator()) {
  case OO_None:
  case OO_Conditional:
  case NUM_OVERLOADED_OPERATORS:
    OperatorName = "operator";
    break;

3251#define OVERLOADED_OPERATOR(Name, Spelling, Token, Unary, Binary, MemberOnly)  \
case OO_##Name:                                                              \
  OperatorName = "operator" Spelling;                                        \
  break;
3255#define OVERLOADED_OPERATOR_MULTI(Name, Spelling, Unary, Binary, MemberOnly)
3256#include "clang/Basic/OperatorKinds.def"

  case OO_New:
    OperatorName = "operator new";
    break;
  case OO_Delete:
    OperatorName = "operator delete";
    break;
  case OO_Array_New:
    OperatorName = "operator new[]";
    break;
  case OO_Array_Delete:
    OperatorName = "operator delete[]";
    break;
  case OO_Call:
    OperatorName = "operator()";
    break;
  case OO_Subscript:
    OperatorName = "operator[]";
    break;
  }
  Result.AddTypedTextChunk(OperatorName);
  break;
}

case DeclarationName::Identifier:
case DeclarationName::CXXConversionFunctionName:
case DeclarationName::CXXDestructorName:
case DeclarationName::CXXLiteralOperatorName:
  Result.AddTypedTextChunk(
      Result.getAllocator().CopyString(ND->getNameAsString()));
  break;

case DeclarationName::CXXDeductionGuideName:
case DeclarationName::CXXUsingDirective:
case DeclarationName::ObjCZeroArgSelector:
case DeclarationName::ObjCOneArgSelector:
case DeclarationName::ObjCMultiArgSelector:
  break;

case DeclarationName::CXXConstructorName: {
  CXXRecordDecl *Record = nullptr;
  QualType Ty = Name.getCXXNameType();
  if (const auto *RecordTy = Ty->getAs<RecordType>())
    Record = cast<CXXRecordDecl>(RecordTy->getDecl());
  else if (const auto *InjectedTy = Ty->getAs<InjectedClassNameType>())
    Record = InjectedTy->getDecl();
  else {
    Result.AddTypedTextChunk(
        Result.getAllocator().CopyString(ND->getNameAsString()));
    break;
  }

  Result.AddTypedTextChunk(
      Result.getAllocator().CopyString(Record->getNameAsString()));
  if (ClassTemplateDecl *Template = Record->getDescribedClassTemplate()) {
    Result.AddChunk(CodeCompletionString::CK_LeftAngle);
    AddTemplateParameterChunks(Context, Policy, Template, Result);
    Result.AddChunk(CodeCompletionString::CK_RightAngle);
  }
  break;
}
}
3319}

3321CodeCompletionString *CodeCompletionResult::CreateCodeCompletionString(
  Sema &S, const CodeCompletionContext &CCContext,
  CodeCompletionAllocator &Allocator, CodeCompletionTUInfo &CCTUInfo,
  bool IncludeBriefComments) {
return CreateCodeCompletionString(S.Context, S.PP, CCContext, Allocator,
                                  CCTUInfo, IncludeBriefComments);
3327}

3329CodeCompletionString *CodeCompletionResult::CreateCodeCompletionStringForMacro(
  Preprocessor &PP, CodeCompletionAllocator &Allocator,
  CodeCompletionTUInfo &CCTUInfo) {
assert(Kind == RK_Macro)(static_cast <bool> (Kind == RK_Macro) ? void (0) : __assert_fail
 ("Kind == RK_Macro", "clang/lib/Sema/SemaCodeComplete.cpp", 3332
, __extension__ __PRETTY_FUNCTION__));
CodeCompletionBuilder Result(Allocator, CCTUInfo, Priority, Availability);
const MacroInfo *MI = PP.getMacroInfo(Macro);
Result.AddTypedTextChunk(Result.getAllocator().CopyString(Macro->getName()));

if (!MI || !MI->isFunctionLike())
  return Result.TakeString();

// Format a function-like macro with placeholders for the arguments.
Result.AddChunk(CodeCompletionString::CK_LeftParen);
MacroInfo::param_iterator A = MI->param_begin(), AEnd = MI->param_end();

// C99 variadic macros add __VA_ARGS__ at the end. Skip it.
if (MI->isC99Varargs()) {
  --AEnd;

  if (A == AEnd) {
    Result.AddPlaceholderChunk("...");
  }
}

for (MacroInfo::param_iterator A = MI->param_begin(); A != AEnd; ++A) {
  if (A != MI->param_begin())
    Result.AddChunk(CodeCompletionString::CK_Comma);

  if (MI->isVariadic() && (A + 1) == AEnd) {
    SmallString<32> Arg = (*A)->getName();
    if (MI->isC99Varargs())
      Arg += ", ...";
    else
      Arg += "...";
    Result.AddPlaceholderChunk(Result.getAllocator().CopyString(Arg));
    break;
  }

  // Non-variadic macros are simple.
  Result.AddPlaceholderChunk(
      Result.getAllocator().CopyString((*A)->getName()));
}
Result.AddChunk(CodeCompletionString::CK_RightParen);
return Result.TakeString();
3373}

3375/// If possible, create a new code completion string for the given
3376/// result.
3377///
3378/// \returns Either a new, heap-allocated code completion string describing
3379/// how to use this result, or NULL to indicate that the string or name of the
3380/// result is all that is needed.
3381CodeCompletionString *CodeCompletionResult::CreateCodeCompletionString(
  ASTContext &Ctx, Preprocessor &PP, const CodeCompletionContext &CCContext,
  CodeCompletionAllocator &Allocator, CodeCompletionTUInfo &CCTUInfo,
  bool IncludeBriefComments) {
if (Kind == RK_Macro)
  return CreateCodeCompletionStringForMacro(PP, Allocator, CCTUInfo);

CodeCompletionBuilder Result(Allocator, CCTUInfo, Priority, Availability);

PrintingPolicy Policy = getCompletionPrintingPolicy(Ctx, PP);
if (Kind == RK_Pattern) {
  Pattern->Priority = Priority;
  Pattern->Availability = Availability;

  if (Declaration) {
    Result.addParentContext(Declaration->getDeclContext());
    Pattern->ParentName = Result.getParentName();
    if (const RawComment *RC =
            getPatternCompletionComment(Ctx, Declaration)) {
      Result.addBriefComment(RC->getBriefText(Ctx));
      Pattern->BriefComment = Result.getBriefComment();
    }
  }

  return Pattern;
}

if (Kind == RK_Keyword) {
  Result.AddTypedTextChunk(Keyword);
  return Result.TakeString();
}
assert(Kind == RK_Declaration && "Missed a result kind?")(static_cast <bool> (Kind == RK_Declaration && "Missed a result kind?"
) ? void (0) : __assert_fail ("Kind == RK_Declaration && \"Missed a result kind?\""
, "clang/lib/Sema/SemaCodeComplete.cpp", 3412, __extension__ __PRETTY_FUNCTION__
));
return createCodeCompletionStringForDecl(
    PP, Ctx, Result, IncludeBriefComments, CCContext, Policy);
3415}

3417static void printOverrideString(const CodeCompletionString &CCS,
                              std::string &BeforeName,
                              std::string &NameAndSignature) {
bool SeenTypedChunk = false;
for (auto &Chunk : CCS) {
  if (Chunk.Kind == CodeCompletionString::CK_Optional) {
    assert(SeenTypedChunk && "optional parameter before name")(static_cast <bool> (SeenTypedChunk && "optional parameter before name"
) ? void (0) : __assert_fail ("SeenTypedChunk && \"optional parameter before name\""
, "clang/lib/Sema/SemaCodeComplete.cpp", 3423, __extension__ __PRETTY_FUNCTION__
));
    // Note that we put all chunks inside into NameAndSignature.
    printOverrideString(*Chunk.Optional, NameAndSignature, NameAndSignature);
    continue;
  }
  SeenTypedChunk |= Chunk.Kind == CodeCompletionString::CK_TypedText;
  if (SeenTypedChunk)
    NameAndSignature += Chunk.Text;
  else
    BeforeName += Chunk.Text;
}
3434}

3436CodeCompletionString *
3437CodeCompletionResult::createCodeCompletionStringForOverride(
  Preprocessor &PP, ASTContext &Ctx, CodeCompletionBuilder &Result,
  bool IncludeBriefComments, const CodeCompletionContext &CCContext,
  PrintingPolicy &Policy) {
auto *CCS = createCodeCompletionStringForDecl(PP, Ctx, Result,
                                              /*IncludeBriefComments=*/false,
                                              CCContext, Policy);
std::string BeforeName;
std::string NameAndSignature;
// For overrides all chunks go into the result, none are informative.
printOverrideString(*CCS, BeforeName, NameAndSignature);
NameAndSignature += " override";

Result.AddTextChunk(Result.getAllocator().CopyString(BeforeName));
Result.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Result.AddTypedTextChunk(Result.getAllocator().CopyString(NameAndSignature));
return Result.TakeString();
3454}

3456// FIXME: Right now this works well with lambdas. Add support for other functor
3457// types like std::function.
3458static const NamedDecl *extractFunctorCallOperator(const NamedDecl *ND) {
const auto *VD = dyn_cast<VarDecl>(ND);
if (!VD)
  return nullptr;
const auto *RecordDecl = VD->getType()->getAsCXXRecordDecl();
if (!RecordDecl || !RecordDecl->isLambda())
  return nullptr;
return RecordDecl->getLambdaCallOperator();
3466}

3468CodeCompletionString *CodeCompletionResult::createCodeCompletionStringForDecl(
  Preprocessor &PP, ASTContext &Ctx, CodeCompletionBuilder &Result,
  bool IncludeBriefComments, const CodeCompletionContext &CCContext,
  PrintingPolicy &Policy) {
const NamedDecl *ND = Declaration;
Result.addParentContext(ND->getDeclContext());

if (IncludeBriefComments) {
  // Add documentation comment, if it exists.
  if (const RawComment *RC = getCompletionComment(Ctx, Declaration)) {
    Result.addBriefComment(RC->getBriefText(Ctx));
  }
}

if (StartsNestedNameSpecifier) {
  Result.AddTypedTextChunk(
      Result.getAllocator().CopyString(ND->getNameAsString()));
  Result.AddTextChunk("::");
  return Result.TakeString();
}

for (const auto *I : ND->specific_attrs<AnnotateAttr>())
  Result.AddAnnotation(Result.getAllocator().CopyString(I->getAnnotation()));

auto AddFunctionTypeAndResult = [&](const FunctionDecl *Function) {
  AddResultTypeChunk(Ctx, Policy, Function, CCContext.getBaseType(), Result);
  AddQualifierToCompletionString(Result, Qualifier, QualifierIsInformative,
                                 Ctx, Policy);
  AddTypedNameChunk(Ctx, Policy, ND, Result);
  Result.AddChunk(CodeCompletionString::CK_LeftParen);
  AddFunctionParameterChunks(PP, Policy, Function, Result);
  Result.AddChunk(CodeCompletionString::CK_RightParen);
  AddFunctionTypeQualsToCompletionString(Result, Function);
};

if (const auto *Function = dyn_cast<FunctionDecl>(ND)) {
  AddFunctionTypeAndResult(Function);
  return Result.TakeString();
}

if (const auto *CallOperator =
        dyn_cast_or_null<FunctionDecl>(extractFunctorCallOperator(ND))) {
  AddFunctionTypeAndResult(CallOperator);
  return Result.TakeString();
}

AddResultTypeChunk(Ctx, Policy, ND, CCContext.getBaseType(), Result);

if (const FunctionTemplateDecl *FunTmpl =
        dyn_cast<FunctionTemplateDecl>(ND)) {
  AddQualifierToCompletionString(Result, Qualifier, QualifierIsInformative,
                                 Ctx, Policy);
  FunctionDecl *Function = FunTmpl->getTemplatedDecl();
  AddTypedNameChunk(Ctx, Policy, Function, Result);

  // Figure out which template parameters are deduced (or have default
  // arguments).
  llvm::SmallBitVector Deduced;
  Sema::MarkDeducedTemplateParameters(Ctx, FunTmpl, Deduced);
  unsigned LastDeducibleArgument;
  for (LastDeducibleArgument = Deduced.size(); LastDeducibleArgument > 0;
       --LastDeducibleArgument) {
    if (!Deduced[LastDeducibleArgument - 1]) {
      // C++0x: Figure out if the template argument has a default. If so,
      // the user doesn't need to type this argument.
      // FIXME: We need to abstract template parameters better!
      bool HasDefaultArg = false;
      NamedDecl *Param = FunTmpl->getTemplateParameters()->getParam(
          LastDeducibleArgument - 1);
      if (TemplateTypeParmDecl *TTP = dyn_cast<TemplateTypeParmDecl>(Param))
        HasDefaultArg = TTP->hasDefaultArgument();
      else if (NonTypeTemplateParmDecl *NTTP =
                   dyn_cast<NonTypeTemplateParmDecl>(Param))
        HasDefaultArg = NTTP->hasDefaultArgument();
      else {
        assert(isa<TemplateTemplateParmDecl>(Param))(static_cast <bool> (isa<TemplateTemplateParmDecl>
(Param)) ? void (0) : __assert_fail ("isa<TemplateTemplateParmDecl>(Param)"
, "clang/lib/Sema/SemaCodeComplete.cpp", 3543, __extension__ __PRETTY_FUNCTION__
));
        HasDefaultArg =
            cast<TemplateTemplateParmDecl>(Param)->hasDefaultArgument();
      }

      if (!HasDefaultArg)
        break;
    }
  }

  if (LastDeducibleArgument) {
    // Some of the function template arguments cannot be deduced from a
    // function call, so we introduce an explicit template argument list
    // containing all of the arguments up to the first deducible argument.
    Result.AddChunk(CodeCompletionString::CK_LeftAngle);
    AddTemplateParameterChunks(Ctx, Policy, FunTmpl, Result,
                               LastDeducibleArgument);
    Result.AddChunk(CodeCompletionString::CK_RightAngle);
  }

  // Add the function parameters
  Result.AddChunk(CodeCompletionString::CK_LeftParen);
  AddFunctionParameterChunks(PP, Policy, Function, Result);
  Result.AddChunk(CodeCompletionString::CK_RightParen);
  AddFunctionTypeQualsToCompletionString(Result, Function);
  return Result.TakeString();
}

if (const auto *Template = dyn_cast<TemplateDecl>(ND)) {
  AddQualifierToCompletionString(Result, Qualifier, QualifierIsInformative,
                                 Ctx, Policy);
  Result.AddTypedTextChunk(
      Result.getAllocator().CopyString(Template->getNameAsString()));
  Result.AddChunk(CodeCompletionString::CK_LeftAngle);
  AddTemplateParameterChunks(Ctx, Policy, Template, Result);
  Result.AddChunk(CodeCompletionString::CK_RightAngle);
  return Result.TakeString();
}

if (const auto *Method = dyn_cast<ObjCMethodDecl>(ND)) {
  Selector Sel = Method->getSelector();
  if (Sel.isUnarySelector()) {
    Result.AddTypedTextChunk(
        Result.getAllocator().CopyString(Sel.getNameForSlot(0)));
    return Result.TakeString();
  }

  std::string SelName = Sel.getNameForSlot(0).str();
  SelName += ':';
  if (StartParameter == 0)
    Result.AddTypedTextChunk(Result.getAllocator().CopyString(SelName));
  else {
    Result.AddInformativeChunk(Result.getAllocator().CopyString(SelName));

    // If there is only one parameter, and we're past it, add an empty
    // typed-text chunk since there is nothing to type.
    if (Method->param_size() == 1)
      Result.AddTypedTextChunk("");
  }
  unsigned Idx = 0;
  // The extra Idx < Sel.getNumArgs() check is needed due to legacy C-style
  // method parameters.
  for (ObjCMethodDecl::param_const_iterator P = Method->param_begin(),
                                            PEnd = Method->param_end();
       P != PEnd && Idx < Sel.getNumArgs(); (void)++P, ++Idx) {
    if (Idx > 0) {
      std::string Keyword;
      if (Idx > StartParameter)
        Result.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      if (IdentifierInfo *II = Sel.getIdentifierInfoForSlot(Idx))
        Keyword += II->getName();
      Keyword += ":";
      if (Idx < StartParameter || AllParametersAreInformative)
        Result.AddInformativeChunk(Result.getAllocator().CopyString(Keyword));
      else
        Result.AddTypedTextChunk(Result.getAllocator().CopyString(Keyword));
    }

    // If we're before the starting parameter, skip the placeholder.
    if (Idx < StartParameter)
      continue;

    std::string Arg;
    QualType ParamType = (*P)->getType();
    std::optional<ArrayRef<QualType>> ObjCSubsts;
    if (!CCContext.getBaseType().isNull())
      ObjCSubsts = CCContext.getBaseType()->getObjCSubstitutions(Method);

    if (ParamType->isBlockPointerType() && !DeclaringEntity)
      Arg = FormatFunctionParameter(Policy, *P, true,
                                    /*SuppressBlock=*/false, ObjCSubsts);
    else {
      if (ObjCSubsts)
        ParamType = ParamType.substObjCTypeArgs(
            Ctx, *ObjCSubsts, ObjCSubstitutionContext::Parameter);
      Arg = "(" + formatObjCParamQualifiers((*P)->getObjCDeclQualifier(),
                                            ParamType);
      Arg += ParamType.getAsString(Policy) + ")";
      if (IdentifierInfo *II = (*P)->getIdentifier())
        if (DeclaringEntity || AllParametersAreInformative)
          Arg += II->getName();
    }

    if (Method->isVariadic() && (P + 1) == PEnd)
      Arg += ", ...";

    if (DeclaringEntity)
      Result.AddTextChunk(Result.getAllocator().CopyString(Arg));
    else if (AllParametersAreInformative)
      Result.AddInformativeChunk(Result.getAllocator().CopyString(Arg));
    else
      Result.AddPlaceholderChunk(Result.getAllocator().CopyString(Arg));
  }

  if (Method->isVariadic()) {
    if (Method->param_size() == 0) {
      if (DeclaringEntity)
        Result.AddTextChunk(", ...");
      else if (AllParametersAreInformative)
        Result.AddInformativeChunk(", ...");
      else
        Result.AddPlaceholderChunk(", ...");
    }

    MaybeAddSentinel(PP, Method, Result);
  }

  return Result.TakeString();
}

if (Qualifier)
  AddQualifierToCompletionString(Result, Qualifier, QualifierIsInformative,
                                 Ctx, Policy);

Result.AddTypedTextChunk(
    Result.getAllocator().CopyString(ND->getNameAsString()));
return Result.TakeString();
3680}

3682const RawComment *clang::getCompletionComment(const ASTContext &Ctx,
                                            const NamedDecl *ND) {
if (!ND)
  return nullptr;
if (auto *RC = Ctx.getRawCommentForAnyRedecl(ND))
  return RC;

// Try to find comment from a property for ObjC methods.
const auto *M = dyn_cast<ObjCMethodDecl>(ND);
if (!M)
  return nullptr;
const ObjCPropertyDecl *PDecl = M->findPropertyDecl();
if (!PDecl)
  return nullptr;

return Ctx.getRawCommentForAnyRedecl(PDecl);
3698}

3700const RawComment *clang::getPatternCompletionComment(const ASTContext &Ctx,
                                                   const NamedDecl *ND) {
const auto *M = dyn_cast_or_null<ObjCMethodDecl>(ND);
if (!M || !M->isPropertyAccessor())
  return nullptr;

// Provide code completion comment for self.GetterName where
// GetterName is the getter method for a property with name
// different from the property name (declared via a property
// getter attribute.
const ObjCPropertyDecl *PDecl = M->findPropertyDecl();
if (!PDecl)
  return nullptr;
if (PDecl->getGetterName() == M->getSelector() &&
    PDecl->getIdentifier() != M->getIdentifier()) {
  if (auto *RC = Ctx.getRawCommentForAnyRedecl(M))
    return RC;
  if (auto *RC = Ctx.getRawCommentForAnyRedecl(PDecl))
    return RC;
}
return nullptr;
3721}

3723const RawComment *clang::getParameterComment(
  const ASTContext &Ctx,
  const CodeCompleteConsumer::OverloadCandidate &Result, unsigned ArgIndex) {
auto FDecl = Result.getFunction();
if (!FDecl)
  return nullptr;
if (ArgIndex < FDecl->getNumParams())
  return Ctx.getRawCommentForAnyRedecl(FDecl->getParamDecl(ArgIndex));
return nullptr;
3732}

3734static void AddOverloadAggregateChunks(const RecordDecl *RD,
                                     const PrintingPolicy &Policy,
                                     CodeCompletionBuilder &Result,
                                     unsigned CurrentArg) {
unsigned ChunkIndex = 0;
auto AddChunk = [&](llvm::StringRef Placeholder) {
  if (ChunkIndex > 0)
    Result.AddChunk(CodeCompletionString::CK_Comma);
  const char *Copy = Result.getAllocator().CopyString(Placeholder);
  if (ChunkIndex == CurrentArg)
    Result.AddCurrentParameterChunk(Copy);
  else
    Result.AddPlaceholderChunk(Copy);
  ++ChunkIndex;
};
// Aggregate initialization has all bases followed by all fields.
// (Bases are not legal in C++11 but in that case we never get here).
if (auto *CRD = llvm::dyn_cast<CXXRecordDecl>(RD)) {
  for (const auto &Base : CRD->bases())
    AddChunk(Base.getType().getAsString(Policy));
}
for (const auto &Field : RD->fields())
  AddChunk(FormatFunctionParameter(Policy, Field));
3757}

3759/// Add function overload parameter chunks to the given code completion
3760/// string.
3761static void AddOverloadParameterChunks(
  ASTContext &Context, const PrintingPolicy &Policy,
  const FunctionDecl *Function, const FunctionProtoType *Prototype,
  FunctionProtoTypeLoc PrototypeLoc, CodeCompletionBuilder &Result,
  unsigned CurrentArg, unsigned Start = 0, bool InOptional = false) {
if (!Function && !Prototype) {
  Result.AddChunk(CodeCompletionString::CK_CurrentParameter, "...");
  return;
}

bool FirstParameter = true;
unsigned NumParams =
    Function ? Function->getNumParams() : Prototype->getNumParams();

for (unsigned P = Start; P != NumParams; ++P) {
  if (Function && Function->getParamDecl(P)->hasDefaultArg() && !InOptional) {
    // When we see an optional default argument, put that argument and
    // the remaining default arguments into a new, optional string.
    CodeCompletionBuilder Opt(Result.getAllocator(),
                              Result.getCodeCompletionTUInfo());
    if (!FirstParameter)
      Opt.AddChunk(CodeCompletionString::CK_Comma);
    // Optional sections are nested.
    AddOverloadParameterChunks(Context, Policy, Function, Prototype,
                               PrototypeLoc, Opt, CurrentArg, P,
                               /*InOptional=*/true);
    Result.AddOptionalChunk(Opt.TakeString());
    return;
  }

  if (FirstParameter)
    FirstParameter = false;
  else
    Result.AddChunk(CodeCompletionString::CK_Comma);

  InOptional = false;

  // Format the placeholder string.
  std::string Placeholder;
  assert(P < Prototype->getNumParams())(static_cast <bool> (P < Prototype->getNumParams(
)) ? void (0) : __assert_fail ("P < Prototype->getNumParams()"
, "clang/lib/Sema/SemaCodeComplete.cpp", 3800, __extension__ __PRETTY_FUNCTION__
));
  if (Function || PrototypeLoc) {
    const ParmVarDecl *Param =
        Function ? Function->getParamDecl(P) : PrototypeLoc.getParam(P);
    Placeholder = FormatFunctionParameter(Policy, Param);
    if (Param->hasDefaultArg())
      Placeholder += GetDefaultValueString(Param, Context.getSourceManager(),
                                           Context.getLangOpts());
  } else {
    Placeholder = Prototype->getParamType(P).getAsString(Policy);
  }

  if (P == CurrentArg)
    Result.AddCurrentParameterChunk(
        Result.getAllocator().CopyString(Placeholder));
  else
    Result.AddPlaceholderChunk(Result.getAllocator().CopyString(Placeholder));
}

if (Prototype && Prototype->isVariadic()) {
  CodeCompletionBuilder Opt(Result.getAllocator(),
                            Result.getCodeCompletionTUInfo());
  if (!FirstParameter)
    Opt.AddChunk(CodeCompletionString::CK_Comma);

  if (CurrentArg < NumParams)
    Opt.AddPlaceholderChunk("...");
  else
    Opt.AddCurrentParameterChunk("...");

  Result.AddOptionalChunk(Opt.TakeString());
}
3832}

3834static std::string
3835formatTemplateParameterPlaceholder(const NamedDecl *Param, bool &Optional,
                                 const PrintingPolicy &Policy) {
if (const auto *Type = dyn_cast<TemplateTypeParmDecl>(Param)) {
  Optional = Type->hasDefaultArgument();
} else if (const auto *NonType = dyn_cast<NonTypeTemplateParmDecl>(Param)) {
  Optional = NonType->hasDefaultArgument();
} else if (const auto *Template = dyn_cast<TemplateTemplateParmDecl>(Param)) {
  Optional = Template->hasDefaultArgument();
}
std::string Result;
llvm::raw_string_ostream OS(Result);
Param->print(OS, Policy);
return Result;
3848}

3850static std::string templateResultType(const TemplateDecl *TD,
                                    const PrintingPolicy &Policy) {
if (const auto *CTD = dyn_cast<ClassTemplateDecl>(TD))
  return CTD->getTemplatedDecl()->getKindName().str();
if (const auto *VTD = dyn_cast<VarTemplateDecl>(TD))
  return VTD->getTemplatedDecl()->getType().getAsString(Policy);
if (const auto *FTD = dyn_cast<FunctionTemplateDecl>(TD))
  return FTD->getTemplatedDecl()->getReturnType().getAsString(Policy);
if (isa<TypeAliasTemplateDecl>(TD))
  return "type";
if (isa<TemplateTemplateParmDecl>(TD))
  return "class";
if (isa<ConceptDecl>(TD))
  return "concept";
return "";
3865}

3867static CodeCompletionString *createTemplateSignatureString(
  const TemplateDecl *TD, CodeCompletionBuilder &Builder, unsigned CurrentArg,
  const PrintingPolicy &Policy) {
llvm::ArrayRef<NamedDecl *> Params = TD->getTemplateParameters()->asArray();
CodeCompletionBuilder OptionalBuilder(Builder.getAllocator(),
                                      Builder.getCodeCompletionTUInfo());
std::string ResultType = templateResultType(TD, Policy);
if (!ResultType.empty())
  Builder.AddResultTypeChunk(Builder.getAllocator().CopyString(ResultType));
Builder.AddTextChunk(
    Builder.getAllocator().CopyString(TD->getNameAsString()));
Builder.AddChunk(CodeCompletionString::CK_LeftAngle);
// Initially we're writing into the main string. Once we see an optional arg
// (with default), we're writing into the nested optional chunk.
CodeCompletionBuilder *Current = &Builder;
for (unsigned I = 0; I < Params.size(); ++I) {
  bool Optional = false;
  std::string Placeholder =
      formatTemplateParameterPlaceholder(Params[I], Optional, Policy);
  if (Optional)
    Current = &OptionalBuilder;
  if (I > 0)
    Current->AddChunk(CodeCompletionString::CK_Comma);
  Current->AddChunk(I == CurrentArg
                        ? CodeCompletionString::CK_CurrentParameter
                        : CodeCompletionString::CK_Placeholder,
                    Current->getAllocator().CopyString(Placeholder));
}
// Add the optional chunk to the main string if we ever used it.
if (Current == &OptionalBuilder)
  Builder.AddOptionalChunk(OptionalBuilder.TakeString());
Builder.AddChunk(CodeCompletionString::CK_RightAngle);
// For function templates, ResultType was the function's return type.
// Give some clue this is a function. (Don't show the possibly-bulky params).
if (isa<FunctionTemplateDecl>(TD))
  Builder.AddInformativeChunk("()");
return Builder.TakeString();
3904}

3906CodeCompletionString *
3907CodeCompleteConsumer::OverloadCandidate::CreateSignatureString(
  unsigned CurrentArg, Sema &S, CodeCompletionAllocator &Allocator,
  CodeCompletionTUInfo &CCTUInfo, bool IncludeBriefComments,
  bool Braced) const {
PrintingPolicy Policy = getCompletionPrintingPolicy(S);
// Show signatures of constructors as they are declared:
//   vector(int n) rather than vector<string>(int n)
// This is less noisy without being less clear, and avoids tricky cases.
Policy.SuppressTemplateArgsInCXXConstructors = true;

// FIXME: Set priority, availability appropriately.
CodeCompletionBuilder Result(Allocator, CCTUInfo, 1,
                             CXAvailability_Available);

if (getKind() == CK_Template)
  return createTemplateSignatureString(getTemplate(), Result, CurrentArg,
                                       Policy);

FunctionDecl *FDecl = getFunction();
const FunctionProtoType *Proto =
    dyn_cast_or_null<FunctionProtoType>(getFunctionType());

// First, the name/type of the callee.
if (getKind() == CK_Aggregate) {
  Result.AddTextChunk(
      Result.getAllocator().CopyString(getAggregate()->getName()));
} else if (FDecl) {
  if (IncludeBriefComments) {
    if (auto RC = getParameterComment(S.getASTContext(), *this, CurrentArg))
      Result.addBriefComment(RC->getBriefText(S.getASTContext()));
  }
  AddResultTypeChunk(S.Context, Policy, FDecl, QualType(), Result);

  std::string Name;
  llvm::raw_string_ostream OS(Name);
  FDecl->getDeclName().print(OS, Policy);
  Result.AddTextChunk(Result.getAllocator().CopyString(OS.str()));
} else {
  // Function without a declaration. Just give the return type.
  Result.AddResultTypeChunk(Result.getAllocator().CopyString(
      getFunctionType()->getReturnType().getAsString(Policy)));
}

// Next, the brackets and parameters.
Result.AddChunk(Braced ? CodeCompletionString::CK_LeftBrace
                       : CodeCompletionString::CK_LeftParen);
if (getKind() == CK_Aggregate)
  AddOverloadAggregateChunks(getAggregate(), Policy, Result, CurrentArg);
else
  AddOverloadParameterChunks(S.getASTContext(), Policy, FDecl, Proto,
                             getFunctionProtoTypeLoc(), Result, CurrentArg);
Result.AddChunk(Braced ? CodeCompletionString::CK_RightBrace
                       : CodeCompletionString::CK_RightParen);

return Result.TakeString();
3962}

3964unsigned clang::getMacroUsagePriority(StringRef MacroName,
                                    const LangOptions &LangOpts,
                                    bool PreferredTypeIsPointer) {
unsigned Priority = CCP_Macro;

// Treat the "nil", "Nil" and "NULL" macros as null pointer constants.
if (MacroName.equals("nil") || MacroName.equals("NULL") ||
    MacroName.equals("Nil")) {
  Priority = CCP_Constant;
  if (PreferredTypeIsPointer)
    Priority = Priority / CCF_SimilarTypeMatch;
}
// Treat "YES", "NO", "true", and "false" as constants.
else if (MacroName.equals("YES") || MacroName.equals("NO") ||
         MacroName.equals("true") || MacroName.equals("false"))
  Priority = CCP_Constant;
// Treat "bool" as a type.
else if (MacroName.equals("bool"))
  Priority = CCP_Type + (LangOpts.ObjC ? CCD_bool_in_ObjC : 0);

return Priority;
3985}

3987CXCursorKind clang::getCursorKindForDecl(const Decl *D) {
if (!D)
  return CXCursor_UnexposedDecl;

switch (D->getKind()) {
case Decl::Enum:
  return CXCursor_EnumDecl;
case Decl::EnumConstant:
  return CXCursor_EnumConstantDecl;
case Decl::Field:
  return CXCursor_FieldDecl;
case Decl::Function:
  return CXCursor_FunctionDecl;
case Decl::ObjCCategory:
  return CXCursor_ObjCCategoryDecl;
case Decl::ObjCCategoryImpl:
  return CXCursor_ObjCCategoryImplDecl;
case Decl::ObjCImplementation:
  return CXCursor_ObjCImplementationDecl;

case Decl::ObjCInterface:
  return CXCursor_ObjCInterfaceDecl;
case Decl::ObjCIvar:
  return CXCursor_ObjCIvarDecl;
case Decl::ObjCMethod:
  return cast<ObjCMethodDecl>(D)->isInstanceMethod()
             ? CXCursor_ObjCInstanceMethodDecl
             : CXCursor_ObjCClassMethodDecl;
case Decl::CXXMethod:
  return CXCursor_CXXMethod;
case Decl::CXXConstructor:
  return CXCursor_Constructor;
case Decl::CXXDestructor:
  return CXCursor_Destructor;
case Decl::CXXConversion:
  return CXCursor_ConversionFunction;
case Decl::ObjCProperty:
  return CXCursor_ObjCPropertyDecl;
case Decl::ObjCProtocol:
  return CXCursor_ObjCProtocolDecl;
case Decl::ParmVar:
  return CXCursor_ParmDecl;
case Decl::Typedef:
  return CXCursor_TypedefDecl;
case Decl::TypeAlias:
  return CXCursor_TypeAliasDecl;
case Decl::TypeAliasTemplate:
  return CXCursor_TypeAliasTemplateDecl;
case Decl::Var:
  return CXCursor_VarDecl;
case Decl::Namespace:
  return CXCursor_Namespace;
case Decl::NamespaceAlias:
  return CXCursor_NamespaceAlias;
case Decl::TemplateTypeParm:
  return CXCursor_TemplateTypeParameter;
case Decl::NonTypeTemplateParm:
  return CXCursor_NonTypeTemplateParameter;
case Decl::TemplateTemplateParm:
  return CXCursor_TemplateTemplateParameter;
case Decl::FunctionTemplate:
  return CXCursor_FunctionTemplate;
case Decl::ClassTemplate:
  return CXCursor_ClassTemplate;
case Decl::AccessSpec:
  return CXCursor_CXXAccessSpecifier;
case Decl::ClassTemplatePartialSpecialization:
  return CXCursor_ClassTemplatePartialSpecialization;
case Decl::UsingDirective:
  return CXCursor_UsingDirective;
case Decl::StaticAssert:
  return CXCursor_StaticAssert;
case Decl::Friend:
  return CXCursor_FriendDecl;
case Decl::TranslationUnit:
  return CXCursor_TranslationUnit;

case Decl::Using:
case Decl::UnresolvedUsingValue:
case Decl::UnresolvedUsingTypename:
  return CXCursor_UsingDeclaration;

case Decl::UsingEnum:
  return CXCursor_EnumDecl;

case Decl::ObjCPropertyImpl:
  switch (cast<ObjCPropertyImplDecl>(D)->getPropertyImplementation()) {
  case ObjCPropertyImplDecl::Dynamic:
    return CXCursor_ObjCDynamicDecl;

  case ObjCPropertyImplDecl::Synthesize:
    return CXCursor_ObjCSynthesizeDecl;
  }
  llvm_unreachable("Unexpected Kind!")::llvm::llvm_unreachable_internal("Unexpected Kind!", "clang/lib/Sema/SemaCodeComplete.cpp"
, 4080);

case Decl::Import:
  return CXCursor_ModuleImportDecl;

case Decl::ObjCTypeParam:
  return CXCursor_TemplateTypeParameter;

case Decl::Concept:
  return CXCursor_ConceptDecl;

default:
  if (const auto *TD = dyn_cast<TagDecl>(D)) {
    switch (TD->getTagKind()) {
    case TTK_Interface: // fall through
    case TTK_Struct:
      return CXCursor_StructDecl;
    case TTK_Class:
      return CXCursor_ClassDecl;
    case TTK_Union:
      return CXCursor_UnionDecl;
    case TTK_Enum:
      return CXCursor_EnumDecl;
    }
  }
}

return CXCursor_UnexposedDecl;
4108}

4110static void AddMacroResults(Preprocessor &PP, ResultBuilder &Results,
                          bool LoadExternal, bool IncludeUndefined,
                          bool TargetTypeIsPointer = false) {
typedef CodeCompletionResult Result;

Results.EnterNewScope();

for (Preprocessor::macro_iterator M = PP.macro_begin(LoadExternal),
                                  MEnd = PP.macro_end(LoadExternal);
     M != MEnd; ++M) {
  auto MD = PP.getMacroDefinition(M->first);
  if (IncludeUndefined || MD) {
    MacroInfo *MI = MD.getMacroInfo();
    if (MI && MI->isUsedForHeaderGuard())
      continue;

    Results.AddResult(
        Result(M->first, MI,
               getMacroUsagePriority(M->first->getName(), PP.getLangOpts(),
                                     TargetTypeIsPointer)));
  }
}

Results.ExitScope();
4134}

4136static void AddPrettyFunctionResults(const LangOptions &LangOpts,
                                   ResultBuilder &Results) {
typedef CodeCompletionResult Result;

Results.EnterNewScope();

Results.AddResult(Result("__PRETTY_FUNCTION__", CCP_Constant));
Results.AddResult(Result("__FUNCTION__", CCP_Constant));
if (LangOpts.C99 || LangOpts.CPlusPlus11)
  Results.AddResult(Result("__func__", CCP_Constant));
Results.ExitScope();
4147}

4149static void HandleCodeCompleteResults(Sema *S,
                                    CodeCompleteConsumer *CodeCompleter,
                                    const CodeCompletionContext &Context,
                                    CodeCompletionResult *Results,
                                    unsigned NumResults) {
if (CodeCompleter)
  CodeCompleter->ProcessCodeCompleteResults(*S, Context, Results, NumResults);
4156}

4158static CodeCompletionContext
4159mapCodeCompletionContext(Sema &S, Sema::ParserCompletionContext PCC) {
switch (PCC) {
case Sema::PCC_Namespace:
  return CodeCompletionContext::CCC_TopLevel;

case Sema::PCC_Class:
  return CodeCompletionContext::CCC_ClassStructUnion;

case Sema::PCC_ObjCInterface:
  return CodeCompletionContext::CCC_ObjCInterface;

case Sema::PCC_ObjCImplementation:
  return CodeCompletionContext::CCC_ObjCImplementation;

case Sema::PCC_ObjCInstanceVariableList:
  return CodeCompletionContext::CCC_ObjCIvarList;

case Sema::PCC_Template:
case Sema::PCC_MemberTemplate:
  if (S.CurContext->isFileContext())
    return CodeCompletionContext::CCC_TopLevel;
  if (S.CurContext->isRecord())
    return CodeCompletionContext::CCC_ClassStructUnion;
  return CodeCompletionContext::CCC_Other;

case Sema::PCC_RecoveryInFunction:
  return CodeCompletionContext::CCC_Recovery;

case Sema::PCC_ForInit:
  if (S.getLangOpts().CPlusPlus || S.getLangOpts().C99 ||
      S.getLangOpts().ObjC)
    return CodeCompletionContext::CCC_ParenthesizedExpression;
  else
    return CodeCompletionContext::CCC_Expression;

case Sema::PCC_Expression:
  return CodeCompletionContext::CCC_Expression;
case Sema::PCC_Condition:
  return CodeCompletionContext(CodeCompletionContext::CCC_Expression,
                               S.getASTContext().BoolTy);

case Sema::PCC_Statement:
  return CodeCompletionContext::CCC_Statement;

case Sema::PCC_Type:
  return CodeCompletionContext::CCC_Type;

case Sema::PCC_ParenthesizedExpression:
  return CodeCompletionContext::CCC_ParenthesizedExpression;

case Sema::PCC_LocalDeclarationSpecifiers:
  return CodeCompletionContext::CCC_Type;
}

llvm_unreachable("Invalid ParserCompletionContext!")::llvm::llvm_unreachable_internal("Invalid ParserCompletionContext!"
, "clang/lib/Sema/SemaCodeComplete.cpp", 4213);
4214}

4216/// If we're in a C++ virtual member function, add completion results
4217/// that invoke the functions we override, since it's common to invoke the
4218/// overridden function as well as adding new functionality.
4219///
4220/// \param S The semantic analysis object for which we are generating results.
4221///
4222/// \param InContext This context in which the nested-name-specifier preceding
4223/// the code-completion point
4224static void MaybeAddOverrideCalls(Sema &S, DeclContext *InContext,
                                ResultBuilder &Results) {
// Look through blocks.
DeclContext *CurContext = S.CurContext;
while (isa<BlockDecl>(CurContext))
  CurContext = CurContext->getParent();

CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(CurContext);
if (!Method || !Method->isVirtual())
  return;

// We need to have names for all of the parameters, if we're going to
// generate a forwarding call.
for (auto *P : Method->parameters())
  if (!P->getDeclName())
    return;

PrintingPolicy Policy = getCompletionPrintingPolicy(S);
for (const CXXMethodDecl *Overridden : Method->overridden_methods()) {
  CodeCompletionBuilder Builder(Results.getAllocator(),
                                Results.getCodeCompletionTUInfo());
  if (Overridden->getCanonicalDecl() == Method->getCanonicalDecl())
    continue;

  // If we need a nested-name-specifier, add one now.
  if (!InContext) {
    NestedNameSpecifier *NNS = getRequiredQualification(
        S.Context, CurContext, Overridden->getDeclContext());
    if (NNS) {
      std::string Str;
      llvm::raw_string_ostream OS(Str);
      NNS->print(OS, Policy);
      Builder.AddTextChunk(Results.getAllocator().CopyString(OS.str()));
    }
  } else if (!InContext->Equals(Overridden->getDeclContext()))
    continue;

  Builder.AddTypedTextChunk(
      Results.getAllocator().CopyString(Overridden->getNameAsString()));
  Builder.AddChunk(CodeCompletionString::CK_LeftParen);
  bool FirstParam = true;
  for (auto *P : Method->parameters()) {
    if (FirstParam)
      FirstParam = false;
    else
      Builder.AddChunk(CodeCompletionString::CK_Comma);

    Builder.AddPlaceholderChunk(
        Results.getAllocator().CopyString(P->getIdentifier()->getName()));
  }
  Builder.AddChunk(CodeCompletionString::CK_RightParen);
  Results.AddResult(CodeCompletionResult(
      Builder.TakeString(), CCP_SuperCompletion, CXCursor_CXXMethod,
      CXAvailability_Available, Overridden));
  Results.Ignore(Overridden);
}
4280}

4282void Sema::CodeCompleteModuleImport(SourceLocation ImportLoc,
                                  ModuleIdPath Path) {
typedef CodeCompletionResult Result;
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();

CodeCompletionAllocator &Allocator = Results.getAllocator();
CodeCompletionBuilder Builder(Allocator, Results.getCodeCompletionTUInfo());
typedef CodeCompletionResult Result;
if (Path.empty()) {
  // Enumerate all top-level modules.
  SmallVector<Module *, 8> Modules;
  PP.getHeaderSearchInfo().collectAllModules(Modules);
  for (unsigned I = 0, N = Modules.size(); I != N; ++I) {
    Builder.AddTypedTextChunk(
        Builder.getAllocator().CopyString(Modules[I]->Name));
    Results.AddResult(Result(
        Builder.TakeString(), CCP_Declaration, CXCursor_ModuleImportDecl,
        Modules[I]->isAvailable() ? CXAvailability_Available
                                  : CXAvailability_NotAvailable));
  }
} else if (getLangOpts().Modules) {
  // Load the named module.
  Module *Mod =
      PP.getModuleLoader().loadModule(ImportLoc, Path, Module::AllVisible,
                                      /*IsInclusionDirective=*/false);
  // Enumerate submodules.
  if (Mod) {
    for (auto *Submodule : Mod->submodules()) {
      Builder.AddTypedTextChunk(
          Builder.getAllocator().CopyString(Submodule->Name));
      Results.AddResult(Result(
          Builder.TakeString(), CCP_Declaration, CXCursor_ModuleImportDecl,
          Submodule->isAvailable() ? CXAvailability_Available
                                   : CXAvailability_NotAvailable));
    }
  }
}
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
4325}

4327void Sema::CodeCompleteOrdinaryName(Scope *S,
                                  ParserCompletionContext CompletionContext) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      mapCodeCompletionContext(*this, CompletionContext));
Results.EnterNewScope();

// Determine how to filter results, e.g., so that the names of
// values (functions, enumerators, function templates, etc.) are
// only allowed where we can have an expression.
switch (CompletionContext) {
case PCC_Namespace:
case PCC_Class:
case PCC_ObjCInterface:
case PCC_ObjCImplementation:
case PCC_ObjCInstanceVariableList:
case PCC_Template:
case PCC_MemberTemplate:
case PCC_Type:
case PCC_LocalDeclarationSpecifiers:
  Results.setFilter(&ResultBuilder::IsOrdinaryNonValueName);
  break;

case PCC_Statement:
case PCC_ParenthesizedExpression:
case PCC_Expression:
case PCC_ForInit:
case PCC_Condition:
  if (WantTypesInContext(CompletionContext, getLangOpts()))
    Results.setFilter(&ResultBuilder::IsOrdinaryName);
  else
    Results.setFilter(&ResultBuilder::IsOrdinaryNonTypeName);

  if (getLangOpts().CPlusPlus)
    MaybeAddOverrideCalls(*this, /*InContext=*/nullptr, Results);
  break;

case PCC_RecoveryInFunction:
  // Unfiltered
  break;
}

// If we are in a C++ non-static member function, check the qualifiers on
// the member function to filter/prioritize the results list.
auto ThisType = getCurrentThisType();
if (!ThisType.isNull())
  Results.setObjectTypeQualifiers(ThisType->getPointeeType().getQualifiers(),
                                  VK_LValue);

CodeCompletionDeclConsumer Consumer(Results, CurContext);
LookupVisibleDecls(S, LookupOrdinaryName, Consumer,
                   CodeCompleter->includeGlobals(),
                   CodeCompleter->loadExternal());

AddOrdinaryNameResults(CompletionContext, S, *this, Results);
Results.ExitScope();

switch (CompletionContext) {
case PCC_ParenthesizedExpression:
case PCC_Expression:
case PCC_Statement:
case PCC_RecoveryInFunction:
  if (S->getFnParent())
    AddPrettyFunctionResults(getLangOpts(), Results);
  break;

case PCC_Namespace:
case PCC_Class:
case PCC_ObjCInterface:
case PCC_ObjCImplementation:
case PCC_ObjCInstanceVariableList:
case PCC_Template:
case PCC_MemberTemplate:
case PCC_ForInit:
case PCC_Condition:
case PCC_Type:
case PCC_LocalDeclarationSpecifiers:
  break;
}

if (CodeCompleter->includeMacros())
  AddMacroResults(PP, Results, CodeCompleter->loadExternal(), false);

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
4412}

4414static void AddClassMessageCompletions(Sema &SemaRef, Scope *S,
                                     ParsedType Receiver,
                                     ArrayRef<IdentifierInfo *> SelIdents,
                                     bool AtArgumentExpression, bool IsSuper,
                                     ResultBuilder &Results);

4420void Sema::CodeCompleteDeclSpec(Scope *S, DeclSpec &DS,
                              bool AllowNonIdentifiers,
                              bool AllowNestedNameSpecifiers) {
typedef CodeCompletionResult Result;
ResultBuilder Results(
    *this, CodeCompleter->getAllocator(),
    CodeCompleter->getCodeCompletionTUInfo(),
    AllowNestedNameSpecifiers
        // FIXME: Try to separate codepath leading here to deduce whether we
        // need an existing symbol or a new one.
        ? CodeCompletionContext::CCC_SymbolOrNewName
        : CodeCompletionContext::CCC_NewName);
Results.EnterNewScope();

// Type qualifiers can come after names.
Results.AddResult(Result("const"));
Results.AddResult(Result("volatile"));
if (getLangOpts().C99)
  Results.AddResult(Result("restrict"));

if (getLangOpts().CPlusPlus) {
  if (getLangOpts().CPlusPlus11 &&
      (DS.getTypeSpecType() == DeclSpec::TST_class ||
       DS.getTypeSpecType() == DeclSpec::TST_struct))
    Results.AddResult("final");

  if (AllowNonIdentifiers) {
    Results.AddResult(Result("operator"));
  }

  // Add nested-name-specifiers.
  if (AllowNestedNameSpecifiers) {
    Results.allowNestedNameSpecifiers();
    Results.setFilter(&ResultBuilder::IsImpossibleToSatisfy);
    CodeCompletionDeclConsumer Consumer(Results, CurContext);
    LookupVisibleDecls(S, LookupNestedNameSpecifierName, Consumer,
                       CodeCompleter->includeGlobals(),
                       CodeCompleter->loadExternal());
    Results.setFilter(nullptr);
  }
}
Results.ExitScope();

// If we're in a context where we might have an expression (rather than a
// declaration), and what we've seen so far is an Objective-C type that could
// be a receiver of a class message, this may be a class message send with
// the initial opening bracket '[' missing. Add appropriate completions.
if (AllowNonIdentifiers && !AllowNestedNameSpecifiers &&
    DS.getParsedSpecifiers() == DeclSpec::PQ_TypeSpecifier &&
    DS.getTypeSpecType() == DeclSpec::TST_typename &&
    DS.getTypeSpecComplex() == DeclSpec::TSC_unspecified &&
    DS.getTypeSpecSign() == TypeSpecifierSign::Unspecified &&
    !DS.isTypeAltiVecVector() && S &&
    (S->getFlags() & Scope::DeclScope) != 0 &&
    (S->getFlags() & (Scope::ClassScope | Scope::TemplateParamScope |
                      Scope::FunctionPrototypeScope | Scope::AtCatchScope)) ==
        0) {
  ParsedType T = DS.getRepAsType();
  if (!T.get().isNull() && T.get()->isObjCObjectOrInterfaceType())
    AddClassMessageCompletions(*this, S, T, std::nullopt, false, false,
                               Results);
}

// Note that we intentionally suppress macro results here, since we do not
// encourage using macros to produce the names of entities.

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
4488}

4490static const char *underscoreAttrScope(llvm::StringRef Scope) {
if (Scope == "clang")
  return "_Clang";
if (Scope == "gnu")
  return "__gnu__";
return nullptr;
4496}

4498static const char *noUnderscoreAttrScope(llvm::StringRef Scope) {
if (Scope == "_Clang")
  return "clang";
if (Scope == "__gnu__")
  return "gnu";
return nullptr;
4504}

4506void Sema::CodeCompleteAttribute(AttributeCommonInfo::Syntax Syntax,
                               AttributeCompletion Completion,
                               const IdentifierInfo *InScope) {
if (Completion == AttributeCompletion::None)
  return;
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Attribute);

// We're going to iterate over the normalized spellings of the attribute.
// These don't include "underscore guarding": the normalized spelling is
// clang::foo but you can also write _Clang::__foo__.
//
// (Clang supports a mix like clang::__foo__ but we won't suggest it: either
// you care about clashing with macros or you don't).
//
// So if we're already in a scope, we determine its canonical spellings
// (for comparison with normalized attr spelling) and remember whether it was
// underscore-guarded (so we know how to spell contained attributes).
llvm::StringRef InScopeName;
bool InScopeUnderscore = false;
if (InScope) {
  InScopeName = InScope->getName();
  if (const char *NoUnderscore = noUnderscoreAttrScope(InScopeName)) {
    InScopeName = NoUnderscore;
    InScopeUnderscore = true;
  }
}
bool SyntaxSupportsGuards = Syntax == AttributeCommonInfo::AS_GNU ||
                            Syntax == AttributeCommonInfo::AS_CXX11 ||
                            Syntax == AttributeCommonInfo::AS_C2x;

llvm::DenseSet<llvm::StringRef> FoundScopes;
auto AddCompletions = [&](const ParsedAttrInfo &A) {
  if (A.IsTargetSpecific && !A.existsInTarget(Context.getTargetInfo()))
    return;
  if (!A.acceptsLangOpts(getLangOpts()))
    return;
  for (const auto &S : A.Spellings) {
    if (S.Syntax != Syntax)
      continue;
    llvm::StringRef Name = S.NormalizedFullName;
    llvm::StringRef Scope;
    if ((Syntax == AttributeCommonInfo::AS_CXX11 ||
         Syntax == AttributeCommonInfo::AS_C2x)) {
      std::tie(Scope, Name) = Name.split("::");
      if (Name.empty()) // oops, unscoped
        std::swap(Name, Scope);
    }

    // Do we just want a list of scopes rather than attributes?
    if (Completion == AttributeCompletion::Scope) {
      // Make sure to emit each scope only once.
      if (!Scope.empty() && FoundScopes.insert(Scope).second) {
        Results.AddResult(
            CodeCompletionResult(Results.getAllocator().CopyString(Scope)));
        // Include alternate form (__gnu__ instead of gnu).
        if (const char *Scope2 = underscoreAttrScope(Scope))
          Results.AddResult(CodeCompletionResult(Scope2));
      }
      continue;
    }

    // If a scope was specified, it must match but we don't need to print it.
    if (!InScopeName.empty()) {
      if (Scope != InScopeName)
        continue;
      Scope = "";
    }

    auto Add = [&](llvm::StringRef Scope, llvm::StringRef Name,
                   bool Underscores) {
      CodeCompletionBuilder Builder(Results.getAllocator(),
                                    Results.getCodeCompletionTUInfo());
      llvm::SmallString<32> Text;
      if (!Scope.empty()) {
        Text.append(Scope);
        Text.append("::");
      }
      if (Underscores)
        Text.append("__");
      Text.append(Name);
      if (Underscores)
        Text.append("__");
      Builder.AddTypedTextChunk(Results.getAllocator().CopyString(Text));

      if (!A.ArgNames.empty()) {
        Builder.AddChunk(CodeCompletionString::CK_LeftParen, "(");
        bool First = true;
        for (const char *Arg : A.ArgNames) {
          if (!First)
            Builder.AddChunk(CodeCompletionString::CK_Comma, ", ");
          First = false;
          Builder.AddPlaceholderChunk(Arg);
        }
        Builder.AddChunk(CodeCompletionString::CK_RightParen, ")");
      }

      Results.AddResult(Builder.TakeString());
    };

    // Generate the non-underscore-guarded result.
    // Note this is (a suffix of) the NormalizedFullName, no need to copy.
    // If an underscore-guarded scope was specified, only the
    // underscore-guarded attribute name is relevant.
    if (!InScopeUnderscore)
      Add(Scope, Name, /*Underscores=*/false);

    // Generate the underscore-guarded version, for syntaxes that support it.
    // We skip this if the scope was already spelled and not guarded, or
    // we must spell it and can't guard it.
    if (!(InScope && !InScopeUnderscore) && SyntaxSupportsGuards) {
      llvm::SmallString<32> Guarded;
      if (Scope.empty()) {
        Add(Scope, Name, /*Underscores=*/true);
      } else {
        const char *GuardedScope = underscoreAttrScope(Scope);
        if (!GuardedScope)
          continue;
        Add(GuardedScope, Name, /*Underscores=*/true);
      }
    }

    // It may be nice to include the Kind so we can look up the docs later.
  }
};

for (const auto *A : ParsedAttrInfo::getAllBuiltin())
  AddCompletions(*A);
for (const auto &Entry : ParsedAttrInfoRegistry::entries())
  AddCompletions(*Entry.instantiate());

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
4640}

4642struct Sema::CodeCompleteExpressionData {
CodeCompleteExpressionData(QualType PreferredType = QualType(),
                           bool IsParenthesized = false)
    : PreferredType(PreferredType), IntegralConstantExpression(false),
      ObjCCollection(false), IsParenthesized(IsParenthesized) {}

QualType PreferredType;
bool IntegralConstantExpression;
bool ObjCCollection;
bool IsParenthesized;
SmallVector<Decl *, 4> IgnoreDecls;
4653};

4655namespace {
4656/// Information that allows to avoid completing redundant enumerators.
4657struct CoveredEnumerators {
llvm::SmallPtrSet<EnumConstantDecl *, 8> Seen;
NestedNameSpecifier *SuggestedQualifier = nullptr;
4660};
4661} // namespace

4663static void AddEnumerators(ResultBuilder &Results, ASTContext &Context,
                         EnumDecl *Enum, DeclContext *CurContext,
                         const CoveredEnumerators &Enumerators) {
NestedNameSpecifier *Qualifier = Enumerators.SuggestedQualifier;
if (Context.getLangOpts().CPlusPlus && !Qualifier && Enumerators.Seen.empty()) {
  // If there are no prior enumerators in C++, check whether we have to
  // qualify the names of the enumerators that we suggest, because they
  // may not be visible in this scope.
  Qualifier = getRequiredQualification(Context, CurContext, Enum);
}

Results.EnterNewScope();
for (auto *E : Enum->enumerators()) {
  if (Enumerators.Seen.count(E))
    continue;

  CodeCompletionResult R(E, CCP_EnumInCase, Qualifier);
  Results.AddResult(R, CurContext, nullptr, false);
}
Results.ExitScope();
4683}

4685/// Try to find a corresponding FunctionProtoType for function-like types (e.g.
4686/// function pointers, std::function, etc).
4687static const FunctionProtoType *TryDeconstructFunctionLike(QualType T) {
assert(!T.isNull())(static_cast <bool> (!T.isNull()) ? void (0) : __assert_fail
 ("!T.isNull()", "clang/lib/Sema/SemaCodeComplete.cpp", 4688,
 __extension__ __PRETTY_FUNCTION__));
// Try to extract first template argument from std::function<> and similar.
// Note we only handle the sugared types, they closely match what users wrote.
// We explicitly choose to not handle ClassTemplateSpecializationDecl.
if (auto *Specialization = T->getAs<TemplateSpecializationType>()) {
  if (Specialization->template_arguments().size() != 1)
    return nullptr;
  const TemplateArgument &Argument = Specialization->template_arguments()[0];
  if (Argument.getKind() != TemplateArgument::Type)
    return nullptr;
  return Argument.getAsType()->getAs<FunctionProtoType>();
}
// Handle other cases.
if (T->isPointerType())
  T = T->getPointeeType();
return T->getAs<FunctionProtoType>();
4704}

4706/// Adds a pattern completion for a lambda expression with the specified
4707/// parameter types and placeholders for parameter names.
4708static void AddLambdaCompletion(ResultBuilder &Results,
                              llvm::ArrayRef<QualType> Parameters,
                              const LangOptions &LangOpts) {
if (!Results.includeCodePatterns())
  return;
CodeCompletionBuilder Completion(Results.getAllocator(),
                                 Results.getCodeCompletionTUInfo());
// [](<parameters>) {}
Completion.AddChunk(CodeCompletionString::CK_LeftBracket);
Completion.AddPlaceholderChunk("=");
Completion.AddChunk(CodeCompletionString::CK_RightBracket);
if (!Parameters.empty()) {
  Completion.AddChunk(CodeCompletionString::CK_LeftParen);
  bool First = true;
  for (auto Parameter : Parameters) {
    if (!First)
      Completion.AddChunk(CodeCompletionString::ChunkKind::CK_Comma);
    else
      First = false;

    constexpr llvm::StringLiteral NamePlaceholder = "!#!NAME_GOES_HERE!#!";
    std::string Type = std::string(NamePlaceholder);
    Parameter.getAsStringInternal(Type, PrintingPolicy(LangOpts));
    llvm::StringRef Prefix, Suffix;
    std::tie(Prefix, Suffix) = llvm::StringRef(Type).split(NamePlaceholder);
    Prefix = Prefix.rtrim();
    Suffix = Suffix.ltrim();

    Completion.AddTextChunk(Completion.getAllocator().CopyString(Prefix));
    Completion.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Completion.AddPlaceholderChunk("parameter");
    Completion.AddTextChunk(Completion.getAllocator().CopyString(Suffix));
  };
  Completion.AddChunk(CodeCompletionString::CK_RightParen);
}
Completion.AddChunk(clang::CodeCompletionString::CK_HorizontalSpace);
Completion.AddChunk(CodeCompletionString::CK_LeftBrace);
Completion.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Completion.AddPlaceholderChunk("body");
Completion.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Completion.AddChunk(CodeCompletionString::CK_RightBrace);

Results.AddResult(Completion.TakeString());
4751}

4753/// Perform code-completion in an expression context when we know what
4754/// type we're looking for.
4755void Sema::CodeCompleteExpression(Scope *S,
                                const CodeCompleteExpressionData &Data) {
ResultBuilder Results(
    *this, CodeCompleter->getAllocator(),
    CodeCompleter->getCodeCompletionTUInfo(),
    CodeCompletionContext(
        Data.IsParenthesized
            ? CodeCompletionContext::CCC_ParenthesizedExpression
            : CodeCompletionContext::CCC_Expression,
        Data.PreferredType));
auto PCC =
    Data.IsParenthesized ? PCC_ParenthesizedExpression : PCC_Expression;
if (Data.ObjCCollection)
  Results.setFilter(&ResultBuilder::IsObjCCollection);
else if (Data.IntegralConstantExpression)
  Results.setFilter(&ResultBuilder::IsIntegralConstantValue);
else if (WantTypesInContext(PCC, getLangOpts()))
  Results.setFilter(&ResultBuilder::IsOrdinaryName);
else
  Results.setFilter(&ResultBuilder::IsOrdinaryNonTypeName);

if (!Data.PreferredType.isNull())
  Results.setPreferredType(Data.PreferredType.getNonReferenceType());

// Ignore any declarations that we were told that we don't care about.
for (unsigned I = 0, N = Data.IgnoreDecls.size(); I != N; ++I)
  Results.Ignore(Data.IgnoreDecls[I]);

CodeCompletionDeclConsumer Consumer(Results, CurContext);
LookupVisibleDecls(S, LookupOrdinaryName, Consumer,
                   CodeCompleter->includeGlobals(),
                   CodeCompleter->loadExternal());

Results.EnterNewScope();
AddOrdinaryNameResults(PCC, S, *this, Results);
Results.ExitScope();

bool PreferredTypeIsPointer = false;
if (!Data.PreferredType.isNull()) {
  PreferredTypeIsPointer = Data.PreferredType->isAnyPointerType() ||
                           Data.PreferredType->isMemberPointerType() ||
                           Data.PreferredType->isBlockPointerType();
  if (Data.PreferredType->isEnumeralType()) {
    EnumDecl *Enum = Data.PreferredType->castAs<EnumType>()->getDecl();
    if (auto *Def = Enum->getDefinition())
      Enum = Def;
    // FIXME: collect covered enumerators in cases like:
    //        if (x == my_enum::one) { ... } else if (x == ^) {}
    AddEnumerators(Results, Context, Enum, CurContext, CoveredEnumerators());
  }
}

if (S->getFnParent() && !Data.ObjCCollection &&
    !Data.IntegralConstantExpression)
  AddPrettyFunctionResults(getLangOpts(), Results);

if (CodeCompleter->includeMacros())
  AddMacroResults(PP, Results, CodeCompleter->loadExternal(), false,
                  PreferredTypeIsPointer);

// Complete a lambda expression when preferred type is a function.
if (!Data.PreferredType.isNull() && getLangOpts().CPlusPlus11) {
  if (const FunctionProtoType *F =
          TryDeconstructFunctionLike(Data.PreferredType))
    AddLambdaCompletion(Results, F->getParamTypes(), getLangOpts());
}

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
4824}

4826void Sema::CodeCompleteExpression(Scope *S, QualType PreferredType,
                                bool IsParenthesized) {
return CodeCompleteExpression(
    S, CodeCompleteExpressionData(PreferredType, IsParenthesized));
4830}

4832void Sema::CodeCompletePostfixExpression(Scope *S, ExprResult E,
                                       QualType PreferredType) {
if (E.isInvalid())
  CodeCompleteExpression(S, PreferredType);
else if (getLangOpts().ObjC)
  CodeCompleteObjCInstanceMessage(S, E.get(), std::nullopt, false);
4838}

4840/// The set of properties that have already been added, referenced by
4841/// property name.
4842typedef llvm::SmallPtrSet<IdentifierInfo *, 16> AddedPropertiesSet;

4844/// Retrieve the container definition, if any?
4845static ObjCContainerDecl *getContainerDef(ObjCContainerDecl *Container) {
if (ObjCInterfaceDecl *Interface = dyn_cast<ObjCInterfaceDecl>(Container)) {
  if (Interface->hasDefinition())
    return Interface->getDefinition();

  return Interface;
}

if (ObjCProtocolDecl *Protocol = dyn_cast<ObjCProtocolDecl>(Container)) {
  if (Protocol->hasDefinition())
    return Protocol->getDefinition();

  return Protocol;
}
return Container;
4860}

4862/// Adds a block invocation code completion result for the given block
4863/// declaration \p BD.
4864static void AddObjCBlockCall(ASTContext &Context, const PrintingPolicy &Policy,
                           CodeCompletionBuilder &Builder,
                           const NamedDecl *BD,
                           const FunctionTypeLoc &BlockLoc,
                           const FunctionProtoTypeLoc &BlockProtoLoc) {
Builder.AddResultTypeChunk(
    GetCompletionTypeString(BlockLoc.getReturnLoc().getType(), Context,
                            Policy, Builder.getAllocator()));

AddTypedNameChunk(Context, Policy, BD, Builder);
Builder.AddChunk(CodeCompletionString::CK_LeftParen);

if (BlockProtoLoc && BlockProtoLoc.getTypePtr()->isVariadic()) {
  Builder.AddPlaceholderChunk("...");
} else {
  for (unsigned I = 0, N = BlockLoc.getNumParams(); I != N; ++I) {
    if (I)
      Builder.AddChunk(CodeCompletionString::CK_Comma);

    // Format the placeholder string.
    std::string PlaceholderStr =
        FormatFunctionParameter(Policy, BlockLoc.getParam(I));

    if (I == N - 1 && BlockProtoLoc &&
        BlockProtoLoc.getTypePtr()->isVariadic())
      PlaceholderStr += ", ...";

    // Add the placeholder string.
    Builder.AddPlaceholderChunk(
        Builder.getAllocator().CopyString(PlaceholderStr));
  }
}

Builder.AddChunk(CodeCompletionString::CK_RightParen);
4898}

4900static void
4901AddObjCProperties(const CodeCompletionContext &CCContext,
                ObjCContainerDecl *Container, bool AllowCategories,
                bool AllowNullaryMethods, DeclContext *CurContext,
                AddedPropertiesSet &AddedProperties, ResultBuilder &Results,
                bool IsBaseExprStatement = false,
                bool IsClassProperty = false, bool InOriginalClass = true) {
typedef CodeCompletionResult Result;

// Retrieve the definition.
Container = getContainerDef(Container);

// Add properties in this container.
const auto AddProperty = [&](const ObjCPropertyDecl *P) {
  if (!AddedProperties.insert(P->getIdentifier()).second)
    return;

  // FIXME: Provide block invocation completion for non-statement
  // expressions.
  if (!P->getType().getTypePtr()->isBlockPointerType() ||
      !IsBaseExprStatement) {
    Result R = Result(P, Results.getBasePriority(P), nullptr);
    if (!InOriginalClass)
      setInBaseClass(R);
    Results.MaybeAddResult(R, CurContext);
    return;
  }

  // Block setter and invocation completion is provided only when we are able
  // to find the FunctionProtoTypeLoc with parameter names for the block.
  FunctionTypeLoc BlockLoc;
  FunctionProtoTypeLoc BlockProtoLoc;
  findTypeLocationForBlockDecl(P->getTypeSourceInfo(), BlockLoc,
                               BlockProtoLoc);
  if (!BlockLoc) {
    Result R = Result(P, Results.getBasePriority(P), nullptr);
    if (!InOriginalClass)
      setInBaseClass(R);
    Results.MaybeAddResult(R, CurContext);
    return;
  }

  // The default completion result for block properties should be the block
  // invocation completion when the base expression is a statement.
  CodeCompletionBuilder Builder(Results.getAllocator(),
                                Results.getCodeCompletionTUInfo());
  AddObjCBlockCall(Container->getASTContext(),
                   getCompletionPrintingPolicy(Results.getSema()), Builder, P,
                   BlockLoc, BlockProtoLoc);
  Result R = Result(Builder.TakeString(), P, Results.getBasePriority(P));
  if (!InOriginalClass)
    setInBaseClass(R);
  Results.MaybeAddResult(R, CurContext);

  // Provide additional block setter completion iff the base expression is a
  // statement and the block property is mutable.
  if (!P->isReadOnly()) {
    CodeCompletionBuilder Builder(Results.getAllocator(),
                                  Results.getCodeCompletionTUInfo());
    AddResultTypeChunk(Container->getASTContext(),
                       getCompletionPrintingPolicy(Results.getSema()), P,
                       CCContext.getBaseType(), Builder);
    Builder.AddTypedTextChunk(
        Results.getAllocator().CopyString(P->getName()));
    Builder.AddChunk(CodeCompletionString::CK_Equal);

    std::string PlaceholderStr = formatBlockPlaceholder(
        getCompletionPrintingPolicy(Results.getSema()), P, BlockLoc,
        BlockProtoLoc, /*SuppressBlockName=*/true);
    // Add the placeholder string.
    Builder.AddPlaceholderChunk(
        Builder.getAllocator().CopyString(PlaceholderStr));

    // When completing blocks properties that return void the default
    // property completion result should show up before the setter,
    // otherwise the setter completion should show up before the default
    // property completion, as we normally want to use the result of the
    // call.
    Result R =
        Result(Builder.TakeString(), P,
               Results.getBasePriority(P) +
                   (BlockLoc.getTypePtr()->getReturnType()->isVoidType()
                        ? CCD_BlockPropertySetter
                        : -CCD_BlockPropertySetter));
    if (!InOriginalClass)
      setInBaseClass(R);
    Results.MaybeAddResult(R, CurContext);
  }
};

if (IsClassProperty) {
  for (const auto *P : Container->class_properties())
    AddProperty(P);
} else {
  for (const auto *P : Container->instance_properties())
    AddProperty(P);
}

// Add nullary methods or implicit class properties
if (AllowNullaryMethods) {
  ASTContext &Context = Container->getASTContext();
  PrintingPolicy Policy = getCompletionPrintingPolicy(Results.getSema());
  // Adds a method result
  const auto AddMethod = [&](const ObjCMethodDecl *M) {
    IdentifierInfo *Name = M->getSelector().getIdentifierInfoForSlot(0);
    if (!Name)
      return;
    if (!AddedProperties.insert(Name).second)
      return;
    CodeCompletionBuilder Builder(Results.getAllocator(),
                                  Results.getCodeCompletionTUInfo());
    AddResultTypeChunk(Context, Policy, M, CCContext.getBaseType(), Builder);
    Builder.AddTypedTextChunk(
        Results.getAllocator().CopyString(Name->getName()));
    Result R = Result(Builder.TakeString(), M,
                      CCP_MemberDeclaration + CCD_MethodAsProperty);
    if (!InOriginalClass)
      setInBaseClass(R);
    Results.MaybeAddResult(R, CurContext);
  };

  if (IsClassProperty) {
    for (const auto *M : Container->methods()) {
      // Gather the class method that can be used as implicit property
      // getters. Methods with arguments or methods that return void aren't
      // added to the results as they can't be used as a getter.
      if (!M->getSelector().isUnarySelector() ||
          M->getReturnType()->isVoidType() || M->isInstanceMethod())
        continue;
      AddMethod(M);
    }
  } else {
    for (auto *M : Container->methods()) {
      if (M->getSelector().isUnarySelector())
        AddMethod(M);
    }
  }
}

// Add properties in referenced protocols.
if (ObjCProtocolDecl *Protocol = dyn_cast<ObjCProtocolDecl>(Container)) {
  for (auto *P : Protocol->protocols())
    AddObjCProperties(CCContext, P, AllowCategories, AllowNullaryMethods,
                      CurContext, AddedProperties, Results,
                      IsBaseExprStatement, IsClassProperty,
                      /*InOriginalClass*/ false);
} else if (ObjCInterfaceDecl *IFace =
               dyn_cast<ObjCInterfaceDecl>(Container)) {
  if (AllowCategories) {
    // Look through categories.
    for (auto *Cat : IFace->known_categories())
      AddObjCProperties(CCContext, Cat, AllowCategories, AllowNullaryMethods,
                        CurContext, AddedProperties, Results,
                        IsBaseExprStatement, IsClassProperty,
                        InOriginalClass);
  }

  // Look through protocols.
  for (auto *I : IFace->all_referenced_protocols())
    AddObjCProperties(CCContext, I, AllowCategories, AllowNullaryMethods,
                      CurContext, AddedProperties, Results,
                      IsBaseExprStatement, IsClassProperty,
                      /*InOriginalClass*/ false);

  // Look in the superclass.
  if (IFace->getSuperClass())
    AddObjCProperties(CCContext, IFace->getSuperClass(), AllowCategories,
                      AllowNullaryMethods, CurContext, AddedProperties,
                      Results, IsBaseExprStatement, IsClassProperty,
                      /*InOriginalClass*/ false);
} else if (const auto *Category =
               dyn_cast<ObjCCategoryDecl>(Container)) {
  // Look through protocols.
  for (auto *P : Category->protocols())
    AddObjCProperties(CCContext, P, AllowCategories, AllowNullaryMethods,
                      CurContext, AddedProperties, Results,
                      IsBaseExprStatement, IsClassProperty,
                      /*InOriginalClass*/ false);
}
5079}

5081static void
5082AddRecordMembersCompletionResults(Sema &SemaRef, ResultBuilder &Results,
                                Scope *S, QualType BaseType,
                                ExprValueKind BaseKind, RecordDecl *RD,
                                std::optional<FixItHint> AccessOpFixIt) {
// Indicate that we are performing a member access, and the cv-qualifiers
// for the base object type.
Results.setObjectTypeQualifiers(BaseType.getQualifiers(), BaseKind);

// Access to a C/C++ class, struct, or union.
Results.allowNestedNameSpecifiers();
std::vector<FixItHint> FixIts;
if (AccessOpFixIt)
  FixIts.emplace_back(*AccessOpFixIt);
CodeCompletionDeclConsumer Consumer(Results, RD, BaseType, std::move(FixIts));
SemaRef.LookupVisibleDecls(RD, Sema::LookupMemberName, Consumer,
                           SemaRef.CodeCompleter->includeGlobals(),
                           /*IncludeDependentBases=*/true,
                           SemaRef.CodeCompleter->loadExternal());

if (SemaRef.getLangOpts().CPlusPlus) {
  if (!Results.empty()) {
    // The "template" keyword can follow "->" or "." in the grammar.
    // However, we only want to suggest the template keyword if something
    // is dependent.
    bool IsDependent = BaseType->isDependentType();
    if (!IsDependent) {
      for (Scope *DepScope = S; DepScope; DepScope = DepScope->getParent())
        if (DeclContext *Ctx = DepScope->getEntity()) {
          IsDependent = Ctx->isDependentContext();
          break;
        }
    }

    if (IsDependent)
      Results.AddResult(CodeCompletionResult("template"));
  }
}
5119}

5121// Returns the RecordDecl inside the BaseType, falling back to primary template
5122// in case of specializations. Since we might not have a decl for the
5123// instantiation/specialization yet, e.g. dependent code.
5124static RecordDecl *getAsRecordDecl(QualType BaseType) {
BaseType = BaseType.getNonReferenceType();
if (auto *RD = BaseType->getAsRecordDecl()) {
  if (const auto *CTSD =
          llvm::dyn_cast<ClassTemplateSpecializationDecl>(RD)) {
    // Template might not be instantiated yet, fall back to primary template
    // in such cases.
    if (CTSD->getTemplateSpecializationKind() == TSK_Undeclared)
      RD = CTSD->getSpecializedTemplate()->getTemplatedDecl();
  }
  return RD;
}

if (const auto *TST = BaseType->getAs<TemplateSpecializationType>()) {
  if (const auto *TD = dyn_cast_or_null<ClassTemplateDecl>(
          TST->getTemplateName().getAsTemplateDecl())) {
    return TD->getTemplatedDecl();
  }
}

return nullptr;
5145}

5147namespace {
5148// Collects completion-relevant information about a concept-constrainted type T.
5149// In particular, examines the constraint expressions to find members of T.
5150//
5151// The design is very simple: we walk down each constraint looking for
5152// expressions of the form T.foo().
5153// If we're extra lucky, the return type is specified.
5154// We don't do any clever handling of && or || in constraint expressions, we
5155// take members from both branches.
5156//
5157// For example, given:
5158//   template <class T> concept X = requires (T t, string& s) { t.print(s); };
5159//   template <X U> void foo(U u) { u.^ }
5160// We want to suggest the inferred member function 'print(string)'.
5161// We see that u has type U, so X<U> holds.
5162// X<U> requires t.print(s) to be valid, where t has type U (substituted for T).
5163// By looking at the CallExpr we find the signature of print().
5164//
5165// While we tend to know in advance which kind of members (access via . -> ::)
5166// we want, it's simpler just to gather them all and post-filter.
5167//
5168// FIXME: some of this machinery could be used for non-concept type-parms too,
5169// enabling completion for type parameters based on other uses of that param.
5170//
5171// FIXME: there are other cases where a type can be constrained by a concept,
5172// e.g. inside `if constexpr(ConceptSpecializationExpr) { ... }`
5173class ConceptInfo {
5174public:
// Describes a likely member of a type, inferred by concept constraints.
// Offered as a code completion for T. T-> and T:: contexts.
struct Member {
  // Always non-null: we only handle members with ordinary identifier names.
  const IdentifierInfo *Name = nullptr;
  // Set for functions we've seen called.
  // We don't have the declared parameter types, only the actual types of
  // arguments we've seen. These are still valuable, as it's hard to render
  // a useful function completion with neither parameter types nor names!
  std::optional<SmallVector<QualType, 1>> ArgTypes;
  // Whether this is accessed as T.member, T->member, or T::member.
  enum AccessOperator {
    Colons,
    Arrow,
    Dot,
  } Operator = Dot;
  // What's known about the type of a variable or return type of a function.
  const TypeConstraint *ResultType = nullptr;
  // FIXME: also track:
  //   - kind of entity (function/variable/type), to expose structured results
  //   - template args kinds/types, as a proxy for template params

  // For now we simply return these results as "pattern" strings.
  CodeCompletionString *render(Sema &S, CodeCompletionAllocator &Alloc,
                               CodeCompletionTUInfo &Info) const {
    CodeCompletionBuilder B(Alloc, Info);
    // Result type
    if (ResultType) {
      std::string AsString;
      {
        llvm::raw_string_ostream OS(AsString);
        QualType ExactType = deduceType(*ResultType);
        if (!ExactType.isNull())
          ExactType.print(OS, getCompletionPrintingPolicy(S));
        else
          ResultType->print(OS, getCompletionPrintingPolicy(S));
      }
      B.AddResultTypeChunk(Alloc.CopyString(AsString));
    }
    // Member name
    B.AddTypedTextChunk(Alloc.CopyString(Name->getName()));
    // Function argument list
    if (ArgTypes) {
      B.AddChunk(clang::CodeCompletionString::CK_LeftParen);
      bool First = true;
      for (QualType Arg : *ArgTypes) {
        if (First)
          First = false;
        else {
          B.AddChunk(clang::CodeCompletionString::CK_Comma);
          B.AddChunk(clang::CodeCompletionString::CK_HorizontalSpace);
        }
        B.AddPlaceholderChunk(Alloc.CopyString(
            Arg.getAsString(getCompletionPrintingPolicy(S))));
      }
      B.AddChunk(clang::CodeCompletionString::CK_RightParen);
    }
    return B.TakeString();
  }
};

// BaseType is the type parameter T to infer members from.
// T must be accessible within S, as we use it to find the template entity
// that T is attached to in order to gather the relevant constraints.
ConceptInfo(const TemplateTypeParmType &BaseType, Scope *S) {
  auto *TemplatedEntity = getTemplatedEntity(BaseType.getDecl(), S);
  for (const Expr *E : constraintsForTemplatedEntity(TemplatedEntity))
    believe(E, &BaseType);
}

std::vector<Member> members() {
  std::vector<Member> Results;
  for (const auto &E : this->Results)
    Results.push_back(E.second);
  llvm::sort(Results, [](const Member &L, const Member &R) {
    return L.Name->getName() < R.Name->getName();
  });
  return Results;
}

5255private:
// Infer members of T, given that the expression E (dependent on T) is true.
void believe(const Expr *E, const TemplateTypeParmType *T) {
  if (!E || !T)
    return;
  if (auto *CSE = dyn_cast<ConceptSpecializationExpr>(E)) {
    // If the concept is
    //   template <class A, class B> concept CD = f<A, B>();
    // And the concept specialization is
    //   CD<int, T>
    // Then we're substituting T for B, so we want to make f<A, B>() true
    // by adding members to B - i.e. believe(f<A, B>(), B);
    //
    // For simplicity:
    // - we don't attempt to substitute int for A
    // - when T is used in other ways (like CD<T*>) we ignore it
    ConceptDecl *CD = CSE->getNamedConcept();
    TemplateParameterList *Params = CD->getTemplateParameters();
    unsigned Index = 0;
    for (const auto &Arg : CSE->getTemplateArguments()) {
      if (Index >= Params->size())
        break; // Won't happen in valid code.
      if (isApprox(Arg, T)) {
        auto *TTPD = dyn_cast<TemplateTypeParmDecl>(Params->getParam(Index));
        if (!TTPD)
          continue;
        // T was used as an argument, and bound to the parameter TT.
        auto *TT = cast<TemplateTypeParmType>(TTPD->getTypeForDecl());
        // So now we know the constraint as a function of TT is true.
        believe(CD->getConstraintExpr(), TT);
        // (concepts themselves have no associated constraints to require)
      }

      ++Index;
    }
  } else if (auto *BO = dyn_cast<BinaryOperator>(E)) {
    // For A && B, we can infer members from both branches.
    // For A || B, the union is still more useful than the intersection.
    if (BO->getOpcode() == BO_LAnd || BO->getOpcode() == BO_LOr) {
      believe(BO->getLHS(), T);
      believe(BO->getRHS(), T);
    }
  } else if (auto *RE = dyn_cast<RequiresExpr>(E)) {
    // A requires(){...} lets us infer members from each requirement.
    for (const concepts::Requirement *Req : RE->getRequirements()) {
      if (!Req->isDependent())
        continue; // Can't tell us anything about T.
      // Now Req cannot a substitution-error: those aren't dependent.

      if (auto *TR = dyn_cast<concepts::TypeRequirement>(Req)) {
        // Do a full traversal so we get `foo` from `typename T::foo::bar`.
        QualType AssertedType = TR->getType()->getType();
        ValidVisitor(this, T).TraverseType(AssertedType);
      } else if (auto *ER = dyn_cast<concepts::ExprRequirement>(Req)) {
        ValidVisitor Visitor(this, T);
        // If we have a type constraint on the value of the expression,
        // AND the whole outer expression describes a member, then we'll
        // be able to use the constraint to provide the return type.
        if (ER->getReturnTypeRequirement().isTypeConstraint()) {
          Visitor.OuterType =
              ER->getReturnTypeRequirement().getTypeConstraint();
          Visitor.OuterExpr = ER->getExpr();
        }
        Visitor.TraverseStmt(ER->getExpr());
      } else if (auto *NR = dyn_cast<concepts::NestedRequirement>(Req)) {
        believe(NR->getConstraintExpr(), T);
      }
    }
  }
}

// This visitor infers members of T based on traversing expressions/types
// that involve T. It is invoked with code known to be valid for T.
class ValidVisitor : public RecursiveASTVisitor<ValidVisitor> {
  ConceptInfo *Outer;
  const TemplateTypeParmType *T;

  CallExpr *Caller = nullptr;
  Expr *Callee = nullptr;

public:
  // If set, OuterExpr is constrained by OuterType.
  Expr *OuterExpr = nullptr;
  const TypeConstraint *OuterType = nullptr;

  ValidVisitor(ConceptInfo *Outer, const TemplateTypeParmType *T)
      : Outer(Outer), T(T) {
    assert(T)(static_cast <bool> (T) ? void (0) : __assert_fail ("T"
, "clang/lib/Sema/SemaCodeComplete.cpp", 5342, __extension__ __PRETTY_FUNCTION__
));
  }

  // In T.foo or T->foo, `foo` is a member function/variable.
  bool VisitCXXDependentScopeMemberExpr(CXXDependentScopeMemberExpr *E) {
    const Type *Base = E->getBaseType().getTypePtr();
    bool IsArrow = E->isArrow();
    if (Base->isPointerType() && IsArrow) {
      IsArrow = false;
      Base = Base->getPointeeType().getTypePtr();
    }
    if (isApprox(Base, T))
      addValue(E, E->getMember(), IsArrow ? Member::Arrow : Member::Dot);
    return true;
  }

  // In T::foo, `foo` is a static member function/variable.
  bool VisitDependentScopeDeclRefExpr(DependentScopeDeclRefExpr *E) {
    if (E->getQualifier() && isApprox(E->getQualifier()->getAsType(), T))
      addValue(E, E->getDeclName(), Member::Colons);
    return true;
  }

  // In T::typename foo, `foo` is a type.
  bool VisitDependentNameType(DependentNameType *DNT) {
    const auto *Q = DNT->getQualifier();
    if (Q && isApprox(Q->getAsType(), T))
      addType(DNT->getIdentifier());
    return true;
  }

  // In T::foo::bar, `foo` must be a type.
  // VisitNNS() doesn't exist, and TraverseNNS isn't always called :-(
  bool TraverseNestedNameSpecifierLoc(NestedNameSpecifierLoc NNSL) {
    if (NNSL) {
      NestedNameSpecifier *NNS = NNSL.getNestedNameSpecifier();
      const auto *Q = NNS->getPrefix();
      if (Q && isApprox(Q->getAsType(), T))
        addType(NNS->getAsIdentifier());
    }
    // FIXME: also handle T::foo<X>::bar
    return RecursiveASTVisitor::TraverseNestedNameSpecifierLoc(NNSL);
  }

  // FIXME also handle T::foo<X>

  // Track the innermost caller/callee relationship so we can tell if a
  // nested expr is being called as a function.
  bool VisitCallExpr(CallExpr *CE) {
    Caller = CE;
    Callee = CE->getCallee();
    return true;
  }

private:
  void addResult(Member &&M) {
    auto R = Outer->Results.try_emplace(M.Name);
    Member &O = R.first->second;
    // Overwrite existing if the new member has more info.
    // The preference of . vs :: vs -> is fairly arbitrary.
    if (/*Inserted*/ R.second ||
        std::make_tuple(M.ArgTypes.has_value(), M.ResultType != nullptr,
                        M.Operator) > std::make_tuple(O.ArgTypes.has_value(),
                                                      O.ResultType != nullptr,
                                                      O.Operator))
      O = std::move(M);
  }

  void addType(const IdentifierInfo *Name) {
    if (!Name)
      return;
    Member M;
    M.Name = Name;
    M.Operator = Member::Colons;
    addResult(std::move(M));
  }

  void addValue(Expr *E, DeclarationName Name,
                Member::AccessOperator Operator) {
    if (!Name.isIdentifier())
      return;
    Member Result;
    Result.Name = Name.getAsIdentifierInfo();
    Result.Operator = Operator;
    // If this is the callee of an immediately-enclosing CallExpr, then
    // treat it as a method, otherwise it's a variable.
    if (Caller != nullptr && Callee == E) {
      Result.ArgTypes.emplace();
      for (const auto *Arg : Caller->arguments())
        Result.ArgTypes->push_back(Arg->getType());
      if (Caller == OuterExpr) {
        Result.ResultType = OuterType;
      }
    } else {
      if (E == OuterExpr)
        Result.ResultType = OuterType;
    }
    addResult(std::move(Result));
  }
};

static bool isApprox(const TemplateArgument &Arg, const Type *T) {
  return Arg.getKind() == TemplateArgument::Type &&
         isApprox(Arg.getAsType().getTypePtr(), T);
}

static bool isApprox(const Type *T1, const Type *T2) {
  return T1 && T2 &&
         T1->getCanonicalTypeUnqualified() ==
             T2->getCanonicalTypeUnqualified();
}

// Returns the DeclContext immediately enclosed by the template parameter
// scope. For primary templates, this is the templated (e.g.) CXXRecordDecl.
// For specializations, this is e.g. ClassTemplatePartialSpecializationDecl.
static DeclContext *getTemplatedEntity(const TemplateTypeParmDecl *D,
                                       Scope *S) {
  if (D == nullptr)
    return nullptr;
  Scope *Inner = nullptr;
  while (S) {
    if (S->isTemplateParamScope() && S->isDeclScope(D))
      return Inner ? Inner->getEntity() : nullptr;
    Inner = S;
    S = S->getParent();
  }
  return nullptr;
}

// Gets all the type constraint expressions that might apply to the type
// variables associated with DC (as returned by getTemplatedEntity()).
static SmallVector<const Expr *, 1>
constraintsForTemplatedEntity(DeclContext *DC) {
  SmallVector<const Expr *, 1> Result;
  if (DC == nullptr)
    return Result;
  // Primary templates can have constraints.
  if (const auto *TD = cast<Decl>(DC)->getDescribedTemplate())
    TD->getAssociatedConstraints(Result);
  // Partial specializations may have constraints.
  if (const auto *CTPSD =
          dyn_cast<ClassTemplatePartialSpecializationDecl>(DC))
    CTPSD->getAssociatedConstraints(Result);
  if (const auto *VTPSD = dyn_cast<VarTemplatePartialSpecializationDecl>(DC))
    VTPSD->getAssociatedConstraints(Result);
  return Result;
}

// Attempt to find the unique type satisfying a constraint.
// This lets us show e.g. `int` instead of `std::same_as<int>`.
static QualType deduceType(const TypeConstraint &T) {
  // Assume a same_as<T> return type constraint is std::same_as or equivalent.
  // In this case the return type is T.
  DeclarationName DN = T.getNamedConcept()->getDeclName();
  if (DN.isIdentifier() && DN.getAsIdentifierInfo()->isStr("same_as"))
    if (const auto *Args = T.getTemplateArgsAsWritten())
      if (Args->getNumTemplateArgs() == 1) {
        const auto &Arg = Args->arguments().front().getArgument();
        if (Arg.getKind() == TemplateArgument::Type)
          return Arg.getAsType();
      }
  return {};
}

llvm::DenseMap<const IdentifierInfo *, Member> Results;
5507};

5509// Returns a type for E that yields acceptable member completions.
5510// In particular, when E->getType() is DependentTy, try to guess a likely type.
5511// We accept some lossiness (like dropping parameters).
5512// We only try to handle common expressions on the LHS of MemberExpr.
5513QualType getApproximateType(const Expr *E) {
if (E->getType().isNull())
  return QualType();
E = E->IgnoreParenImpCasts();
QualType Unresolved = E->getType();
// We only resolve DependentTy, or undeduced autos (including auto* etc).
if (!Unresolved->isSpecificBuiltinType(BuiltinType::Dependent)) {
  AutoType *Auto = Unresolved->getContainedAutoType();
  if (!Auto || !Auto->isUndeducedAutoType())
    return Unresolved;
}
// A call: approximate-resolve callee to a function type, get its return type
if (const CallExpr *CE = llvm::dyn_cast<CallExpr>(E)) {
  QualType Callee = getApproximateType(CE->getCallee());
  if (Callee.isNull() ||
      Callee->isSpecificPlaceholderType(BuiltinType::BoundMember))
    Callee = Expr::findBoundMemberType(CE->getCallee());
  if (Callee.isNull())
    return Unresolved;

  if (const auto *FnTypePtr = Callee->getAs<PointerType>()) {
    Callee = FnTypePtr->getPointeeType();
  } else if (const auto *BPT = Callee->getAs<BlockPointerType>()) {
    Callee = BPT->getPointeeType();
  }
  if (const FunctionType *FnType = Callee->getAs<FunctionType>())
    return FnType->getReturnType().getNonReferenceType();

  // Unresolved call: try to guess the return type.
  if (const auto *OE = llvm::dyn_cast<OverloadExpr>(CE->getCallee())) {
    // If all candidates have the same approximate return type, use it.
    // Discard references and const to allow more to be "the same".
    // (In particular, if there's one candidate + ADL, resolve it).
    const Type *Common = nullptr;
    for (const auto *D : OE->decls()) {
      QualType ReturnType;
      if (const auto *FD = llvm::dyn_cast<FunctionDecl>(D))
        ReturnType = FD->getReturnType();
      else if (const auto *FTD = llvm::dyn_cast<FunctionTemplateDecl>(D))
        ReturnType = FTD->getTemplatedDecl()->getReturnType();
      if (ReturnType.isNull())
        continue;
      const Type *Candidate =
          ReturnType.getNonReferenceType().getCanonicalType().getTypePtr();
      if (Common && Common != Candidate)
        return Unresolved; // Multiple candidates.
      Common = Candidate;
    }
    if (Common != nullptr)
      return QualType(Common, 0);
  }
}
// A dependent member: approximate-resolve the base, then lookup.
if (const auto *CDSME = llvm::dyn_cast<CXXDependentScopeMemberExpr>(E)) {
  QualType Base = CDSME->isImplicitAccess()
                      ? CDSME->getBaseType()
                      : getApproximateType(CDSME->getBase());
  if (CDSME->isArrow() && !Base.isNull())
    Base = Base->getPointeeType(); // could handle unique_ptr etc here?
  auto *RD =
      Base.isNull()
          ? nullptr
          : llvm::dyn_cast_or_null<CXXRecordDecl>(getAsRecordDecl(Base));
  if (RD && RD->isCompleteDefinition()) {
    // Look up member heuristically, including in bases.
    for (const auto *Member : RD->lookupDependentName(
             CDSME->getMember(), [](const NamedDecl *Member) {
               return llvm::isa<ValueDecl>(Member);
             })) {
      return llvm::cast<ValueDecl>(Member)->getType().getNonReferenceType();
    }
  }
}
// A reference to an `auto` variable: approximate-resolve its initializer.
if (const auto *DRE = llvm::dyn_cast<DeclRefExpr>(E)) {
  if (const auto *VD = llvm::dyn_cast<VarDecl>(DRE->getDecl())) {
    if (VD->hasInit())
      return getApproximateType(VD->getInit());
  }
}
return Unresolved;
5594}

5596// If \p Base is ParenListExpr, assume a chain of comma operators and pick the
5597// last expr. We expect other ParenListExprs to be resolved to e.g. constructor
5598// calls before here. (So the ParenListExpr should be nonempty, but check just
5599// in case)
5600Expr *unwrapParenList(Expr *Base) {
if (auto *PLE = llvm::dyn_cast_or_null<ParenListExpr>(Base)) {
  if (PLE->getNumExprs() == 0)
    return nullptr;
  Base = PLE->getExpr(PLE->getNumExprs() - 1);
}
return Base;
5607}

5609} // namespace

5611void Sema::CodeCompleteMemberReferenceExpr(Scope *S, Expr *Base,
                                         Expr *OtherOpBase,
                                         SourceLocation OpLoc, bool IsArrow,
                                         bool IsBaseExprStatement,
                                         QualType PreferredType) {
Base = unwrapParenList(Base);
OtherOpBase = unwrapParenList(OtherOpBase);
if (!Base || !CodeCompleter)
  return;

ExprResult ConvertedBase = PerformMemberExprBaseConversion(Base, IsArrow);
if (ConvertedBase.isInvalid())
  return;
QualType ConvertedBaseType = getApproximateType(ConvertedBase.get());

enum CodeCompletionContext::Kind contextKind;

if (IsArrow) {
  if (const auto *Ptr = ConvertedBaseType->getAs<PointerType>())
    ConvertedBaseType = Ptr->getPointeeType();
}

if (IsArrow) {
  contextKind = CodeCompletionContext::CCC_ArrowMemberAccess;
} else {
  if (ConvertedBaseType->isObjCObjectPointerType() ||
      ConvertedBaseType->isObjCObjectOrInterfaceType()) {
    contextKind = CodeCompletionContext::CCC_ObjCPropertyAccess;
  } else {
    contextKind = CodeCompletionContext::CCC_DotMemberAccess;
  }
}

CodeCompletionContext CCContext(contextKind, ConvertedBaseType);
CCContext.setPreferredType(PreferredType);
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(), CCContext,
                      &ResultBuilder::IsMember);

auto DoCompletion = [&](Expr *Base, bool IsArrow,
                        std::optional<FixItHint> AccessOpFixIt) -> bool {
  if (!Base)
    return false;

  ExprResult ConvertedBase = PerformMemberExprBaseConversion(Base, IsArrow);
  if (ConvertedBase.isInvalid())
    return false;
  Base = ConvertedBase.get();

  QualType BaseType = getApproximateType(Base);
  if (BaseType.isNull())
    return false;
  ExprValueKind BaseKind = Base->getValueKind();

  if (IsArrow) {
    if (const PointerType *Ptr = BaseType->getAs<PointerType>()) {
      BaseType = Ptr->getPointeeType();
      BaseKind = VK_LValue;
    } else if (BaseType->isObjCObjectPointerType() ||
               BaseType->isTemplateTypeParmType()) {
      // Both cases (dot/arrow) handled below.
    } else {
      return false;
    }
  }

  if (RecordDecl *RD = getAsRecordDecl(BaseType)) {
    AddRecordMembersCompletionResults(*this, Results, S, BaseType, BaseKind,
                                      RD, std::move(AccessOpFixIt));
  } else if (const auto *TTPT =
                 dyn_cast<TemplateTypeParmType>(BaseType.getTypePtr())) {
    auto Operator =
        IsArrow ? ConceptInfo::Member::Arrow : ConceptInfo::Member::Dot;
    for (const auto &R : ConceptInfo(*TTPT, S).members()) {
      if (R.Operator != Operator)
        continue;
      CodeCompletionResult Result(
          R.render(*this, CodeCompleter->getAllocator(),
                   CodeCompleter->getCodeCompletionTUInfo()));
      if (AccessOpFixIt)
        Result.FixIts.push_back(*AccessOpFixIt);
      Results.AddResult(std::move(Result));
    }
  } else if (!IsArrow && BaseType->isObjCObjectPointerType()) {
    // Objective-C property reference. Bail if we're performing fix-it code
    // completion since Objective-C properties are normally backed by ivars,
    // most Objective-C fix-its here would have little value.
    if (AccessOpFixIt) {
      return false;
    }
    AddedPropertiesSet AddedProperties;

    if (const ObjCObjectPointerType *ObjCPtr =
            BaseType->getAsObjCInterfacePointerType()) {
      // Add property results based on our interface.
      assert(ObjCPtr && "Non-NULL pointer guaranteed above!")(static_cast <bool> (ObjCPtr && "Non-NULL pointer guaranteed above!"
) ? void (0) : __assert_fail ("ObjCPtr && \"Non-NULL pointer guaranteed above!\""
, "clang/lib/Sema/SemaCodeComplete.cpp", 5706, __extension__ __PRETTY_FUNCTION__
));
      AddObjCProperties(CCContext, ObjCPtr->getInterfaceDecl(), true,
                        /*AllowNullaryMethods=*/true, CurContext,
                        AddedProperties, Results, IsBaseExprStatement);
    }

    // Add properties from the protocols in a qualified interface.
    for (auto *I : BaseType->castAs<ObjCObjectPointerType>()->quals())
      AddObjCProperties(CCContext, I, true, /*AllowNullaryMethods=*/true,
                        CurContext, AddedProperties, Results,
                        IsBaseExprStatement, /*IsClassProperty*/ false,
                        /*InOriginalClass*/ false);
  } else if ((IsArrow && BaseType->isObjCObjectPointerType()) ||
             (!IsArrow && BaseType->isObjCObjectType())) {
    // Objective-C instance variable access. Bail if we're performing fix-it
    // code completion since Objective-C properties are normally backed by
    // ivars, most Objective-C fix-its here would have little value.
    if (AccessOpFixIt) {
      return false;
    }
    ObjCInterfaceDecl *Class = nullptr;
    if (const ObjCObjectPointerType *ObjCPtr =
            BaseType->getAs<ObjCObjectPointerType>())
      Class = ObjCPtr->getInterfaceDecl();
    else
      Class = BaseType->castAs<ObjCObjectType>()->getInterface();

    // Add all ivars from this class and its superclasses.
    if (Class) {
      CodeCompletionDeclConsumer Consumer(Results, Class, BaseType);
      Results.setFilter(&ResultBuilder::IsObjCIvar);
      LookupVisibleDecls(
          Class, LookupMemberName, Consumer, CodeCompleter->includeGlobals(),
          /*IncludeDependentBases=*/false, CodeCompleter->loadExternal());
    }
  }

  // FIXME: How do we cope with isa?
  return true;
};

Results.EnterNewScope();

bool CompletionSucceded = DoCompletion(Base, IsArrow, std::nullopt);
if (CodeCompleter->includeFixIts()) {
  const CharSourceRange OpRange =
      CharSourceRange::getTokenRange(OpLoc, OpLoc);
  CompletionSucceded |= DoCompletion(
      OtherOpBase, !IsArrow,
      FixItHint::CreateReplacement(OpRange, IsArrow ? "." : "->"));
}

Results.ExitScope();

if (!CompletionSucceded)
  return;

// Hand off the results found for code completion.
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
5766}

5768void Sema::CodeCompleteObjCClassPropertyRefExpr(Scope *S,
                                              IdentifierInfo &ClassName,
                                              SourceLocation ClassNameLoc,
                                              bool IsBaseExprStatement) {
IdentifierInfo *ClassNamePtr = &ClassName;
ObjCInterfaceDecl *IFace = getObjCInterfaceDecl(ClassNamePtr, ClassNameLoc);
if (!IFace)
  return;
CodeCompletionContext CCContext(
    CodeCompletionContext::CCC_ObjCPropertyAccess);
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(), CCContext,
                      &ResultBuilder::IsMember);
Results.EnterNewScope();
AddedPropertiesSet AddedProperties;
AddObjCProperties(CCContext, IFace, true,
                  /*AllowNullaryMethods=*/true, CurContext, AddedProperties,
                  Results, IsBaseExprStatement,
                  /*IsClassProperty=*/true);
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
5790}

5792void Sema::CodeCompleteTag(Scope *S, unsigned TagSpec) {
if (!CodeCompleter)
  return;

ResultBuilder::LookupFilter Filter = nullptr;
enum CodeCompletionContext::Kind ContextKind =
    CodeCompletionContext::CCC_Other;
switch ((DeclSpec::TST)TagSpec) {
case DeclSpec::TST_enum:
  Filter = &ResultBuilder::IsEnum;
  ContextKind = CodeCompletionContext::CCC_EnumTag;
  break;

case DeclSpec::TST_union:
  Filter = &ResultBuilder::IsUnion;
  ContextKind = CodeCompletionContext::CCC_UnionTag;
  break;

case DeclSpec::TST_struct:
case DeclSpec::TST_class:
case DeclSpec::TST_interface:
  Filter = &ResultBuilder::IsClassOrStruct;
  ContextKind = CodeCompletionContext::CCC_ClassOrStructTag;
  break;

default:
  llvm_unreachable("Unknown type specifier kind in CodeCompleteTag")::llvm::llvm_unreachable_internal("Unknown type specifier kind in CodeCompleteTag"
, "clang/lib/Sema/SemaCodeComplete.cpp", 5818);
}

ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(), ContextKind);
CodeCompletionDeclConsumer Consumer(Results, CurContext);

// First pass: look for tags.
Results.setFilter(Filter);
LookupVisibleDecls(S, LookupTagName, Consumer,
                   CodeCompleter->includeGlobals(),
                   CodeCompleter->loadExternal());

if (CodeCompleter->includeGlobals()) {
  // Second pass: look for nested name specifiers.
  Results.setFilter(&ResultBuilder::IsNestedNameSpecifier);
  LookupVisibleDecls(S, LookupNestedNameSpecifierName, Consumer,
                     CodeCompleter->includeGlobals(),
                     CodeCompleter->loadExternal());
}

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
5841}

5843static void AddTypeQualifierResults(DeclSpec &DS, ResultBuilder &Results,
                                  const LangOptions &LangOpts) {
if (!(DS.getTypeQualifiers() & DeclSpec::TQ_const))
  Results.AddResult("const");
if (!(DS.getTypeQualifiers() & DeclSpec::TQ_volatile))
  Results.AddResult("volatile");
if (LangOpts.C99 && !(DS.getTypeQualifiers() & DeclSpec::TQ_restrict))
  Results.AddResult("restrict");
if (LangOpts.C11 && !(DS.getTypeQualifiers() & DeclSpec::TQ_atomic))
  Results.AddResult("_Atomic");
if (LangOpts.MSVCCompat && !(DS.getTypeQualifiers() & DeclSpec::TQ_unaligned))
  Results.AddResult("__unaligned");
5855}

5857void Sema::CodeCompleteTypeQualifiers(DeclSpec &DS) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_TypeQualifiers);
Results.EnterNewScope();
AddTypeQualifierResults(DS, Results, LangOpts);
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
5866}

5868void Sema::CodeCompleteFunctionQualifiers(DeclSpec &DS, Declarator &D,
                                        const VirtSpecifiers *VS) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_TypeQualifiers);
Results.EnterNewScope();
AddTypeQualifierResults(DS, Results, LangOpts);
if (LangOpts.CPlusPlus11) {
  Results.AddResult("noexcept");
  if (D.getContext() == DeclaratorContext::Member && !D.isCtorOrDtor() &&
      !D.isStaticMember()) {
    if (!VS || !VS->isFinalSpecified())
      Results.AddResult("final");
    if (!VS || !VS->isOverrideSpecified())
      Results.AddResult("override");
  }
}
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
5888}

5890void Sema::CodeCompleteBracketDeclarator(Scope *S) {
CodeCompleteExpression(S, QualType(getASTContext().getSizeType()));
5892}

5894void Sema::CodeCompleteCase(Scope *S) {
if (getCurFunction()->SwitchStack.empty() || !CodeCompleter)
  return;

SwitchStmt *Switch = getCurFunction()->SwitchStack.back().getPointer();
// Condition expression might be invalid, do not continue in this case.
if (!Switch->getCond())
  return;
QualType type = Switch->getCond()->IgnoreImplicit()->getType();
if (!type->isEnumeralType()) {
  CodeCompleteExpressionData Data(type);
  Data.IntegralConstantExpression = true;
  CodeCompleteExpression(S, Data);
  return;
}

// Code-complete the cases of a switch statement over an enumeration type
// by providing the list of
EnumDecl *Enum = type->castAs<EnumType>()->getDecl();
if (EnumDecl *Def = Enum->getDefinition())
  Enum = Def;

// Determine which enumerators we have already seen in the switch statement.
// FIXME: Ideally, we would also be able to look *past* the code-completion
// token, in case we are code-completing in the middle of the switch and not
// at the end. However, we aren't able to do so at the moment.
CoveredEnumerators Enumerators;
for (SwitchCase *SC = Switch->getSwitchCaseList(); SC;
     SC = SC->getNextSwitchCase()) {
  CaseStmt *Case = dyn_cast<CaseStmt>(SC);
  if (!Case)
    continue;

  Expr *CaseVal = Case->getLHS()->IgnoreParenCasts();
  if (auto *DRE = dyn_cast<DeclRefExpr>(CaseVal))
    if (auto *Enumerator =
            dyn_cast<EnumConstantDecl>(DRE->getDecl())) {
      // We look into the AST of the case statement to determine which
      // enumerator was named. Alternatively, we could compute the value of
      // the integral constant expression, then compare it against the
      // values of each enumerator. However, value-based approach would not
      // work as well with C++ templates where enumerators declared within a
      // template are type- and value-dependent.
      Enumerators.Seen.insert(Enumerator);

      // If this is a qualified-id, keep track of the nested-name-specifier
      // so that we can reproduce it as part of code completion, e.g.,
      //
      //   switch (TagD.getKind()) {
      //     case TagDecl::TK_enum:
      //       break;
      //     case XXX
      //
      // At the XXX, our completions are TagDecl::TK_union,
      // TagDecl::TK_struct, and TagDecl::TK_class, rather than TK_union,
      // TK_struct, and TK_class.
      Enumerators.SuggestedQualifier = DRE->getQualifier();
    }
}

// Add any enumerators that have not yet been mentioned.
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Expression);
AddEnumerators(Results, Context, Enum, CurContext, Enumerators);

if (CodeCompleter->includeMacros()) {
  AddMacroResults(PP, Results, CodeCompleter->loadExternal(), false);
}
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
5965}

5967static bool anyNullArguments(ArrayRef<Expr *> Args) {
if (Args.size() && !Args.data())
  return true;

for (unsigned I = 0; I != Args.size(); ++I)
  if (!Args[I])
    return true;

return false;
5976}

5978typedef CodeCompleteConsumer::OverloadCandidate ResultCandidate;

5980static void mergeCandidatesWithResults(
  Sema &SemaRef, SmallVectorImpl<ResultCandidate> &Results,
  OverloadCandidateSet &CandidateSet, SourceLocation Loc, size_t ArgSize) {
// Sort the overload candidate set by placing the best overloads first.
llvm::stable_sort(CandidateSet, [&](const OverloadCandidate &X,
                                    const OverloadCandidate &Y) {
  return isBetterOverloadCandidate(SemaRef, X, Y, Loc,
                                   CandidateSet.getKind());
});

// Add the remaining viable overload candidates as code-completion results.
for (OverloadCandidate &Candidate : CandidateSet) {
  if (Candidate.Function) {
    if (Candidate.Function->isDeleted())
      continue;
    if (shouldEnforceArgLimit(/*PartialOverloading=*/true,
                              Candidate.Function) &&
        Candidate.Function->getNumParams() <= ArgSize &&
        // Having zero args is annoying, normally we don't surface a function
        // with 2 params, if you already have 2 params, because you are
        // inserting the 3rd now. But with zero, it helps the user to figure
        // out there are no overloads that take any arguments. Hence we are
        // keeping the overload.
        ArgSize > 0)
      continue;
  }
  if (Candidate.Viable)
    Results.push_back(ResultCandidate(Candidate.Function));
}
6009}

6011/// Get the type of the Nth parameter from a given set of overload
6012/// candidates.
6013static QualType getParamType(Sema &SemaRef,
                           ArrayRef<ResultCandidate> Candidates, unsigned N) {

// Given the overloads 'Candidates' for a function call matching all arguments
// up to N, return the type of the Nth parameter if it is the same for all
// overload candidates.
QualType ParamType;
for (auto &Candidate : Candidates) {
  QualType CandidateParamType = Candidate.getParamType(N);
  if (CandidateParamType.isNull())
    continue;
  if (ParamType.isNull()) {
    ParamType = CandidateParamType;
    continue;
  }
  if (!SemaRef.Context.hasSameUnqualifiedType(
          ParamType.getNonReferenceType(),
          CandidateParamType.getNonReferenceType()))
    // Two conflicting types, give up.
    return QualType();
}

return ParamType;
6036}

6038static QualType
6039ProduceSignatureHelp(Sema &SemaRef, MutableArrayRef<ResultCandidate> Candidates,
                   unsigned CurrentArg, SourceLocation OpenParLoc,
                   bool Braced) {
if (Candidates.empty())
  return QualType();
if (SemaRef.getPreprocessor().isCodeCompletionReached())
  SemaRef.CodeCompleter->ProcessOverloadCandidates(
      SemaRef, CurrentArg, Candidates.data(), Candidates.size(), OpenParLoc,
      Braced);
return getParamType(SemaRef, Candidates, CurrentArg);
6049}

6051// Given a callee expression `Fn`, if the call is through a function pointer,
6052// try to find the declaration of the corresponding function pointer type,
6053// so that we can recover argument names from it.
6054static FunctionProtoTypeLoc GetPrototypeLoc(Expr *Fn) {
TypeLoc Target;
if (const auto *T = Fn->getType().getTypePtr()->getAs<TypedefType>()) {
  Target = T->getDecl()->getTypeSourceInfo()->getTypeLoc();

} else if (const auto *DR = dyn_cast<DeclRefExpr>(Fn)) {
  const auto *D = DR->getDecl();
  if (const auto *const VD = dyn_cast<VarDecl>(D)) {
    Target = VD->getTypeSourceInfo()->getTypeLoc();
  }
}

if (!Target)
  return {};

if (auto P = Target.getAs<PointerTypeLoc>()) {
  Target = P.getPointeeLoc();
}

if (auto P = Target.getAs<ParenTypeLoc>()) {
  Target = P.getInnerLoc();
}

if (auto F = Target.getAs<FunctionProtoTypeLoc>()) {
  return F;
}

return {};
6082}

6084QualType Sema::ProduceCallSignatureHelp(Expr *Fn, ArrayRef<Expr *> Args,
                                      SourceLocation OpenParLoc) {
Fn = unwrapParenList(Fn);
if (!CodeCompleter || !Fn)
  return QualType();

// FIXME: Provide support for variadic template functions.
// Ignore type-dependent call expressions entirely.
if (Fn->isTypeDependent() || anyNullArguments(Args))
  return QualType();
// In presence of dependent args we surface all possible signatures using the
// non-dependent args in the prefix. Afterwards we do a post filtering to make
// sure provided candidates satisfy parameter count restrictions.
auto ArgsWithoutDependentTypes =
    Args.take_while([](Expr *Arg) { return !Arg->isTypeDependent(); });

SmallVector<ResultCandidate, 8> Results;

Expr *NakedFn = Fn->IgnoreParenCasts();
// Build an overload candidate set based on the functions we find.
SourceLocation Loc = Fn->getExprLoc();
OverloadCandidateSet CandidateSet(Loc, OverloadCandidateSet::CSK_Normal);

if (auto ULE = dyn_cast<UnresolvedLookupExpr>(NakedFn)) {
  AddOverloadedCallCandidates(ULE, ArgsWithoutDependentTypes, CandidateSet,
                              /*PartialOverloading=*/true);
} else if (auto UME = dyn_cast<UnresolvedMemberExpr>(NakedFn)) {
  TemplateArgumentListInfo TemplateArgsBuffer, *TemplateArgs = nullptr;
  if (UME->hasExplicitTemplateArgs()) {
    UME->copyTemplateArgumentsInto(TemplateArgsBuffer);
    TemplateArgs = &TemplateArgsBuffer;
  }

  // Add the base as first argument (use a nullptr if the base is implicit).
  SmallVector<Expr *, 12> ArgExprs(
      1, UME->isImplicitAccess() ? nullptr : UME->getBase());
  ArgExprs.append(ArgsWithoutDependentTypes.begin(),
                  ArgsWithoutDependentTypes.end());
  UnresolvedSet<8> Decls;
  Decls.append(UME->decls_begin(), UME->decls_end());
  const bool FirstArgumentIsBase = !UME->isImplicitAccess() && UME->getBase();
  AddFunctionCandidates(Decls, ArgExprs, CandidateSet, TemplateArgs,
                        /*SuppressUserConversions=*/false,
                        /*PartialOverloading=*/true, FirstArgumentIsBase);
} else {
  FunctionDecl *FD = nullptr;
  if (auto *MCE = dyn_cast<MemberExpr>(NakedFn))
    FD = dyn_cast<FunctionDecl>(MCE->getMemberDecl());
  else if (auto *DRE = dyn_cast<DeclRefExpr>(NakedFn))
    FD = dyn_cast<FunctionDecl>(DRE->getDecl());
  if (FD) { // We check whether it's a resolved function declaration.
    if (!getLangOpts().CPlusPlus ||
        !FD->getType()->getAs<FunctionProtoType>())
      Results.push_back(ResultCandidate(FD));
    else
      AddOverloadCandidate(FD, DeclAccessPair::make(FD, FD->getAccess()),
                           ArgsWithoutDependentTypes, CandidateSet,
                           /*SuppressUserConversions=*/false,
                           /*PartialOverloading=*/true);

  } else if (auto DC = NakedFn->getType()->getAsCXXRecordDecl()) {
    // If expression's type is CXXRecordDecl, it may overload the function
    // call operator, so we check if it does and add them as candidates.
    // A complete type is needed to lookup for member function call operators.
    if (isCompleteType(Loc, NakedFn->getType())) {
      DeclarationName OpName =
          Context.DeclarationNames.getCXXOperatorName(OO_Call);
      LookupResult R(*this, OpName, Loc, LookupOrdinaryName);
      LookupQualifiedName(R, DC);
      R.suppressDiagnostics();
      SmallVector<Expr *, 12> ArgExprs(1, NakedFn);
      ArgExprs.append(ArgsWithoutDependentTypes.begin(),
                      ArgsWithoutDependentTypes.end());
      AddFunctionCandidates(R.asUnresolvedSet(), ArgExprs, CandidateSet,
                            /*ExplicitArgs=*/nullptr,
                            /*SuppressUserConversions=*/false,
                            /*PartialOverloading=*/true);
    }
  } else {
    // Lastly we check whether expression's type is function pointer or
    // function.

    FunctionProtoTypeLoc P = GetPrototypeLoc(NakedFn);
    QualType T = NakedFn->getType();
    if (!T->getPointeeType().isNull())
      T = T->getPointeeType();

    if (auto FP = T->getAs<FunctionProtoType>()) {
      if (!TooManyArguments(FP->getNumParams(),
                            ArgsWithoutDependentTypes.size(),
                            /*PartialOverloading=*/true) ||
          FP->isVariadic()) {
        if (P) {
          Results.push_back(ResultCandidate(P));
        } else {
          Results.push_back(ResultCandidate(FP));
        }
      }
    } else if (auto FT = T->getAs<FunctionType>())
      // No prototype and declaration, it may be a K & R style function.
      Results.push_back(ResultCandidate(FT));
  }
}
mergeCandidatesWithResults(*this, Results, CandidateSet, Loc, Args.size());
QualType ParamType = ProduceSignatureHelp(*this, Results, Args.size(),
                                          OpenParLoc, /*Braced=*/false);
return !CandidateSet.empty() ? ParamType : QualType();
6191}

6193// Determine which param to continue aggregate initialization from after
6194// a designated initializer.
6195//
6196// Given struct S { int a,b,c,d,e; }:
6197//   after `S{.b=1,`       we want to suggest c to continue
6198//   after `S{.b=1, 2,`    we continue with d (this is legal C and ext in C++)
6199//   after `S{.b=1, .a=2,` we continue with b (this is legal C and ext in C++)
6200//
6201// Possible outcomes:
6202//   - we saw a designator for a field, and continue from the returned index.
6203//     Only aggregate initialization is allowed.
6204//   - we saw a designator, but it was complex or we couldn't find the field.
6205//     Only aggregate initialization is possible, but we can't assist with it.
6206//     Returns an out-of-range index.
6207//   - we saw no designators, just positional arguments.
6208//     Returns std::nullopt.
6209static std::optional<unsigned>
6210getNextAggregateIndexAfterDesignatedInit(const ResultCandidate &Aggregate,
                                       ArrayRef<Expr *> Args) {
static constexpr unsigned Invalid = std::numeric_limits<unsigned>::max();
assert(Aggregate.getKind() == ResultCandidate::CK_Aggregate)(static_cast <bool> (Aggregate.getKind() == ResultCandidate
::CK_Aggregate) ? void (0) : __assert_fail ("Aggregate.getKind() == ResultCandidate::CK_Aggregate"
, "clang/lib/Sema/SemaCodeComplete.cpp", 6213, __extension__ __PRETTY_FUNCTION__
));

// Look for designated initializers.
// They're in their syntactic form, not yet resolved to fields.
const IdentifierInfo *DesignatedFieldName = nullptr;
unsigned ArgsAfterDesignator = 0;
for (const Expr *Arg : Args) {
  if (const auto *DIE = dyn_cast<DesignatedInitExpr>(Arg)) {
    if (DIE->size() == 1 && DIE->getDesignator(0)->isFieldDesignator()) {
      DesignatedFieldName = DIE->getDesignator(0)->getFieldName();
      ArgsAfterDesignator = 0;
    } else {
      return Invalid; // Complicated designator.
    }
  } else if (isa<DesignatedInitUpdateExpr>(Arg)) {
    return Invalid; // Unsupported.
  } else {
    ++ArgsAfterDesignator;
  }
}
if (!DesignatedFieldName)
  return std::nullopt;

// Find the index within the class's fields.
// (Probing getParamDecl() directly would be quadratic in number of fields).
unsigned DesignatedIndex = 0;
const FieldDecl *DesignatedField = nullptr;
for (const auto *Field : Aggregate.getAggregate()->fields()) {
  if (Field->getIdentifier() == DesignatedFieldName) {
    DesignatedField = Field;
    break;
  }
  ++DesignatedIndex;
}
if (!DesignatedField)
  return Invalid; // Designator referred to a missing field, give up.

// Find the index within the aggregate (which may have leading bases).
unsigned AggregateSize = Aggregate.getNumParams();
while (DesignatedIndex < AggregateSize &&
       Aggregate.getParamDecl(DesignatedIndex) != DesignatedField)
  ++DesignatedIndex;

// Continue from the index after the last named field.
return DesignatedIndex + ArgsAfterDesignator + 1;
6258}

6260QualType Sema::ProduceConstructorSignatureHelp(QualType Type,
                                             SourceLocation Loc,
                                             ArrayRef<Expr *> Args,
                                             SourceLocation OpenParLoc,
                                             bool Braced) {
if (!CodeCompleter)
  return QualType();
SmallVector<ResultCandidate, 8> Results;

// A complete type is needed to lookup for constructors.
RecordDecl *RD =
    isCompleteType(Loc, Type) ? Type->getAsRecordDecl() : nullptr;
if (!RD)
  return Type;
CXXRecordDecl *CRD = dyn_cast<CXXRecordDecl>(RD);

// Consider aggregate initialization.
// We don't check that types so far are correct.
// We also don't handle C99/C++17 brace-elision, we assume init-list elements
// are 1:1 with fields.
// FIXME: it would be nice to support "unwrapping" aggregates that contain
// a single subaggregate, like std::array<T, N> -> T __elements[N].
if (Braced && !RD->isUnion() &&
    (!LangOpts.CPlusPlus || (CRD && CRD->isAggregate()))) {
  ResultCandidate AggregateSig(RD);
  unsigned AggregateSize = AggregateSig.getNumParams();

  if (auto NextIndex =
          getNextAggregateIndexAfterDesignatedInit(AggregateSig, Args)) {
    // A designator was used, only aggregate init is possible.
    if (*NextIndex >= AggregateSize)
      return Type;
    Results.push_back(AggregateSig);
    return ProduceSignatureHelp(*this, Results, *NextIndex, OpenParLoc,
                                Braced);
  }

  // Describe aggregate initialization, but also constructors below.
  if (Args.size() < AggregateSize)
    Results.push_back(AggregateSig);
}

// FIXME: Provide support for member initializers.
// FIXME: Provide support for variadic template constructors.

if (CRD) {
  OverloadCandidateSet CandidateSet(Loc, OverloadCandidateSet::CSK_Normal);
  for (NamedDecl *C : LookupConstructors(CRD)) {
    if (auto *FD = dyn_cast<FunctionDecl>(C)) {
      // FIXME: we can't yet provide correct signature help for initializer
      //        list constructors, so skip them entirely.
      if (Braced && LangOpts.CPlusPlus && isInitListConstructor(FD))
        continue;
      AddOverloadCandidate(FD, DeclAccessPair::make(FD, C->getAccess()), Args,
                           CandidateSet,
                           /*SuppressUserConversions=*/false,
                           /*PartialOverloading=*/true,
                           /*AllowExplicit*/ true);
    } else if (auto *FTD = dyn_cast<FunctionTemplateDecl>(C)) {
      if (Braced && LangOpts.CPlusPlus &&
          isInitListConstructor(FTD->getTemplatedDecl()))
        continue;

      AddTemplateOverloadCandidate(
          FTD, DeclAccessPair::make(FTD, C->getAccess()),
          /*ExplicitTemplateArgs=*/nullptr, Args, CandidateSet,
          /*SuppressUserConversions=*/false,
          /*PartialOverloading=*/true);
    }
  }
  mergeCandidatesWithResults(*this, Results, CandidateSet, Loc, Args.size());
}

return ProduceSignatureHelp(*this, Results, Args.size(), OpenParLoc, Braced);
6334}

6336QualType Sema::ProduceCtorInitMemberSignatureHelp(
  Decl *ConstructorDecl, CXXScopeSpec SS, ParsedType TemplateTypeTy,
  ArrayRef<Expr *> ArgExprs, IdentifierInfo *II, SourceLocation OpenParLoc,
  bool Braced) {
if (!CodeCompleter)
  return QualType();

CXXConstructorDecl *Constructor =
    dyn_cast<CXXConstructorDecl>(ConstructorDecl);
if (!Constructor)
  return QualType();
// FIXME: Add support for Base class constructors as well.
if (ValueDecl *MemberDecl = tryLookupCtorInitMemberDecl(
        Constructor->getParent(), SS, TemplateTypeTy, II))
  return ProduceConstructorSignatureHelp(MemberDecl->getType(),
                                         MemberDecl->getLocation(), ArgExprs,
                                         OpenParLoc, Braced);
return QualType();
6354}

6356static bool argMatchesTemplateParams(const ParsedTemplateArgument &Arg,
                                   unsigned Index,
                                   const TemplateParameterList &Params) {
const NamedDecl *Param;
if (Index < Params.size())
  Param = Params.getParam(Index);
else if (Params.hasParameterPack())
  Param = Params.asArray().back();
else
  return false; // too many args

switch (Arg.getKind()) {
case ParsedTemplateArgument::Type:
  return llvm::isa<TemplateTypeParmDecl>(Param); // constraints not checked
case ParsedTemplateArgument::NonType:
  return llvm::isa<NonTypeTemplateParmDecl>(Param); // type not checked
case ParsedTemplateArgument::Template:
  return llvm::isa<TemplateTemplateParmDecl>(Param); // signature not checked
}
llvm_unreachable("Unhandled switch case")::llvm::llvm_unreachable_internal("Unhandled switch case", "clang/lib/Sema/SemaCodeComplete.cpp"
, 6375);
6376}

6378QualType Sema::ProduceTemplateArgumentSignatureHelp(
  TemplateTy ParsedTemplate, ArrayRef<ParsedTemplateArgument> Args,
  SourceLocation LAngleLoc) {
if (!CodeCompleter || !ParsedTemplate)
  return QualType();

SmallVector<ResultCandidate, 8> Results;
auto Consider = [&](const TemplateDecl *TD) {
  // Only add if the existing args are compatible with the template.
  bool Matches = true;
  for (unsigned I = 0; I < Args.size(); ++I) {
    if (!argMatchesTemplateParams(Args[I], I, *TD->getTemplateParameters())) {
      Matches = false;
      break;
    }
  }
  if (Matches)
    Results.emplace_back(TD);
};

TemplateName Template = ParsedTemplate.get();
if (const auto *TD = Template.getAsTemplateDecl()) {
  Consider(TD);
} else if (const auto *OTS = Template.getAsOverloadedTemplate()) {
  for (const NamedDecl *ND : *OTS)
    if (const auto *TD = llvm::dyn_cast<TemplateDecl>(ND))
      Consider(TD);
}
return ProduceSignatureHelp(*this, Results, Args.size(), LAngleLoc,
                            /*Braced=*/false);
6408}

6410static QualType getDesignatedType(QualType BaseType, const Designation &Desig) {
for (unsigned I = 0; I < Desig.getNumDesignators(); ++I) {
  if (BaseType.isNull())
    break;
  QualType NextType;
  const auto &D = Desig.getDesignator(I);
  if (D.isArrayDesignator() || D.isArrayRangeDesignator()) {
    if (BaseType->isArrayType())
      NextType = BaseType->getAsArrayTypeUnsafe()->getElementType();
  } else {
    assert(D.isFieldDesignator())(static_cast <bool> (D.isFieldDesignator()) ? void (0) :
 __assert_fail ("D.isFieldDesignator()", "clang/lib/Sema/SemaCodeComplete.cpp"
, 6420, __extension__ __PRETTY_FUNCTION__));
    auto *RD = getAsRecordDecl(BaseType);
    if (RD && RD->isCompleteDefinition()) {
      for (const auto *Member : RD->lookup(D.getFieldDecl()))
        if (const FieldDecl *FD = llvm::dyn_cast<FieldDecl>(Member)) {
          NextType = FD->getType();
          break;
        }
    }
  }
  BaseType = NextType;
}
return BaseType;
6433}

6435void Sema::CodeCompleteDesignator(QualType BaseType,
                                llvm::ArrayRef<Expr *> InitExprs,
                                const Designation &D) {
BaseType = getDesignatedType(BaseType, D);
if (BaseType.isNull())
  return;
const auto *RD = getAsRecordDecl(BaseType);
if (!RD || RD->fields().empty())
  return;

CodeCompletionContext CCC(CodeCompletionContext::CCC_DotMemberAccess,
                          BaseType);
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(), CCC);

Results.EnterNewScope();
for (const Decl *D : RD->decls()) {
  const FieldDecl *FD;
  if (auto *IFD = dyn_cast<IndirectFieldDecl>(D))
    FD = IFD->getAnonField();
  else if (auto *DFD = dyn_cast<FieldDecl>(D))
    FD = DFD;
  else
    continue;

  // FIXME: Make use of previous designators to mark any fields before those
  // inaccessible, and also compute the next initializer priority.
  ResultBuilder::Result Result(FD, Results.getBasePriority(FD));
  Results.AddResult(Result, CurContext, /*Hiding=*/nullptr);
}
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
6468}

6470void Sema::CodeCompleteInitializer(Scope *S, Decl *D) {
ValueDecl *VD = dyn_cast_or_null<ValueDecl>(D);
if (!VD) {
  CodeCompleteOrdinaryName(S, PCC_Expression);
  return;
}

CodeCompleteExpressionData Data;
Data.PreferredType = VD->getType();
// Ignore VD to avoid completing the variable itself, e.g. in 'int foo = ^'.
Data.IgnoreDecls.push_back(VD);

CodeCompleteExpression(S, Data);
6483}

6485void Sema::CodeCompleteAfterIf(Scope *S, bool IsBracedThen) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      mapCodeCompletionContext(*this, PCC_Statement));
Results.setFilter(&ResultBuilder::IsOrdinaryName);
Results.EnterNewScope();

CodeCompletionDeclConsumer Consumer(Results, CurContext);
LookupVisibleDecls(S, LookupOrdinaryName, Consumer,
                   CodeCompleter->includeGlobals(),
                   CodeCompleter->loadExternal());

AddOrdinaryNameResults(PCC_Statement, S, *this, Results);

// "else" block
CodeCompletionBuilder Builder(Results.getAllocator(),
                              Results.getCodeCompletionTUInfo());

auto AddElseBodyPattern = [&] {
  if (IsBracedThen) {
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddPlaceholderChunk("statements");
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddChunk(CodeCompletionString::CK_RightBrace);
  } else {
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddPlaceholderChunk("statement");
    Builder.AddChunk(CodeCompletionString::CK_SemiColon);
  }
};
Builder.AddTypedTextChunk("else");
if (Results.includeCodePatterns())
  AddElseBodyPattern();
Results.AddResult(Builder.TakeString());

// "else if" block
Builder.AddTypedTextChunk("else if");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddChunk(CodeCompletionString::CK_LeftParen);
if (getLangOpts().CPlusPlus)
  Builder.AddPlaceholderChunk("condition");
else
  Builder.AddPlaceholderChunk("expression");
Builder.AddChunk(CodeCompletionString::CK_RightParen);
if (Results.includeCodePatterns()) {
  AddElseBodyPattern();
}
Results.AddResult(Builder.TakeString());

Results.ExitScope();

if (S->getFnParent())
  AddPrettyFunctionResults(getLangOpts(), Results);

if (CodeCompleter->includeMacros())
  AddMacroResults(PP, Results, CodeCompleter->loadExternal(), false);

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
6547}

6549void Sema::CodeCompleteQualifiedId(Scope *S, CXXScopeSpec &SS,
                                 bool EnteringContext,
                                 bool IsUsingDeclaration, QualType BaseType,
                                 QualType PreferredType) {
if (SS.isEmpty() || !CodeCompleter)
  return;

CodeCompletionContext CC(CodeCompletionContext::CCC_Symbol, PreferredType);
CC.setIsUsingDeclaration(IsUsingDeclaration);
CC.setCXXScopeSpecifier(SS);

// We want to keep the scope specifier even if it's invalid (e.g. the scope
// "a::b::" is not corresponding to any context/namespace in the AST), since
// it can be useful for global code completion which have information about
// contexts/symbols that are not in the AST.
if (SS.isInvalid()) {
  // As SS is invalid, we try to collect accessible contexts from the current
  // scope with a dummy lookup so that the completion consumer can try to
  // guess what the specified scope is.
  ResultBuilder DummyResults(*this, CodeCompleter->getAllocator(),
                             CodeCompleter->getCodeCompletionTUInfo(), CC);
  if (!PreferredType.isNull())
    DummyResults.setPreferredType(PreferredType);
  if (S->getEntity()) {
    CodeCompletionDeclConsumer Consumer(DummyResults, S->getEntity(),
                                        BaseType);
    LookupVisibleDecls(S, LookupOrdinaryName, Consumer,
                       /*IncludeGlobalScope=*/false,
                       /*LoadExternal=*/false);
  }
  HandleCodeCompleteResults(this, CodeCompleter,
                            DummyResults.getCompletionContext(), nullptr, 0);
  return;
}
// Always pretend to enter a context to ensure that a dependent type
// resolves to a dependent record.
DeclContext *Ctx = computeDeclContext(SS, /*EnteringContext=*/true);

// Try to instantiate any non-dependent declaration contexts before
// we look in them. Bail out if we fail.
NestedNameSpecifier *NNS = SS.getScopeRep();
if (NNS != nullptr && SS.isValid() && !NNS->isDependent()) {
  if (Ctx == nullptr || RequireCompleteDeclContext(SS, Ctx))
    return;
}

ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(), CC);
if (!PreferredType.isNull())
  Results.setPreferredType(PreferredType);
Results.EnterNewScope();

// The "template" keyword can follow "::" in the grammar, but only
// put it into the grammar if the nested-name-specifier is dependent.
// FIXME: results is always empty, this appears to be dead.
if (!Results.empty() && NNS->isDependent())
  Results.AddResult("template");

// If the scope is a concept-constrained type parameter, infer nested
// members based on the constraints.
if (const auto *TTPT =
        dyn_cast_or_null<TemplateTypeParmType>(NNS->getAsType())) {
  for (const auto &R : ConceptInfo(*TTPT, S).members()) {
    if (R.Operator != ConceptInfo::Member::Colons)
      continue;
    Results.AddResult(CodeCompletionResult(
        R.render(*this, CodeCompleter->getAllocator(),
                 CodeCompleter->getCodeCompletionTUInfo())));
  }
}

// Add calls to overridden virtual functions, if there are any.
//
// FIXME: This isn't wonderful, because we don't know whether we're actually
// in a context that permits expressions. This is a general issue with
// qualified-id completions.
if (Ctx && !EnteringContext)
  MaybeAddOverrideCalls(*this, Ctx, Results);
Results.ExitScope();

if (Ctx &&
    (CodeCompleter->includeNamespaceLevelDecls() || !Ctx->isFileContext())) {
  CodeCompletionDeclConsumer Consumer(Results, Ctx, BaseType);
  LookupVisibleDecls(Ctx, LookupOrdinaryName, Consumer,
                     /*IncludeGlobalScope=*/true,
                     /*IncludeDependentBases=*/true,
                     CodeCompleter->loadExternal());
}

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
6640}

6642void Sema::CodeCompleteUsing(Scope *S) {
if (!CodeCompleter)
  return;

// This can be both a using alias or using declaration, in the former we
// expect a new name and a symbol in the latter case.
CodeCompletionContext Context(CodeCompletionContext::CCC_SymbolOrNewName);
Context.setIsUsingDeclaration(true);

ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(), Context,
                      &ResultBuilder::IsNestedNameSpecifier);
Results.EnterNewScope();

// If we aren't in class scope, we could see the "namespace" keyword.
if (!S->isClassScope())
  Results.AddResult(CodeCompletionResult("namespace"));

// After "using", we can see anything that would start a
// nested-name-specifier.
CodeCompletionDeclConsumer Consumer(Results, CurContext);
LookupVisibleDecls(S, LookupOrdinaryName, Consumer,
                   CodeCompleter->includeGlobals(),
                   CodeCompleter->loadExternal());
Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
6670}

6672void Sema::CodeCompleteUsingDirective(Scope *S) {
if (!CodeCompleter)
  return;

// After "using namespace", we expect to see a namespace name or namespace
// alias.
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Namespace,
                      &ResultBuilder::IsNamespaceOrAlias);
Results.EnterNewScope();
CodeCompletionDeclConsumer Consumer(Results, CurContext);
LookupVisibleDecls(S, LookupOrdinaryName, Consumer,
                   CodeCompleter->includeGlobals(),
                   CodeCompleter->loadExternal());
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
6690}

6692void Sema::CodeCompleteNamespaceDecl(Scope *S) {
if (!CodeCompleter)
  return;

DeclContext *Ctx = S->getEntity();
if (!S->getParent())
  Ctx = Context.getTranslationUnitDecl();

bool SuppressedGlobalResults =
    Ctx && !CodeCompleter->includeGlobals() && isa<TranslationUnitDecl>(Ctx);

ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      SuppressedGlobalResults
                          ? CodeCompletionContext::CCC_Namespace
                          : CodeCompletionContext::CCC_Other,
                      &ResultBuilder::IsNamespace);

if (Ctx && Ctx->isFileContext() && !SuppressedGlobalResults) {
  // We only want to see those namespaces that have already been defined
  // within this scope, because its likely that the user is creating an
  // extended namespace declaration. Keep track of the most recent
  // definition of each namespace.
  std::map<NamespaceDecl *, NamespaceDecl *> OrigToLatest;
  for (DeclContext::specific_decl_iterator<NamespaceDecl>
           NS(Ctx->decls_begin()),
       NSEnd(Ctx->decls_end());
       NS != NSEnd; ++NS)
    OrigToLatest[NS->getOriginalNamespace()] = *NS;

  // Add the most recent definition (or extended definition) of each
  // namespace to the list of results.
  Results.EnterNewScope();
  for (std::map<NamespaceDecl *, NamespaceDecl *>::iterator
           NS = OrigToLatest.begin(),
           NSEnd = OrigToLatest.end();
       NS != NSEnd; ++NS)
    Results.AddResult(
        CodeCompletionResult(NS->second, Results.getBasePriority(NS->second),
                             nullptr),
        CurContext, nullptr, false);
  Results.ExitScope();
}

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
6738}

6740void Sema::CodeCompleteNamespaceAliasDecl(Scope *S) {
if (!CodeCompleter)
  return;

// After "namespace", we expect to see a namespace or alias.
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Namespace,
                      &ResultBuilder::IsNamespaceOrAlias);
CodeCompletionDeclConsumer Consumer(Results, CurContext);
LookupVisibleDecls(S, LookupOrdinaryName, Consumer,
                   CodeCompleter->includeGlobals(),
                   CodeCompleter->loadExternal());
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
6755}

6757void Sema::CodeCompleteOperatorName(Scope *S) {
if (!CodeCompleter)
  return;

typedef CodeCompletionResult Result;
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Type,
                      &ResultBuilder::IsType);
Results.EnterNewScope();

// Add the names of overloadable operators. Note that OO_Conditional is not
// actually overloadable.
6770#define OVERLOADED_OPERATOR(Name, Spelling, Token, Unary, Binary, MemberOnly)  \
if (OO_##Name != OO_Conditional)                                             \
  Results.AddResult(Result(Spelling));
6773#include "clang/Basic/OperatorKinds.def"

// Add any type names visible from the current scope
Results.allowNestedNameSpecifiers();
CodeCompletionDeclConsumer Consumer(Results, CurContext);
LookupVisibleDecls(S, LookupOrdinaryName, Consumer,
                   CodeCompleter->includeGlobals(),
                   CodeCompleter->loadExternal());

// Add any type specifiers
AddTypeSpecifierResults(getLangOpts(), Results);
Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
6788}

6790void Sema::CodeCompleteConstructorInitializer(
  Decl *ConstructorD, ArrayRef<CXXCtorInitializer *> Initializers) {
if (!ConstructorD)
  return;

AdjustDeclIfTemplate(ConstructorD);

auto *Constructor = dyn_cast<CXXConstructorDecl>(ConstructorD);
if (!Constructor)
  return;

ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Symbol);
Results.EnterNewScope();

// Fill in any already-initialized fields or base classes.
llvm::SmallPtrSet<FieldDecl *, 4> InitializedFields;
llvm::SmallPtrSet<CanQualType, 4> InitializedBases;
for (unsigned I = 0, E = Initializers.size(); I != E; ++I) {
  if (Initializers[I]->isBaseInitializer())
    InitializedBases.insert(Context.getCanonicalType(
        QualType(Initializers[I]->getBaseClass(), 0)));
  else
    InitializedFields.insert(
        cast<FieldDecl>(Initializers[I]->getAnyMember()));
}

// Add completions for base classes.
PrintingPolicy Policy = getCompletionPrintingPolicy(*this);
bool SawLastInitializer = Initializers.empty();
CXXRecordDecl *ClassDecl = Constructor->getParent();

auto GenerateCCS = [&](const NamedDecl *ND, const char *Name) {
  CodeCompletionBuilder Builder(Results.getAllocator(),
                                Results.getCodeCompletionTUInfo());
  Builder.AddTypedTextChunk(Name);
  Builder.AddChunk(CodeCompletionString::CK_LeftParen);
  if (const auto *Function = dyn_cast<FunctionDecl>(ND))
    AddFunctionParameterChunks(PP, Policy, Function, Builder);
  else if (const auto *FunTemplDecl = dyn_cast<FunctionTemplateDecl>(ND))
    AddFunctionParameterChunks(PP, Policy, FunTemplDecl->getTemplatedDecl(),
                               Builder);
  Builder.AddChunk(CodeCompletionString::CK_RightParen);
  return Builder.TakeString();
};
auto AddDefaultCtorInit = [&](const char *Name, const char *Type,
                              const NamedDecl *ND) {
  CodeCompletionBuilder Builder(Results.getAllocator(),
                                Results.getCodeCompletionTUInfo());
  Builder.AddTypedTextChunk(Name);
  Builder.AddChunk(CodeCompletionString::CK_LeftParen);
  Builder.AddPlaceholderChunk(Type);
  Builder.AddChunk(CodeCompletionString::CK_RightParen);
  if (ND) {
    auto CCR = CodeCompletionResult(
        Builder.TakeString(), ND,
        SawLastInitializer ? CCP_NextInitializer : CCP_MemberDeclaration);
    if (isa<FieldDecl>(ND))
      CCR.CursorKind = CXCursor_MemberRef;
    return Results.AddResult(CCR);
  }
  return Results.AddResult(CodeCompletionResult(
      Builder.TakeString(),
      SawLastInitializer ? CCP_NextInitializer : CCP_MemberDeclaration));
};
auto AddCtorsWithName = [&](const CXXRecordDecl *RD, unsigned int Priority,
                            const char *Name, const FieldDecl *FD) {
  if (!RD)
    return AddDefaultCtorInit(Name,
                              FD ? Results.getAllocator().CopyString(
                                       FD->getType().getAsString(Policy))
                                 : Name,
                              FD);
  auto Ctors = getConstructors(Context, RD);
  if (Ctors.begin() == Ctors.end())
    return AddDefaultCtorInit(Name, Name, RD);
  for (const NamedDecl *Ctor : Ctors) {
    auto CCR = CodeCompletionResult(GenerateCCS(Ctor, Name), RD, Priority);
    CCR.CursorKind = getCursorKindForDecl(Ctor);
    Results.AddResult(CCR);
  }
};
auto AddBase = [&](const CXXBaseSpecifier &Base) {
  const char *BaseName =
      Results.getAllocator().CopyString(Base.getType().getAsString(Policy));
  const auto *RD = Base.getType()->getAsCXXRecordDecl();
  AddCtorsWithName(
      RD, SawLastInitializer ? CCP_NextInitializer : CCP_MemberDeclaration,
      BaseName, nullptr);
};
auto AddField = [&](const FieldDecl *FD) {
  const char *FieldName =
      Results.getAllocator().CopyString(FD->getIdentifier()->getName());
  const CXXRecordDecl *RD = FD->getType()->getAsCXXRecordDecl();
  AddCtorsWithName(
      RD, SawLastInitializer ? CCP_NextInitializer : CCP_MemberDeclaration,
      FieldName, FD);
};

for (const auto &Base : ClassDecl->bases()) {
  if (!InitializedBases.insert(Context.getCanonicalType(Base.getType()))
           .second) {
    SawLastInitializer =
        !Initializers.empty() && Initializers.back()->isBaseInitializer() &&
        Context.hasSameUnqualifiedType(
            Base.getType(), QualType(Initializers.back()->getBaseClass(), 0));
    continue;
  }

  AddBase(Base);
  SawLastInitializer = false;
}

// Add completions for virtual base classes.
for (const auto &Base : ClassDecl->vbases()) {
  if (!InitializedBases.insert(Context.getCanonicalType(Base.getType()))
           .second) {
    SawLastInitializer =
        !Initializers.empty() && Initializers.back()->isBaseInitializer() &&
        Context.hasSameUnqualifiedType(
            Base.getType(), QualType(Initializers.back()->getBaseClass(), 0));
    continue;
  }

  AddBase(Base);
  SawLastInitializer = false;
}

// Add completions for members.
for (auto *Field : ClassDecl->fields()) {
  if (!InitializedFields.insert(cast<FieldDecl>(Field->getCanonicalDecl()))
           .second) {
    SawLastInitializer = !Initializers.empty() &&
                         Initializers.back()->isAnyMemberInitializer() &&
                         Initializers.back()->getAnyMember() == Field;
    continue;
  }

  if (!Field->getDeclName())
    continue;

  AddField(Field);
  SawLastInitializer = false;
}
Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
6939}

6941/// Determine whether this scope denotes a namespace.
6942static bool isNamespaceScope(Scope *S) {
DeclContext *DC = S->getEntity();
if (!DC)
  return false;

return DC->isFileContext();
6948}

6950void Sema::CodeCompleteLambdaIntroducer(Scope *S, LambdaIntroducer &Intro,
                                      bool AfterAmpersand) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();

// Note what has already been captured.
llvm::SmallPtrSet<IdentifierInfo *, 4> Known;
bool IncludedThis = false;
for (const auto &C : Intro.Captures) {
  if (C.Kind == LCK_This) {
    IncludedThis = true;
    continue;
  }

  Known.insert(C.Id);
}

// Look for other capturable variables.
for (; S && !isNamespaceScope(S); S = S->getParent()) {
  for (const auto *D : S->decls()) {
    const auto *Var = dyn_cast<VarDecl>(D);
    if (!Var || !Var->hasLocalStorage() || Var->hasAttr<BlocksAttr>())
      continue;

    if (Known.insert(Var->getIdentifier()).second)
      Results.AddResult(CodeCompletionResult(Var, CCP_LocalDeclaration),
                        CurContext, nullptr, false);
  }
}

// Add 'this', if it would be valid.
if (!IncludedThis && !AfterAmpersand && Intro.Default != LCD_ByCopy)
  addThisCompletion(*this, Results);

Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
6990}

6992void Sema::CodeCompleteAfterFunctionEquals(Declarator &D) {
if (!LangOpts.CPlusPlus11)
  return;
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
auto ShouldAddDefault = [&D, this]() {
  if (!D.isFunctionDeclarator())
    return false;
  auto &Id = D.getName();
  if (Id.getKind() == UnqualifiedIdKind::IK_DestructorName)
    return true;
  // FIXME(liuhui): Ideally, we should check the constructor parameter list to
  // verify that it is the default, copy or move constructor?
  if (Id.getKind() == UnqualifiedIdKind::IK_ConstructorName &&
      D.getFunctionTypeInfo().NumParams <= 1)
    return true;
  if (Id.getKind() == UnqualifiedIdKind::IK_OperatorFunctionId) {
    auto Op = Id.OperatorFunctionId.Operator;
    // FIXME(liuhui): Ideally, we should check the function parameter list to
    // verify that it is the copy or move assignment?
    if (Op == OverloadedOperatorKind::OO_Equal)
      return true;
    if (LangOpts.CPlusPlus20 &&
        (Op == OverloadedOperatorKind::OO_EqualEqual ||
         Op == OverloadedOperatorKind::OO_ExclaimEqual ||
         Op == OverloadedOperatorKind::OO_Less ||
         Op == OverloadedOperatorKind::OO_LessEqual ||
         Op == OverloadedOperatorKind::OO_Greater ||
         Op == OverloadedOperatorKind::OO_GreaterEqual ||
         Op == OverloadedOperatorKind::OO_Spaceship))
      return true;
  }
  return false;
};

Results.EnterNewScope();
if (ShouldAddDefault())
  Results.AddResult("default");
// FIXME(liuhui): Ideally, we should only provide `delete` completion for the
// first function declaration.
Results.AddResult("delete");
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
7037}

7039/// Macro that optionally prepends an "@" to the string literal passed in via
7040/// Keyword, depending on whether NeedAt is true or false.
7041#define OBJC_AT_KEYWORD_NAME(NeedAt, Keyword)((NeedAt) ? "@" Keyword : Keyword) ((NeedAt) ? "@" Keyword : Keyword)

7043static void AddObjCImplementationResults(const LangOptions &LangOpts,
                                       ResultBuilder &Results, bool NeedAt) {
typedef CodeCompletionResult Result;
// Since we have an implementation, we can end it.
Results.AddResult(Result(OBJC_AT_KEYWORD_NAME(NeedAt, "end")((NeedAt) ? "@" "end" : "end")));

CodeCompletionBuilder Builder(Results.getAllocator(),
                              Results.getCodeCompletionTUInfo());
if (LangOpts.ObjC) {
  // @dynamic
  Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "dynamic")((NeedAt) ? "@" "dynamic" : "dynamic"));
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("property");
  Results.AddResult(Result(Builder.TakeString()));

  // @synthesize
  Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "synthesize")((NeedAt) ? "@" "synthesize" : "synthesize"));
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("property");
  Results.AddResult(Result(Builder.TakeString()));
}
7064}

7066static void AddObjCInterfaceResults(const LangOptions &LangOpts,
                                  ResultBuilder &Results, bool NeedAt) {
typedef CodeCompletionResult Result;

// Since we have an interface or protocol, we can end it.
Results.AddResult(Result(OBJC_AT_KEYWORD_NAME(NeedAt, "end")((NeedAt) ? "@" "end" : "end")));

if (LangOpts.ObjC) {
  // @property
  Results.AddResult(Result(OBJC_AT_KEYWORD_NAME(NeedAt, "property")((NeedAt) ? "@" "property" : "property")));

  // @required
  Results.AddResult(Result(OBJC_AT_KEYWORD_NAME(NeedAt, "required")((NeedAt) ? "@" "required" : "required")));

  // @optional
  Results.AddResult(Result(OBJC_AT_KEYWORD_NAME(NeedAt, "optional")((NeedAt) ? "@" "optional" : "optional")));
}
7083}

7085static void AddObjCTopLevelResults(ResultBuilder &Results, bool NeedAt) {
typedef CodeCompletionResult Result;
CodeCompletionBuilder Builder(Results.getAllocator(),
                              Results.getCodeCompletionTUInfo());

// @class name ;
Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "class")((NeedAt) ? "@" "class" : "class"));
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("name");
Results.AddResult(Result(Builder.TakeString()));

if (Results.includeCodePatterns()) {
  // @interface name
  // FIXME: Could introduce the whole pattern, including superclasses and
  // such.
  Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "interface")((NeedAt) ? "@" "interface" : "interface"));
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("class");
  Results.AddResult(Result(Builder.TakeString()));

  // @protocol name
  Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "protocol")((NeedAt) ? "@" "protocol" : "protocol"));
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("protocol");
  Results.AddResult(Result(Builder.TakeString()));

  // @implementation name
  Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "implementation")((NeedAt) ? "@" "implementation" : "implementation"));
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("class");
  Results.AddResult(Result(Builder.TakeString()));
}

// @compatibility_alias name
Builder.AddTypedTextChunk(
    OBJC_AT_KEYWORD_NAME(NeedAt, "compatibility_alias")((NeedAt) ? "@" "compatibility_alias" : "compatibility_alias"
));
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("alias");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("class");
Results.AddResult(Result(Builder.TakeString()));

if (Results.getSema().getLangOpts().Modules) {
  // @import name
  Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "import")((NeedAt) ? "@" "import" : "import"));
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("module");
  Results.AddResult(Result(Builder.TakeString()));
}
7134}

7136void Sema::CodeCompleteObjCAtDirective(Scope *S) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();
if (isa<ObjCImplDecl>(CurContext))
  AddObjCImplementationResults(getLangOpts(), Results, false);
else if (CurContext->isObjCContainer())
  AddObjCInterfaceResults(getLangOpts(), Results, false);
else
  AddObjCTopLevelResults(Results, false);
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
7150}

7152static void AddObjCExpressionResults(ResultBuilder &Results, bool NeedAt) {
typedef CodeCompletionResult Result;
CodeCompletionBuilder Builder(Results.getAllocator(),
                              Results.getCodeCompletionTUInfo());

// @encode ( type-name )
const char *EncodeType = "char[]";
if (Results.getSema().getLangOpts().CPlusPlus ||
    Results.getSema().getLangOpts().ConstStrings)
  EncodeType = "const char[]";
Builder.AddResultTypeChunk(EncodeType);
Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "encode")((NeedAt) ? "@" "encode" : "encode"));
Builder.AddChunk(CodeCompletionString::CK_LeftParen);
Builder.AddPlaceholderChunk("type-name");
Builder.AddChunk(CodeCompletionString::CK_RightParen);
Results.AddResult(Result(Builder.TakeString()));

// @protocol ( protocol-name )
Builder.AddResultTypeChunk("Protocol *");
Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "protocol")((NeedAt) ? "@" "protocol" : "protocol"));
Builder.AddChunk(CodeCompletionString::CK_LeftParen);
Builder.AddPlaceholderChunk("protocol-name");
Builder.AddChunk(CodeCompletionString::CK_RightParen);
Results.AddResult(Result(Builder.TakeString()));

// @selector ( selector )
Builder.AddResultTypeChunk("SEL");
Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "selector")((NeedAt) ? "@" "selector" : "selector"));
Builder.AddChunk(CodeCompletionString::CK_LeftParen);
Builder.AddPlaceholderChunk("selector");
Builder.AddChunk(CodeCompletionString::CK_RightParen);
Results.AddResult(Result(Builder.TakeString()));

// @"string"
Builder.AddResultTypeChunk("NSString *");
Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "\"")((NeedAt) ? "@" "\"" : "\""));
Builder.AddPlaceholderChunk("string");
Builder.AddTextChunk("\"");
Results.AddResult(Result(Builder.TakeString()));

// @[objects, ...]
Builder.AddResultTypeChunk("NSArray *");
Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "[")((NeedAt) ? "@" "[" : "["));
Builder.AddPlaceholderChunk("objects, ...");
Builder.AddChunk(CodeCompletionString::CK_RightBracket);
Results.AddResult(Result(Builder.TakeString()));

// @{key : object, ...}
Builder.AddResultTypeChunk("NSDictionary *");
Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "{")((NeedAt) ? "@" "{" : "{"));
Builder.AddPlaceholderChunk("key");
Builder.AddChunk(CodeCompletionString::CK_Colon);
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("object, ...");
Builder.AddChunk(CodeCompletionString::CK_RightBrace);
Results.AddResult(Result(Builder.TakeString()));

// @(expression)
Builder.AddResultTypeChunk("id");
Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "(")((NeedAt) ? "@" "(" : "("));
Builder.AddPlaceholderChunk("expression");
Builder.AddChunk(CodeCompletionString::CK_RightParen);
Results.AddResult(Result(Builder.TakeString()));
7215}

7217static void AddObjCStatementResults(ResultBuilder &Results, bool NeedAt) {
typedef CodeCompletionResult Result;
CodeCompletionBuilder Builder(Results.getAllocator(),
                              Results.getCodeCompletionTUInfo());

if (Results.includeCodePatterns()) {
  // @try { statements } @catch ( declaration ) { statements } @finally
  //   { statements }
  Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "try")((NeedAt) ? "@" "try" : "try"));
  Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
  Builder.AddPlaceholderChunk("statements");
  Builder.AddChunk(CodeCompletionString::CK_RightBrace);
  Builder.AddTextChunk("@catch");
  Builder.AddChunk(CodeCompletionString::CK_LeftParen);
  Builder.AddPlaceholderChunk("parameter");
  Builder.AddChunk(CodeCompletionString::CK_RightParen);
  Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
  Builder.AddPlaceholderChunk("statements");
  Builder.AddChunk(CodeCompletionString::CK_RightBrace);
  Builder.AddTextChunk("@finally");
  Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
  Builder.AddPlaceholderChunk("statements");
  Builder.AddChunk(CodeCompletionString::CK_RightBrace);
  Results.AddResult(Result(Builder.TakeString()));
}

// @throw
Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "throw")((NeedAt) ? "@" "throw" : "throw"));
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("expression");
Results.AddResult(Result(Builder.TakeString()));

if (Results.includeCodePatterns()) {
  // @synchronized ( expression ) { statements }
  Builder.AddTypedTextChunk(OBJC_AT_KEYWORD_NAME(NeedAt, "synchronized")((NeedAt) ? "@" "synchronized" : "synchronized"));
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddChunk(CodeCompletionString::CK_LeftParen);
  Builder.AddPlaceholderChunk("expression");
  Builder.AddChunk(CodeCompletionString::CK_RightParen);
  Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
  Builder.AddPlaceholderChunk("statements");
  Builder.AddChunk(CodeCompletionString::CK_RightBrace);
  Results.AddResult(Result(Builder.TakeString()));
}
7261}

7263static void AddObjCVisibilityResults(const LangOptions &LangOpts,
                                   ResultBuilder &Results, bool NeedAt) {
typedef CodeCompletionResult Result;
Results.AddResult(Result(OBJC_AT_KEYWORD_NAME(NeedAt, "private")((NeedAt) ? "@" "private" : "private")));
Results.AddResult(Result(OBJC_AT_KEYWORD_NAME(NeedAt, "protected")((NeedAt) ? "@" "protected" : "protected")));
Results.AddResult(Result(OBJC_AT_KEYWORD_NAME(NeedAt, "public")((NeedAt) ? "@" "public" : "public")));
if (LangOpts.ObjC)
  Results.AddResult(Result(OBJC_AT_KEYWORD_NAME(NeedAt, "package")((NeedAt) ? "@" "package" : "package")));
7271}

7273void Sema::CodeCompleteObjCAtVisibility(Scope *S) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();
AddObjCVisibilityResults(getLangOpts(), Results, false);
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
7282}

7284void Sema::CodeCompleteObjCAtStatement(Scope *S) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();
AddObjCStatementResults(Results, false);
AddObjCExpressionResults(Results, false);
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
7294}

7296void Sema::CodeCompleteObjCAtExpression(Scope *S) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();
AddObjCExpressionResults(Results, false);
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
7305}

7307/// Determine whether the addition of the given flag to an Objective-C
7308/// property's attributes will cause a conflict.
7309static bool ObjCPropertyFlagConflicts(unsigned Attributes, unsigned NewFlag) {
// Check if we've already added this flag.
if (Attributes & NewFlag)
  return true;

Attributes |= NewFlag;

// Check for collisions with "readonly".
if ((Attributes & ObjCPropertyAttribute::kind_readonly) &&
    (Attributes & ObjCPropertyAttribute::kind_readwrite))
  return true;

// Check for more than one of { assign, copy, retain, strong, weak }.
unsigned AssignCopyRetMask =
    Attributes &
    (ObjCPropertyAttribute::kind_assign |
     ObjCPropertyAttribute::kind_unsafe_unretained |
     ObjCPropertyAttribute::kind_copy | ObjCPropertyAttribute::kind_retain |
     ObjCPropertyAttribute::kind_strong | ObjCPropertyAttribute::kind_weak);
if (AssignCopyRetMask &&
    AssignCopyRetMask != ObjCPropertyAttribute::kind_assign &&
    AssignCopyRetMask != ObjCPropertyAttribute::kind_unsafe_unretained &&
    AssignCopyRetMask != ObjCPropertyAttribute::kind_copy &&
    AssignCopyRetMask != ObjCPropertyAttribute::kind_retain &&
    AssignCopyRetMask != ObjCPropertyAttribute::kind_strong &&
    AssignCopyRetMask != ObjCPropertyAttribute::kind_weak)
  return true;

return false;
7338}

7340void Sema::CodeCompleteObjCPropertyFlags(Scope *S, ObjCDeclSpec &ODS) {
if (!CodeCompleter)
  return;

unsigned Attributes = ODS.getPropertyAttributes();

ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();
if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_readonly))
  Results.AddResult(CodeCompletionResult("readonly"));
if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_assign))
  Results.AddResult(CodeCompletionResult("assign"));
if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_unsafe_unretained))
  Results.AddResult(CodeCompletionResult("unsafe_unretained"));
if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_readwrite))
  Results.AddResult(CodeCompletionResult("readwrite"));
if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_retain))
  Results.AddResult(CodeCompletionResult("retain"));
if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_strong))
  Results.AddResult(CodeCompletionResult("strong"));
if (!ObjCPropertyFlagConflicts(Attributes, ObjCPropertyAttribute::kind_copy))
  Results.AddResult(CodeCompletionResult("copy"));
if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_nonatomic))
  Results.AddResult(CodeCompletionResult("nonatomic"));
if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_atomic))
  Results.AddResult(CodeCompletionResult("atomic"));

// Only suggest "weak" if we're compiling for ARC-with-weak-references or GC.
if (getLangOpts().ObjCWeak || getLangOpts().getGC() != LangOptions::NonGC)
  if (!ObjCPropertyFlagConflicts(Attributes,
                                 ObjCPropertyAttribute::kind_weak))
    Results.AddResult(CodeCompletionResult("weak"));

if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_setter)) {
  CodeCompletionBuilder Setter(Results.getAllocator(),
                               Results.getCodeCompletionTUInfo());
  Setter.AddTypedTextChunk("setter");
  Setter.AddTextChunk("=");
  Setter.AddPlaceholderChunk("method");
  Results.AddResult(CodeCompletionResult(Setter.TakeString()));
}
if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_getter)) {
  CodeCompletionBuilder Getter(Results.getAllocator(),
                               Results.getCodeCompletionTUInfo());
  Getter.AddTypedTextChunk("getter");
  Getter.AddTextChunk("=");
  Getter.AddPlaceholderChunk("method");
  Results.AddResult(CodeCompletionResult(Getter.TakeString()));
}
if (!ObjCPropertyFlagConflicts(Attributes,
                               ObjCPropertyAttribute::kind_nullability)) {
  Results.AddResult(CodeCompletionResult("nonnull"));
  Results.AddResult(CodeCompletionResult("nullable"));
  Results.AddResult(CodeCompletionResult("null_unspecified"));
  Results.AddResult(CodeCompletionResult("null_resettable"));
}
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
7411}

7413/// Describes the kind of Objective-C method that we want to find
7414/// via code completion.
7415enum ObjCMethodKind {
MK_Any, ///< Any kind of method, provided it means other specified criteria.
MK_ZeroArgSelector, ///< Zero-argument (unary) selector.
MK_OneArgSelector   ///< One-argument selector.
7419};

7421static bool isAcceptableObjCSelector(Selector Sel, ObjCMethodKind WantKind,
                                   ArrayRef<IdentifierInfo *> SelIdents,
                                   bool AllowSameLength = true) {
unsigned NumSelIdents = SelIdents.size();
if (NumSelIdents > Sel.getNumArgs())
  return false;

switch (WantKind) {
case MK_Any:
  break;
case MK_ZeroArgSelector:
  return Sel.isUnarySelector();
case MK_OneArgSelector:
  return Sel.getNumArgs() == 1;
}

if (!AllowSameLength && NumSelIdents && NumSelIdents == Sel.getNumArgs())
  return false;

for (unsigned I = 0; I != NumSelIdents; ++I)
  if (SelIdents[I] != Sel.getIdentifierInfoForSlot(I))
    return false;

return true;
7445}

7447static bool isAcceptableObjCMethod(ObjCMethodDecl *Method,
                                 ObjCMethodKind WantKind,
                                 ArrayRef<IdentifierInfo *> SelIdents,
                                 bool AllowSameLength = true) {
return isAcceptableObjCSelector(Method->getSelector(), WantKind, SelIdents,
                                AllowSameLength);
7453}

7455/// A set of selectors, which is used to avoid introducing multiple
7456/// completions with the same selector into the result set.
7457typedef llvm::SmallPtrSet<Selector, 16> VisitedSelectorSet;

7459/// Add all of the Objective-C methods in the given Objective-C
7460/// container to the set of results.
7461///
7462/// The container will be a class, protocol, category, or implementation of
7463/// any of the above. This mether will recurse to include methods from
7464/// the superclasses of classes along with their categories, protocols, and
7465/// implementations.
7466///
7467/// \param Container the container in which we'll look to find methods.
7468///
7469/// \param WantInstanceMethods Whether to add instance methods (only); if
7470/// false, this routine will add factory methods (only).
7471///
7472/// \param CurContext the context in which we're performing the lookup that
7473/// finds methods.
7474///
7475/// \param AllowSameLength Whether we allow a method to be added to the list
7476/// when it has the same number of parameters as we have selector identifiers.
7477///
7478/// \param Results the structure into which we'll add results.
7479static void AddObjCMethods(ObjCContainerDecl *Container,
                         bool WantInstanceMethods, ObjCMethodKind WantKind,
                         ArrayRef<IdentifierInfo *> SelIdents,
                         DeclContext *CurContext,
                         VisitedSelectorSet &Selectors, bool AllowSameLength,
                         ResultBuilder &Results, bool InOriginalClass = true,
                         bool IsRootClass = false) {
typedef CodeCompletionResult Result;
Container = getContainerDef(Container);
ObjCInterfaceDecl *IFace = dyn_cast<ObjCInterfaceDecl>(Container);
IsRootClass = IsRootClass || (IFace && !IFace->getSuperClass());
for (ObjCMethodDecl *M : Container->methods()) {
  // The instance methods on the root class can be messaged via the
  // metaclass.
  if (M->isInstanceMethod() == WantInstanceMethods ||
      (IsRootClass && !WantInstanceMethods)) {
    // Check whether the selector identifiers we've been given are a
    // subset of the identifiers for this particular method.
    if (!isAcceptableObjCMethod(M, WantKind, SelIdents, AllowSameLength))
      continue;

    if (!Selectors.insert(M->getSelector()).second)
      continue;

    Result R = Result(M, Results.getBasePriority(M), nullptr);
    R.StartParameter = SelIdents.size();
    R.AllParametersAreInformative = (WantKind != MK_Any);
    if (!InOriginalClass)
      setInBaseClass(R);
    Results.MaybeAddResult(R, CurContext);
  }
}

// Visit the protocols of protocols.
if (const auto *Protocol = dyn_cast<ObjCProtocolDecl>(Container)) {
  if (Protocol->hasDefinition()) {
    const ObjCList<ObjCProtocolDecl> &Protocols =
        Protocol->getReferencedProtocols();
    for (ObjCList<ObjCProtocolDecl>::iterator I = Protocols.begin(),
                                              E = Protocols.end();
         I != E; ++I)
      AddObjCMethods(*I, WantInstanceMethods, WantKind, SelIdents, CurContext,
                     Selectors, AllowSameLength, Results, false, IsRootClass);
  }
}

if (!IFace || !IFace->hasDefinition())
  return;

// Add methods in protocols.
for (ObjCProtocolDecl *I : IFace->protocols())
  AddObjCMethods(I, WantInstanceMethods, WantKind, SelIdents, CurContext,
                 Selectors, AllowSameLength, Results, false, IsRootClass);

// Add methods in categories.
for (ObjCCategoryDecl *CatDecl : IFace->known_categories()) {
  AddObjCMethods(CatDecl, WantInstanceMethods, WantKind, SelIdents,
                 CurContext, Selectors, AllowSameLength, Results,
                 InOriginalClass, IsRootClass);

  // Add a categories protocol methods.
  const ObjCList<ObjCProtocolDecl> &Protocols =
      CatDecl->getReferencedProtocols();
  for (ObjCList<ObjCProtocolDecl>::iterator I = Protocols.begin(),
                                            E = Protocols.end();
       I != E; ++I)
    AddObjCMethods(*I, WantInstanceMethods, WantKind, SelIdents, CurContext,
                   Selectors, AllowSameLength, Results, false, IsRootClass);

  // Add methods in category implementations.
  if (ObjCCategoryImplDecl *Impl = CatDecl->getImplementation())
    AddObjCMethods(Impl, WantInstanceMethods, WantKind, SelIdents, CurContext,
                   Selectors, AllowSameLength, Results, InOriginalClass,
                   IsRootClass);
}

// Add methods in superclass.
// Avoid passing in IsRootClass since root classes won't have super classes.
if (IFace->getSuperClass())
  AddObjCMethods(IFace->getSuperClass(), WantInstanceMethods, WantKind,
                 SelIdents, CurContext, Selectors, AllowSameLength, Results,
                 /*IsRootClass=*/false);

// Add methods in our implementation, if any.
if (ObjCImplementationDecl *Impl = IFace->getImplementation())
  AddObjCMethods(Impl, WantInstanceMethods, WantKind, SelIdents, CurContext,
                 Selectors, AllowSameLength, Results, InOriginalClass,
                 IsRootClass);
7567}

7569void Sema::CodeCompleteObjCPropertyGetter(Scope *S) {
// Try to find the interface where getters might live.
ObjCInterfaceDecl *Class = dyn_cast_or_null<ObjCInterfaceDecl>(CurContext);
if (!Class) {
  if (ObjCCategoryDecl *Category =
          dyn_cast_or_null<ObjCCategoryDecl>(CurContext))
    Class = Category->getClassInterface();

  if (!Class)
    return;
}

// Find all of the potential getters.
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();

VisitedSelectorSet Selectors;
AddObjCMethods(Class, true, MK_ZeroArgSelector, std::nullopt, CurContext,
               Selectors,
               /*AllowSameLength=*/true, Results);
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
7594}

7596void Sema::CodeCompleteObjCPropertySetter(Scope *S) {
// Try to find the interface where setters might live.
ObjCInterfaceDecl *Class = dyn_cast_or_null<ObjCInterfaceDecl>(CurContext);
if (!Class) {
  if (ObjCCategoryDecl *Category =
          dyn_cast_or_null<ObjCCategoryDecl>(CurContext))
    Class = Category->getClassInterface();

  if (!Class)
    return;
}

// Find all of the potential getters.
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();

VisitedSelectorSet Selectors;
AddObjCMethods(Class, true, MK_OneArgSelector, std::nullopt, CurContext,
               Selectors,
               /*AllowSameLength=*/true, Results);

Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
7622}

7624void Sema::CodeCompleteObjCPassingType(Scope *S, ObjCDeclSpec &DS,
                                     bool IsParameter) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Type);
Results.EnterNewScope();

// Add context-sensitive, Objective-C parameter-passing keywords.
bool AddedInOut = false;
if ((DS.getObjCDeclQualifier() &
     (ObjCDeclSpec::DQ_In | ObjCDeclSpec::DQ_Inout)) == 0) {
  Results.AddResult("in");
  Results.AddResult("inout");
  AddedInOut = true;
}
if ((DS.getObjCDeclQualifier() &
     (ObjCDeclSpec::DQ_Out | ObjCDeclSpec::DQ_Inout)) == 0) {
  Results.AddResult("out");
  if (!AddedInOut)
    Results.AddResult("inout");
}
if ((DS.getObjCDeclQualifier() &
     (ObjCDeclSpec::DQ_Bycopy | ObjCDeclSpec::DQ_Byref |
      ObjCDeclSpec::DQ_Oneway)) == 0) {
  Results.AddResult("bycopy");
  Results.AddResult("byref");
  Results.AddResult("oneway");
}
if ((DS.getObjCDeclQualifier() & ObjCDeclSpec::DQ_CSNullability) == 0) {
  Results.AddResult("nonnull");
  Results.AddResult("nullable");
  Results.AddResult("null_unspecified");
}

// If we're completing the return type of an Objective-C method and the
// identifier IBAction refers to a macro, provide a completion item for
// an action, e.g.,
//   IBAction)<#selector#>:(id)sender
if (DS.getObjCDeclQualifier() == 0 && !IsParameter &&
    PP.isMacroDefined("IBAction")) {
  CodeCompletionBuilder Builder(Results.getAllocator(),
                                Results.getCodeCompletionTUInfo(),
                                CCP_CodePattern, CXAvailability_Available);
  Builder.AddTypedTextChunk("IBAction");
  Builder.AddChunk(CodeCompletionString::CK_RightParen);
  Builder.AddPlaceholderChunk("selector");
  Builder.AddChunk(CodeCompletionString::CK_Colon);
  Builder.AddChunk(CodeCompletionString::CK_LeftParen);
  Builder.AddTextChunk("id");
  Builder.AddChunk(CodeCompletionString::CK_RightParen);
  Builder.AddTextChunk("sender");
  Results.AddResult(CodeCompletionResult(Builder.TakeString()));
}

// If we're completing the return type, provide 'instancetype'.
if (!IsParameter) {
  Results.AddResult(CodeCompletionResult("instancetype"));
}

// Add various builtin type names and specifiers.
AddOrdinaryNameResults(PCC_Type, S, *this, Results);
Results.ExitScope();

// Add the various type names
Results.setFilter(&ResultBuilder::IsOrdinaryNonValueName);
CodeCompletionDeclConsumer Consumer(Results, CurContext);
LookupVisibleDecls(S, LookupOrdinaryName, Consumer,
                   CodeCompleter->includeGlobals(),
                   CodeCompleter->loadExternal());

if (CodeCompleter->includeMacros())
  AddMacroResults(PP, Results, CodeCompleter->loadExternal(), false);

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
7699}

7701/// When we have an expression with type "id", we may assume
7702/// that it has some more-specific class type based on knowledge of
7703/// common uses of Objective-C. This routine returns that class type,
7704/// or NULL if no better result could be determined.
7705static ObjCInterfaceDecl *GetAssumedMessageSendExprType(Expr *E) {
auto *Msg = dyn_cast_or_null<ObjCMessageExpr>(E);
if (!Msg)
  return nullptr;

Selector Sel = Msg->getSelector();
if (Sel.isNull())
  return nullptr;

IdentifierInfo *Id = Sel.getIdentifierInfoForSlot(0);
if (!Id)
  return nullptr;

ObjCMethodDecl *Method = Msg->getMethodDecl();
if (!Method)
  return nullptr;

// Determine the class that we're sending the message to.
ObjCInterfaceDecl *IFace = nullptr;
switch (Msg->getReceiverKind()) {
case ObjCMessageExpr::Class:
  if (const ObjCObjectType *ObjType =
          Msg->getClassReceiver()->getAs<ObjCObjectType>())
    IFace = ObjType->getInterface();
  break;

case ObjCMessageExpr::Instance: {
  QualType T = Msg->getInstanceReceiver()->getType();
  if (const ObjCObjectPointerType *Ptr = T->getAs<ObjCObjectPointerType>())
    IFace = Ptr->getInterfaceDecl();
  break;
}

case ObjCMessageExpr::SuperInstance:
case ObjCMessageExpr::SuperClass:
  break;
}

if (!IFace)
  return nullptr;

ObjCInterfaceDecl *Super = IFace->getSuperClass();
if (Method->isInstanceMethod())
  return llvm::StringSwitch<ObjCInterfaceDecl *>(Id->getName())
      .Case("retain", IFace)
      .Case("strong", IFace)
      .Case("autorelease", IFace)
      .Case("copy", IFace)
      .Case("copyWithZone", IFace)
      .Case("mutableCopy", IFace)
      .Case("mutableCopyWithZone", IFace)
      .Case("awakeFromCoder", IFace)
      .Case("replacementObjectFromCoder", IFace)
      .Case("class", IFace)
      .Case("classForCoder", IFace)
      .Case("superclass", Super)
      .Default(nullptr);

return llvm::StringSwitch<ObjCInterfaceDecl *>(Id->getName())
    .Case("new", IFace)
    .Case("alloc", IFace)
    .Case("allocWithZone", IFace)
    .Case("class", IFace)
    .Case("superclass", Super)
    .Default(nullptr);
7770}

7772// Add a special completion for a message send to "super", which fills in the
7773// most likely case of forwarding all of our arguments to the superclass
7774// function.
7775///
7776/// \param S The semantic analysis object.
7777///
7778/// \param NeedSuperKeyword Whether we need to prefix this completion with
7779/// the "super" keyword. Otherwise, we just need to provide the arguments.
7780///
7781/// \param SelIdents The identifiers in the selector that have already been
7782/// provided as arguments for a send to "super".
7783///
7784/// \param Results The set of results to augment.
7785///
7786/// \returns the Objective-C method declaration that would be invoked by
7787/// this "super" completion. If NULL, no completion was added.
7788static ObjCMethodDecl *
7789AddSuperSendCompletion(Sema &S, bool NeedSuperKeyword,
                     ArrayRef<IdentifierInfo *> SelIdents,
                     ResultBuilder &Results) {
ObjCMethodDecl *CurMethod = S.getCurMethodDecl();
if (!CurMethod)
  return nullptr;

ObjCInterfaceDecl *Class = CurMethod->getClassInterface();
if (!Class)
  return nullptr;

// Try to find a superclass method with the same selector.
ObjCMethodDecl *SuperMethod = nullptr;
while ((Class = Class->getSuperClass()) && !SuperMethod) {
  // Check in the class
  SuperMethod = Class->getMethod(CurMethod->getSelector(),
                                 CurMethod->isInstanceMethod());

  // Check in categories or class extensions.
  if (!SuperMethod) {
    for (const auto *Cat : Class->known_categories()) {
      if ((SuperMethod = Cat->getMethod(CurMethod->getSelector(),
                                        CurMethod->isInstanceMethod())))
        break;
    }
  }
}

if (!SuperMethod)
  return nullptr;

// Check whether the superclass method has the same signature.
if (CurMethod->param_size() != SuperMethod->param_size() ||
    CurMethod->isVariadic() != SuperMethod->isVariadic())
  return nullptr;

for (ObjCMethodDecl::param_iterator CurP = CurMethod->param_begin(),
                                    CurPEnd = CurMethod->param_end(),
                                    SuperP = SuperMethod->param_begin();
     CurP != CurPEnd; ++CurP, ++SuperP) {
  // Make sure the parameter types are compatible.
  if (!S.Context.hasSameUnqualifiedType((*CurP)->getType(),
                                        (*SuperP)->getType()))
    return nullptr;

  // Make sure we have a parameter name to forward!
  if (!(*CurP)->getIdentifier())
    return nullptr;
}

// We have a superclass method. Now, form the send-to-super completion.
CodeCompletionBuilder Builder(Results.getAllocator(),
                              Results.getCodeCompletionTUInfo());

// Give this completion a return type.
AddResultTypeChunk(S.Context, getCompletionPrintingPolicy(S), SuperMethod,
                   Results.getCompletionContext().getBaseType(), Builder);

// If we need the "super" keyword, add it (plus some spacing).
if (NeedSuperKeyword) {
  Builder.AddTypedTextChunk("super");
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
}

Selector Sel = CurMethod->getSelector();
if (Sel.isUnarySelector()) {
  if (NeedSuperKeyword)
    Builder.AddTextChunk(
        Builder.getAllocator().CopyString(Sel.getNameForSlot(0)));
  else
    Builder.AddTypedTextChunk(
        Builder.getAllocator().CopyString(Sel.getNameForSlot(0)));
} else {
  ObjCMethodDecl::param_iterator CurP = CurMethod->param_begin();
  for (unsigned I = 0, N = Sel.getNumArgs(); I != N; ++I, ++CurP) {
    if (I > SelIdents.size())
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);

    if (I < SelIdents.size())
      Builder.AddInformativeChunk(
          Builder.getAllocator().CopyString(Sel.getNameForSlot(I) + ":"));
    else if (NeedSuperKeyword || I > SelIdents.size()) {
      Builder.AddTextChunk(
          Builder.getAllocator().CopyString(Sel.getNameForSlot(I) + ":"));
      Builder.AddPlaceholderChunk(Builder.getAllocator().CopyString(
          (*CurP)->getIdentifier()->getName()));
    } else {
      Builder.AddTypedTextChunk(
          Builder.getAllocator().CopyString(Sel.getNameForSlot(I) + ":"));
      Builder.AddPlaceholderChunk(Builder.getAllocator().CopyString(
          (*CurP)->getIdentifier()->getName()));
    }
  }
}

Results.AddResult(CodeCompletionResult(Builder.TakeString(), SuperMethod,
                                       CCP_SuperCompletion));
return SuperMethod;
7887}

7889void Sema::CodeCompleteObjCMessageReceiver(Scope *S) {
typedef CodeCompletionResult Result;
ResultBuilder Results(
    *this, CodeCompleter->getAllocator(),
    CodeCompleter->getCodeCompletionTUInfo(),
    CodeCompletionContext::CCC_ObjCMessageReceiver,
    getLangOpts().CPlusPlus11
        ? &ResultBuilder::IsObjCMessageReceiverOrLambdaCapture
        : &ResultBuilder::IsObjCMessageReceiver);

CodeCompletionDeclConsumer Consumer(Results, CurContext);
Results.EnterNewScope();
LookupVisibleDecls(S, LookupOrdinaryName, Consumer,
                   CodeCompleter->includeGlobals(),
                   CodeCompleter->loadExternal());

// If we are in an Objective-C method inside a class that has a superclass,
// add "super" as an option.
if (ObjCMethodDecl *Method = getCurMethodDecl())
  if (ObjCInterfaceDecl *Iface = Method->getClassInterface())
    if (Iface->getSuperClass()) {
      Results.AddResult(Result("super"));

      AddSuperSendCompletion(*this, /*NeedSuperKeyword=*/true, std::nullopt,
                             Results);
    }

if (getLangOpts().CPlusPlus11)
  addThisCompletion(*this, Results);

Results.ExitScope();

if (CodeCompleter->includeMacros())
  AddMacroResults(PP, Results, CodeCompleter->loadExternal(), false);
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
7925}

7927void Sema::CodeCompleteObjCSuperMessage(Scope *S, SourceLocation SuperLoc,
                                      ArrayRef<IdentifierInfo *> SelIdents,
                                      bool AtArgumentExpression) {
ObjCInterfaceDecl *CDecl = nullptr;
if (ObjCMethodDecl *CurMethod = getCurMethodDecl()) {
  // Figure out which interface we're in.
  CDecl = CurMethod->getClassInterface();
  if (!CDecl)
    return;

  // Find the superclass of this class.
  CDecl = CDecl->getSuperClass();
  if (!CDecl)
    return;

  if (CurMethod->isInstanceMethod()) {
    // We are inside an instance method, which means that the message
    // send [super ...] is actually calling an instance method on the
    // current object.
    return CodeCompleteObjCInstanceMessage(S, nullptr, SelIdents,
                                           AtArgumentExpression, CDecl);
  }

  // Fall through to send to the superclass in CDecl.
} else {
  // "super" may be the name of a type or variable. Figure out which
  // it is.
  IdentifierInfo *Super = getSuperIdentifier();
  NamedDecl *ND = LookupSingleName(S, Super, SuperLoc, LookupOrdinaryName);
  if ((CDecl = dyn_cast_or_null<ObjCInterfaceDecl>(ND))) {
    // "super" names an interface. Use it.
  } else if (TypeDecl *TD = dyn_cast_or_null<TypeDecl>(ND)) {
    if (const ObjCObjectType *Iface =
            Context.getTypeDeclType(TD)->getAs<ObjCObjectType>())
      CDecl = Iface->getInterface();
  } else if (ND && isa<UnresolvedUsingTypenameDecl>(ND)) {
    // "super" names an unresolved type; we can't be more specific.
  } else {
    // Assume that "super" names some kind of value and parse that way.
    CXXScopeSpec SS;
    SourceLocation TemplateKWLoc;
    UnqualifiedId id;
    id.setIdentifier(Super, SuperLoc);
    ExprResult SuperExpr = ActOnIdExpression(S, SS, TemplateKWLoc, id,
                                             /*HasTrailingLParen=*/false,
                                             /*IsAddressOfOperand=*/false);
    return CodeCompleteObjCInstanceMessage(S, (Expr *)SuperExpr.get(),
                                           SelIdents, AtArgumentExpression);
  }

  // Fall through
}

ParsedType Receiver;
if (CDecl)
  Receiver = ParsedType::make(Context.getObjCInterfaceType(CDecl));
return CodeCompleteObjCClassMessage(S, Receiver, SelIdents,
                                    AtArgumentExpression,
                                    /*IsSuper=*/true);
7986}

7988/// Given a set of code-completion results for the argument of a message
7989/// send, determine the preferred type (if any) for that argument expression.
7990static QualType getPreferredArgumentTypeForMessageSend(ResultBuilder &Results,
                                                     unsigned NumSelIdents) {
typedef CodeCompletionResult Result;
ASTContext &Context = Results.getSema().Context;

QualType PreferredType;
unsigned BestPriority = CCP_Unlikely * 2;
Result *ResultsData = Results.data();
for (unsigned I = 0, N = Results.size(); I != N; ++I) {
  Result &R = ResultsData[I];
  if (R.Kind == Result::RK_Declaration &&
      isa<ObjCMethodDecl>(R.Declaration)) {
    if (R.Priority <= BestPriority) {
      const ObjCMethodDecl *Method = cast<ObjCMethodDecl>(R.Declaration);
      if (NumSelIdents <= Method->param_size()) {
        QualType MyPreferredType =
            Method->parameters()[NumSelIdents - 1]->getType();
        if (R.Priority < BestPriority || PreferredType.isNull()) {
          BestPriority = R.Priority;
          PreferredType = MyPreferredType;
        } else if (!Context.hasSameUnqualifiedType(PreferredType,
                                                   MyPreferredType)) {
          PreferredType = QualType();
        }
      }
    }
  }
}

return PreferredType;
8020}

8022static void AddClassMessageCompletions(Sema &SemaRef, Scope *S,
                                     ParsedType Receiver,
                                     ArrayRef<IdentifierInfo *> SelIdents,
                                     bool AtArgumentExpression, bool IsSuper,
                                     ResultBuilder &Results) {
typedef CodeCompletionResult Result;
ObjCInterfaceDecl *CDecl = nullptr;

// If the given name refers to an interface type, retrieve the
// corresponding declaration.
if (Receiver) {
  QualType T = SemaRef.GetTypeFromParser(Receiver, nullptr);
  if (!T.isNull())
    if (const ObjCObjectType *Interface = T->getAs<ObjCObjectType>())
      CDecl = Interface->getInterface();
}

// Add all of the factory methods in this Objective-C class, its protocols,
// superclasses, categories, implementation, etc.
Results.EnterNewScope();

// If this is a send-to-super, try to add the special "super" send
// completion.
if (IsSuper) {
  if (ObjCMethodDecl *SuperMethod =
          AddSuperSendCompletion(SemaRef, false, SelIdents, Results))
    Results.Ignore(SuperMethod);
}

// If we're inside an Objective-C method definition, prefer its selector to
// others.
if (ObjCMethodDecl *CurMethod = SemaRef.getCurMethodDecl())
  Results.setPreferredSelector(CurMethod->getSelector());

VisitedSelectorSet Selectors;
if (CDecl)
  AddObjCMethods(CDecl, false, MK_Any, SelIdents, SemaRef.CurContext,
                 Selectors, AtArgumentExpression, Results);
else {
  // We're messaging "id" as a type; provide all class/factory methods.

  // If we have an external source, load the entire class method
  // pool from the AST file.
  if (SemaRef.getExternalSource()) {
    for (uint32_t I = 0,
                  N = SemaRef.getExternalSource()->GetNumExternalSelectors();
         I != N; ++I) {
      Selector Sel = SemaRef.getExternalSource()->GetExternalSelector(I);
      if (Sel.isNull() || SemaRef.MethodPool.count(Sel))
        continue;

      SemaRef.ReadMethodPool(Sel);
    }
  }

  for (Sema::GlobalMethodPool::iterator M = SemaRef.MethodPool.begin(),
                                        MEnd = SemaRef.MethodPool.end();
       M != MEnd; ++M) {
    for (ObjCMethodList *MethList = &M->second.second;
         MethList && MethList->getMethod(); MethList = MethList->getNext()) {
      if (!isAcceptableObjCMethod(MethList->getMethod(), MK_Any, SelIdents))
        continue;

      Result R(MethList->getMethod(),
               Results.getBasePriority(MethList->getMethod()), nullptr);
      R.StartParameter = SelIdents.size();
      R.AllParametersAreInformative = false;
      Results.MaybeAddResult(R, SemaRef.CurContext);
    }
  }
}

Results.ExitScope();
8095}

8097void Sema::CodeCompleteObjCClassMessage(Scope *S, ParsedType Receiver,
                                      ArrayRef<IdentifierInfo *> SelIdents,
                                      bool AtArgumentExpression,
                                      bool IsSuper) {

QualType T = this->GetTypeFromParser(Receiver);

ResultBuilder Results(
    *this, CodeCompleter->getAllocator(),
    CodeCompleter->getCodeCompletionTUInfo(),
    CodeCompletionContext(CodeCompletionContext::CCC_ObjCClassMessage, T,
                          SelIdents));

AddClassMessageCompletions(*this, S, Receiver, SelIdents,
                           AtArgumentExpression, IsSuper, Results);

// If we're actually at the argument expression (rather than prior to the
// selector), we're actually performing code completion for an expression.
// Determine whether we have a single, best method. If so, we can
// code-complete the expression using the corresponding parameter type as
// our preferred type, improving completion results.
if (AtArgumentExpression) {
  QualType PreferredType =
      getPreferredArgumentTypeForMessageSend(Results, SelIdents.size());
  if (PreferredType.isNull())
    CodeCompleteOrdinaryName(S, PCC_Expression);
  else
    CodeCompleteExpression(S, PreferredType);
  return;
}

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8130}

8132void Sema::CodeCompleteObjCInstanceMessage(Scope *S, Expr *Receiver,
                                         ArrayRef<IdentifierInfo *> SelIdents,
                                         bool AtArgumentExpression,
                                         ObjCInterfaceDecl *Super) {
typedef CodeCompletionResult Result;

Expr *RecExpr = static_cast<Expr *>(Receiver);

// If necessary, apply function/array conversion to the receiver.
// C99 6.7.5.3p[7,8].
if (RecExpr) {
  ExprResult Conv = DefaultFunctionArrayLvalueConversion(RecExpr);
  if (Conv.isInvalid()) // conversion failed. bail.
    return;
  RecExpr = Conv.get();
}
QualType ReceiverType = RecExpr
                            ? RecExpr->getType()
                            : Super ? Context.getObjCObjectPointerType(
                                          Context.getObjCInterfaceType(Super))
                                    : Context.getObjCIdType();

// If we're messaging an expression with type "id" or "Class", check
// whether we know something special about the receiver that allows
// us to assume a more-specific receiver type.
if (ReceiverType->isObjCIdType() || ReceiverType->isObjCClassType()) {
  if (ObjCInterfaceDecl *IFace = GetAssumedMessageSendExprType(RecExpr)) {
    if (ReceiverType->isObjCClassType())
      return CodeCompleteObjCClassMessage(
          S, ParsedType::make(Context.getObjCInterfaceType(IFace)), SelIdents,
          AtArgumentExpression, Super);

    ReceiverType =
        Context.getObjCObjectPointerType(Context.getObjCInterfaceType(IFace));
  }
} else if (RecExpr && getLangOpts().CPlusPlus) {
  ExprResult Conv = PerformContextuallyConvertToObjCPointer(RecExpr);
  if (Conv.isUsable()) {
    RecExpr = Conv.get();
    ReceiverType = RecExpr->getType();
  }
}

// Build the set of methods we can see.
ResultBuilder Results(
    *this, CodeCompleter->getAllocator(),
    CodeCompleter->getCodeCompletionTUInfo(),
    CodeCompletionContext(CodeCompletionContext::CCC_ObjCInstanceMessage,
                          ReceiverType, SelIdents));

Results.EnterNewScope();

// If this is a send-to-super, try to add the special "super" send
// completion.
if (Super) {
  if (ObjCMethodDecl *SuperMethod =
          AddSuperSendCompletion(*this, false, SelIdents, Results))
    Results.Ignore(SuperMethod);
}

// If we're inside an Objective-C method definition, prefer its selector to
// others.
if (ObjCMethodDecl *CurMethod = getCurMethodDecl())
  Results.setPreferredSelector(CurMethod->getSelector());

// Keep track of the selectors we've already added.
VisitedSelectorSet Selectors;

// Handle messages to Class. This really isn't a message to an instance
// method, so we treat it the same way we would treat a message send to a
// class method.
if (ReceiverType->isObjCClassType() ||
    ReceiverType->isObjCQualifiedClassType()) {
  if (ObjCMethodDecl *CurMethod = getCurMethodDecl()) {
    if (ObjCInterfaceDecl *ClassDecl = CurMethod->getClassInterface())
      AddObjCMethods(ClassDecl, false, MK_Any, SelIdents, CurContext,
                     Selectors, AtArgumentExpression, Results);
  }
}
// Handle messages to a qualified ID ("id<foo>").
else if (const ObjCObjectPointerType *QualID =
             ReceiverType->getAsObjCQualifiedIdType()) {
  // Search protocols for instance methods.
  for (auto *I : QualID->quals())
    AddObjCMethods(I, true, MK_Any, SelIdents, CurContext, Selectors,
                   AtArgumentExpression, Results);
}
// Handle messages to a pointer to interface type.
else if (const ObjCObjectPointerType *IFacePtr =
             ReceiverType->getAsObjCInterfacePointerType()) {
  // Search the class, its superclasses, etc., for instance methods.
  AddObjCMethods(IFacePtr->getInterfaceDecl(), true, MK_Any, SelIdents,
                 CurContext, Selectors, AtArgumentExpression, Results);

  // Search protocols for instance methods.
  for (auto *I : IFacePtr->quals())
    AddObjCMethods(I, true, MK_Any, SelIdents, CurContext, Selectors,
                   AtArgumentExpression, Results);
}
// Handle messages to "id".
else if (ReceiverType->isObjCIdType()) {
  // We're messaging "id", so provide all instance methods we know
  // about as code-completion results.

  // If we have an external source, load the entire class method
  // pool from the AST file.
  if (ExternalSource) {
    for (uint32_t I = 0, N = ExternalSource->GetNumExternalSelectors();
         I != N; ++I) {
      Selector Sel = ExternalSource->GetExternalSelector(I);
      if (Sel.isNull() || MethodPool.count(Sel))
        continue;

      ReadMethodPool(Sel);
    }
  }

  for (GlobalMethodPool::iterator M = MethodPool.begin(),
                                  MEnd = MethodPool.end();
       M != MEnd; ++M) {
    for (ObjCMethodList *MethList = &M->second.first;
         MethList && MethList->getMethod(); MethList = MethList->getNext()) {
      if (!isAcceptableObjCMethod(MethList->getMethod(), MK_Any, SelIdents))
        continue;

      if (!Selectors.insert(MethList->getMethod()->getSelector()).second)
        continue;

      Result R(MethList->getMethod(),
               Results.getBasePriority(MethList->getMethod()), nullptr);
      R.StartParameter = SelIdents.size();
      R.AllParametersAreInformative = false;
      Results.MaybeAddResult(R, CurContext);
    }
  }
}
Results.ExitScope();

// If we're actually at the argument expression (rather than prior to the
// selector), we're actually performing code completion for an expression.
// Determine whether we have a single, best method. If so, we can
// code-complete the expression using the corresponding parameter type as
// our preferred type, improving completion results.
if (AtArgumentExpression) {
  QualType PreferredType =
      getPreferredArgumentTypeForMessageSend(Results, SelIdents.size());
  if (PreferredType.isNull())
    CodeCompleteOrdinaryName(S, PCC_Expression);
  else
    CodeCompleteExpression(S, PreferredType);
  return;
}

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8287}

8289void Sema::CodeCompleteObjCForCollection(Scope *S,
                                       DeclGroupPtrTy IterationVar) {
CodeCompleteExpressionData Data;
Data.ObjCCollection = true;

if (IterationVar.getAsOpaquePtr()) {
  DeclGroupRef DG = IterationVar.get();
  for (DeclGroupRef::iterator I = DG.begin(), End = DG.end(); I != End; ++I) {
    if (*I)
      Data.IgnoreDecls.push_back(*I);
  }
}

CodeCompleteExpression(S, Data);
8303}

8305void Sema::CodeCompleteObjCSelector(Scope *S,
                                  ArrayRef<IdentifierInfo *> SelIdents) {
// If we have an external source, load the entire class method
// pool from the AST file.
if (ExternalSource) {
  for (uint32_t I = 0, N = ExternalSource->GetNumExternalSelectors(); I != N;
       ++I) {
    Selector Sel = ExternalSource->GetExternalSelector(I);
    if (Sel.isNull() || MethodPool.count(Sel))
      continue;

    ReadMethodPool(Sel);
  }
}

ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_SelectorName);
Results.EnterNewScope();
for (GlobalMethodPool::iterator M = MethodPool.begin(),
                                MEnd = MethodPool.end();
     M != MEnd; ++M) {

  Selector Sel = M->first;
  if (!isAcceptableObjCSelector(Sel, MK_Any, SelIdents))
    continue;

  CodeCompletionBuilder Builder(Results.getAllocator(),
                                Results.getCodeCompletionTUInfo());
  if (Sel.isUnarySelector()) {
    Builder.AddTypedTextChunk(
        Builder.getAllocator().CopyString(Sel.getNameForSlot(0)));
    Results.AddResult(Builder.TakeString());
    continue;
  }

  std::string Accumulator;
  for (unsigned I = 0, N = Sel.getNumArgs(); I != N; ++I) {
    if (I == SelIdents.size()) {
      if (!Accumulator.empty()) {
        Builder.AddInformativeChunk(
            Builder.getAllocator().CopyString(Accumulator));
        Accumulator.clear();
      }
    }

    Accumulator += Sel.getNameForSlot(I);
    Accumulator += ':';
  }
  Builder.AddTypedTextChunk(Builder.getAllocator().CopyString(Accumulator));
  Results.AddResult(Builder.TakeString());
}
Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8361}

8363/// Add all of the protocol declarations that we find in the given
8364/// (translation unit) context.
8365static void AddProtocolResults(DeclContext *Ctx, DeclContext *CurContext,
                             bool OnlyForwardDeclarations,
                             ResultBuilder &Results) {
typedef CodeCompletionResult Result;

for (const auto *D : Ctx->decls()) {
  // Record any protocols we find.
  if (const auto *Proto = dyn_cast<ObjCProtocolDecl>(D))
    if (!OnlyForwardDeclarations || !Proto->hasDefinition())
      Results.AddResult(
          Result(Proto, Results.getBasePriority(Proto), nullptr), CurContext,
          nullptr, false);
}
8378}

8380void Sema::CodeCompleteObjCProtocolReferences(
  ArrayRef<IdentifierLocPair> Protocols) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_ObjCProtocolName);

if (CodeCompleter->includeGlobals()) {
  Results.EnterNewScope();

  // Tell the result set to ignore all of the protocols we have
  // already seen.
  // FIXME: This doesn't work when caching code-completion results.
  for (const IdentifierLocPair &Pair : Protocols)
    if (ObjCProtocolDecl *Protocol = LookupProtocol(Pair.first, Pair.second))
      Results.Ignore(Protocol);

  // Add all protocols.
  AddProtocolResults(Context.getTranslationUnitDecl(), CurContext, false,
                     Results);

  Results.ExitScope();
}

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8405}

8407void Sema::CodeCompleteObjCProtocolDecl(Scope *) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_ObjCProtocolName);

if (CodeCompleter->includeGlobals()) {
  Results.EnterNewScope();

  // Add all protocols.
  AddProtocolResults(Context.getTranslationUnitDecl(), CurContext, true,
                     Results);

  Results.ExitScope();
}

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8424}

8426/// Add all of the Objective-C interface declarations that we find in
8427/// the given (translation unit) context.
8428static void AddInterfaceResults(DeclContext *Ctx, DeclContext *CurContext,
                              bool OnlyForwardDeclarations,
                              bool OnlyUnimplemented,
                              ResultBuilder &Results) {
typedef CodeCompletionResult Result;

for (const auto *D : Ctx->decls()) {
  // Record any interfaces we find.
  if (const auto *Class = dyn_cast<ObjCInterfaceDecl>(D))
    if ((!OnlyForwardDeclarations || !Class->hasDefinition()) &&
        (!OnlyUnimplemented || !Class->getImplementation()))
      Results.AddResult(
          Result(Class, Results.getBasePriority(Class), nullptr), CurContext,
          nullptr, false);
}
8443}

8445void Sema::CodeCompleteObjCInterfaceDecl(Scope *S) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_ObjCInterfaceName);
Results.EnterNewScope();

if (CodeCompleter->includeGlobals()) {
  // Add all classes.
  AddInterfaceResults(Context.getTranslationUnitDecl(), CurContext, false,
                      false, Results);
}

Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8461}

8463void Sema::CodeCompleteObjCSuperclass(Scope *S, IdentifierInfo *ClassName,
                                    SourceLocation ClassNameLoc) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_ObjCInterfaceName);
Results.EnterNewScope();

// Make sure that we ignore the class we're currently defining.
NamedDecl *CurClass =
    LookupSingleName(TUScope, ClassName, ClassNameLoc, LookupOrdinaryName);
if (CurClass && isa<ObjCInterfaceDecl>(CurClass))
  Results.Ignore(CurClass);

if (CodeCompleter->includeGlobals()) {
  // Add all classes.
  AddInterfaceResults(Context.getTranslationUnitDecl(), CurContext, false,
                      false, Results);
}

Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8486}

8488void Sema::CodeCompleteObjCImplementationDecl(Scope *S) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_ObjCImplementation);
Results.EnterNewScope();

if (CodeCompleter->includeGlobals()) {
  // Add all unimplemented classes.
  AddInterfaceResults(Context.getTranslationUnitDecl(), CurContext, false,
                      true, Results);
}

Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8504}

8506void Sema::CodeCompleteObjCInterfaceCategory(Scope *S,
                                           IdentifierInfo *ClassName,
                                           SourceLocation ClassNameLoc) {
typedef CodeCompletionResult Result;

ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_ObjCCategoryName);

// Ignore any categories we find that have already been implemented by this
// interface.
llvm::SmallPtrSet<IdentifierInfo *, 16> CategoryNames;
NamedDecl *CurClass =
    LookupSingleName(TUScope, ClassName, ClassNameLoc, LookupOrdinaryName);
if (ObjCInterfaceDecl *Class =
        dyn_cast_or_null<ObjCInterfaceDecl>(CurClass)) {
  for (const auto *Cat : Class->visible_categories())
    CategoryNames.insert(Cat->getIdentifier());
}

// Add all of the categories we know about.
Results.EnterNewScope();
TranslationUnitDecl *TU = Context.getTranslationUnitDecl();
for (const auto *D : TU->decls())
  if (const auto *Category = dyn_cast<ObjCCategoryDecl>(D))
    if (CategoryNames.insert(Category->getIdentifier()).second)
      Results.AddResult(
          Result(Category, Results.getBasePriority(Category), nullptr),
          CurContext, nullptr, false);
Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8539}

8541void Sema::CodeCompleteObjCImplementationCategory(Scope *S,
                                                IdentifierInfo *ClassName,
                                                SourceLocation ClassNameLoc) {
typedef CodeCompletionResult Result;

// Find the corresponding interface. If we couldn't find the interface, the
// program itself is ill-formed. However, we'll try to be helpful still by
// providing the list of all of the categories we know about.
NamedDecl *CurClass =
    LookupSingleName(TUScope, ClassName, ClassNameLoc, LookupOrdinaryName);
ObjCInterfaceDecl *Class = dyn_cast_or_null<ObjCInterfaceDecl>(CurClass);
if (!Class)
  return CodeCompleteObjCInterfaceCategory(S, ClassName, ClassNameLoc);

ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_ObjCCategoryName);

// Add all of the categories that have corresponding interface
// declarations in this class and any of its superclasses, except for
// already-implemented categories in the class itself.
llvm::SmallPtrSet<IdentifierInfo *, 16> CategoryNames;
Results.EnterNewScope();
bool IgnoreImplemented = true;
while (Class) {
  for (const auto *Cat : Class->visible_categories()) {
    if ((!IgnoreImplemented || !Cat->getImplementation()) &&
        CategoryNames.insert(Cat->getIdentifier()).second)
      Results.AddResult(Result(Cat, Results.getBasePriority(Cat), nullptr),
                        CurContext, nullptr, false);
  }

  Class = Class->getSuperClass();
  IgnoreImplemented = false;
}
Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8580}

8582void Sema::CodeCompleteObjCPropertyDefinition(Scope *S) {
CodeCompletionContext CCContext(CodeCompletionContext::CCC_Other);
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(), CCContext);

// Figure out where this @synthesize lives.
ObjCContainerDecl *Container =
    dyn_cast_or_null<ObjCContainerDecl>(CurContext);
if (!Container || (!isa<ObjCImplementationDecl>(Container) &&
                   !isa<ObjCCategoryImplDecl>(Container)))
  return;

// Ignore any properties that have already been implemented.
Container = getContainerDef(Container);
for (const auto *D : Container->decls())
  if (const auto *PropertyImpl = dyn_cast<ObjCPropertyImplDecl>(D))
    Results.Ignore(PropertyImpl->getPropertyDecl());

// Add any properties that we find.
AddedPropertiesSet AddedProperties;
Results.EnterNewScope();
if (ObjCImplementationDecl *ClassImpl =
        dyn_cast<ObjCImplementationDecl>(Container))
  AddObjCProperties(CCContext, ClassImpl->getClassInterface(), false,
                    /*AllowNullaryMethods=*/false, CurContext,
                    AddedProperties, Results);
else
  AddObjCProperties(CCContext,
                    cast<ObjCCategoryImplDecl>(Container)->getCategoryDecl(),
                    false, /*AllowNullaryMethods=*/false, CurContext,
                    AddedProperties, Results);
Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8617}

8619void Sema::CodeCompleteObjCPropertySynthesizeIvar(
  Scope *S, IdentifierInfo *PropertyName) {
typedef CodeCompletionResult Result;
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);

// Figure out where this @synthesize lives.
ObjCContainerDecl *Container =
    dyn_cast_or_null<ObjCContainerDecl>(CurContext);
if (!Container || (!isa<ObjCImplementationDecl>(Container) &&
                   !isa<ObjCCategoryImplDecl>(Container)))
  return;

// Figure out which interface we're looking into.
ObjCInterfaceDecl *Class = nullptr;
if (ObjCImplementationDecl *ClassImpl =
        dyn_cast<ObjCImplementationDecl>(Container))
  Class = ClassImpl->getClassInterface();
else
  Class = cast<ObjCCategoryImplDecl>(Container)
              ->getCategoryDecl()
              ->getClassInterface();

// Determine the type of the property we're synthesizing.
QualType PropertyType = Context.getObjCIdType();
if (Class) {
  if (ObjCPropertyDecl *Property = Class->FindPropertyDeclaration(
          PropertyName, ObjCPropertyQueryKind::OBJC_PR_query_instance)) {
    PropertyType =
        Property->getType().getNonReferenceType().getUnqualifiedType();

    // Give preference to ivars
    Results.setPreferredType(PropertyType);
  }
}

// Add all of the instance variables in this class and its superclasses.
Results.EnterNewScope();
bool SawSimilarlyNamedIvar = false;
std::string NameWithPrefix;
NameWithPrefix += '_';
NameWithPrefix += PropertyName->getName();
std::string NameWithSuffix = PropertyName->getName().str();
NameWithSuffix += '_';
for (; Class; Class = Class->getSuperClass()) {
  for (ObjCIvarDecl *Ivar = Class->all_declared_ivar_begin(); Ivar;
       Ivar = Ivar->getNextIvar()) {
    Results.AddResult(Result(Ivar, Results.getBasePriority(Ivar), nullptr),
                      CurContext, nullptr, false);

    // Determine whether we've seen an ivar with a name similar to the
    // property.
    if ((PropertyName == Ivar->getIdentifier() ||
         NameWithPrefix == Ivar->getName() ||
         NameWithSuffix == Ivar->getName())) {
      SawSimilarlyNamedIvar = true;

      // Reduce the priority of this result by one, to give it a slight
      // advantage over other results whose names don't match so closely.
      if (Results.size() &&
          Results.data()[Results.size() - 1].Kind ==
              CodeCompletionResult::RK_Declaration &&
          Results.data()[Results.size() - 1].Declaration == Ivar)
        Results.data()[Results.size() - 1].Priority--;
    }
  }
}

if (!SawSimilarlyNamedIvar) {
  // Create ivar result _propName, that the user can use to synthesize
  // an ivar of the appropriate type.
  unsigned Priority = CCP_MemberDeclaration + 1;
  typedef CodeCompletionResult Result;
  CodeCompletionAllocator &Allocator = Results.getAllocator();
  CodeCompletionBuilder Builder(Allocator, Results.getCodeCompletionTUInfo(),
                                Priority, CXAvailability_Available);

  PrintingPolicy Policy = getCompletionPrintingPolicy(*this);
  Builder.AddResultTypeChunk(
      GetCompletionTypeString(PropertyType, Context, Policy, Allocator));
  Builder.AddTypedTextChunk(Allocator.CopyString(NameWithPrefix));
  Results.AddResult(
      Result(Builder.TakeString(), Priority, CXCursor_ObjCIvarDecl));
}

Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
8709}

8711// Mapping from selectors to the methods that implement that selector, along
8712// with the "in original class" flag.
8713typedef llvm::DenseMap<Selector,
                     llvm::PointerIntPair<ObjCMethodDecl *, 1, bool>>
  KnownMethodsMap;

8717/// Find all of the methods that reside in the given container
8718/// (and its superclasses, protocols, etc.) that meet the given
8719/// criteria. Insert those methods into the map of known methods,
8720/// indexed by selector so they can be easily found.
8721static void FindImplementableMethods(ASTContext &Context,
                                   ObjCContainerDecl *Container,
                                   std::optional<bool> WantInstanceMethods,
                                   QualType ReturnType,
                                   KnownMethodsMap &KnownMethods,
                                   bool InOriginalClass = true) {
if (ObjCInterfaceDecl *IFace = dyn_cast<ObjCInterfaceDecl>(Container)) {
  // Make sure we have a definition; that's what we'll walk.
  if (!IFace->hasDefinition())
    return;

  IFace = IFace->getDefinition();
  Container = IFace;

  const ObjCList<ObjCProtocolDecl> &Protocols =
      IFace->getReferencedProtocols();
  for (ObjCList<ObjCProtocolDecl>::iterator I = Protocols.begin(),
                                            E = Protocols.end();
       I != E; ++I)
    FindImplementableMethods(Context, *I, WantInstanceMethods, ReturnType,
                             KnownMethods, InOriginalClass);

  // Add methods from any class extensions and categories.
  for (auto *Cat : IFace->visible_categories()) {
    FindImplementableMethods(Context, Cat, WantInstanceMethods, ReturnType,
                             KnownMethods, false);
  }

  // Visit the superclass.
  if (IFace->getSuperClass())
    FindImplementableMethods(Context, IFace->getSuperClass(),
                             WantInstanceMethods, ReturnType, KnownMethods,
                             false);
}

if (ObjCCategoryDecl *Category = dyn_cast<ObjCCategoryDecl>(Container)) {
  // Recurse into protocols.
  const ObjCList<ObjCProtocolDecl> &Protocols =
      Category->getReferencedProtocols();
  for (ObjCList<ObjCProtocolDecl>::iterator I = Protocols.begin(),
                                            E = Protocols.end();
       I != E; ++I)
    FindImplementableMethods(Context, *I, WantInstanceMethods, ReturnType,
                             KnownMethods, InOriginalClass);

  // If this category is the original class, jump to the interface.
  if (InOriginalClass && Category->getClassInterface())
    FindImplementableMethods(Context, Category->getClassInterface(),
                             WantInstanceMethods, ReturnType, KnownMethods,
                             false);
}

if (ObjCProtocolDecl *Protocol = dyn_cast<ObjCProtocolDecl>(Container)) {
  // Make sure we have a definition; that's what we'll walk.
  if (!Protocol->hasDefinition())
    return;
  Protocol = Protocol->getDefinition();
  Container = Protocol;

  // Recurse into protocols.
  const ObjCList<ObjCProtocolDecl> &Protocols =
      Protocol->getReferencedProtocols();
  for (ObjCList<ObjCProtocolDecl>::iterator I = Protocols.begin(),
                                            E = Protocols.end();
       I != E; ++I)
    FindImplementableMethods(Context, *I, WantInstanceMethods, ReturnType,
                             KnownMethods, false);
}

// Add methods in this container. This operation occurs last because
// we want the methods from this container to override any methods
// we've previously seen with the same selector.
for (auto *M : Container->methods()) {
  if (!WantInstanceMethods || M->isInstanceMethod() == *WantInstanceMethods) {
    if (!ReturnType.isNull() &&
        !Context.hasSameUnqualifiedType(ReturnType, M->getReturnType()))
      continue;

    KnownMethods[M->getSelector()] =
        KnownMethodsMap::mapped_type(M, InOriginalClass);
  }
}
8803}

8805/// Add the parenthesized return or parameter type chunk to a code
8806/// completion string.
8807static void AddObjCPassingTypeChunk(QualType Type, unsigned ObjCDeclQuals,
                                  ASTContext &Context,
                                  const PrintingPolicy &Policy,
                                  CodeCompletionBuilder &Builder) {
Builder.AddChunk(CodeCompletionString::CK_LeftParen);
std::string Quals = formatObjCParamQualifiers(ObjCDeclQuals, Type);
if (!Quals.empty())
  Builder.AddTextChunk(Builder.getAllocator().CopyString(Quals));
Builder.AddTextChunk(
    GetCompletionTypeString(Type, Context, Policy, Builder.getAllocator()));
Builder.AddChunk(CodeCompletionString::CK_RightParen);
8818}

8820/// Determine whether the given class is or inherits from a class by
8821/// the given name.
8822static bool InheritsFromClassNamed(ObjCInterfaceDecl *Class, StringRef Name) {
if (!Class)
  return false;

if (Class->getIdentifier() && Class->getIdentifier()->getName() == Name)
  return true;

return InheritsFromClassNamed(Class->getSuperClass(), Name);
8830}

8832/// Add code completions for Objective-C Key-Value Coding (KVC) and
8833/// Key-Value Observing (KVO).
8834static void AddObjCKeyValueCompletions(ObjCPropertyDecl *Property,
                                     bool IsInstanceMethod,
                                     QualType ReturnType, ASTContext &Context,
                                     VisitedSelectorSet &KnownSelectors,
                                     ResultBuilder &Results) {
IdentifierInfo *PropName = Property->getIdentifier();
if (!PropName || PropName->getLength() == 0)
  return;

PrintingPolicy Policy = getCompletionPrintingPolicy(Results.getSema());

// Builder that will create each code completion.
typedef CodeCompletionResult Result;
CodeCompletionAllocator &Allocator = Results.getAllocator();
CodeCompletionBuilder Builder(Allocator, Results.getCodeCompletionTUInfo());

// The selector table.
SelectorTable &Selectors = Context.Selectors;

// The property name, copied into the code completion allocation region
// on demand.
struct KeyHolder {
  CodeCompletionAllocator &Allocator;
  StringRef Key;
  const char *CopiedKey;

  KeyHolder(CodeCompletionAllocator &Allocator, StringRef Key)
      : Allocator(Allocator), Key(Key), CopiedKey(nullptr) {}

  operator const char *() {
    if (CopiedKey)
      return CopiedKey;

    return CopiedKey = Allocator.CopyString(Key);
  }
} Key(Allocator, PropName->getName());

// The uppercased name of the property name.
std::string UpperKey = std::string(PropName->getName());
if (!UpperKey.empty())
  UpperKey[0] = toUppercase(UpperKey[0]);

bool ReturnTypeMatchesProperty =
    ReturnType.isNull() ||
    Context.hasSameUnqualifiedType(ReturnType.getNonReferenceType(),
                                   Property->getType());
bool ReturnTypeMatchesVoid = ReturnType.isNull() || ReturnType->isVoidType();

// Add the normal accessor -(type)key.
if (IsInstanceMethod &&
    KnownSelectors.insert(Selectors.getNullarySelector(PropName)).second &&
    ReturnTypeMatchesProperty && !Property->getGetterMethodDecl()) {
  if (ReturnType.isNull())
    AddObjCPassingTypeChunk(Property->getType(), /*Quals=*/0, Context, Policy,
                            Builder);

  Builder.AddTypedTextChunk(Key);
  Results.AddResult(Result(Builder.TakeString(), CCP_CodePattern,
                           CXCursor_ObjCInstanceMethodDecl));
}

// If we have an integral or boolean property (or the user has provided
// an integral or boolean return type), add the accessor -(type)isKey.
if (IsInstanceMethod &&
    ((!ReturnType.isNull() &&
      (ReturnType->isIntegerType() || ReturnType->isBooleanType())) ||
     (ReturnType.isNull() && (Property->getType()->isIntegerType() ||
                              Property->getType()->isBooleanType())))) {
  std::string SelectorName = (Twine("is") + UpperKey).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getNullarySelector(SelectorId))
          .second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("BOOL");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorId->getName()));
    Results.AddResult(Result(Builder.TakeString(), CCP_CodePattern,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// Add the normal mutator.
if (IsInstanceMethod && ReturnTypeMatchesVoid &&
    !Property->getSetterMethodDecl()) {
  std::string SelectorName = (Twine("set") + UpperKey).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(
        Allocator.CopyString(SelectorId->getName() + ":"));
    AddObjCPassingTypeChunk(Property->getType(), /*Quals=*/0, Context, Policy,
                            Builder);
    Builder.AddTextChunk(Key);
    Results.AddResult(Result(Builder.TakeString(), CCP_CodePattern,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// Indexed and unordered accessors
unsigned IndexedGetterPriority = CCP_CodePattern;
unsigned IndexedSetterPriority = CCP_CodePattern;
unsigned UnorderedGetterPriority = CCP_CodePattern;
unsigned UnorderedSetterPriority = CCP_CodePattern;
if (const auto *ObjCPointer =
        Property->getType()->getAs<ObjCObjectPointerType>()) {
  if (ObjCInterfaceDecl *IFace = ObjCPointer->getInterfaceDecl()) {
    // If this interface type is not provably derived from a known
    // collection, penalize the corresponding completions.
    if (!InheritsFromClassNamed(IFace, "NSMutableArray")) {
      IndexedSetterPriority += CCD_ProbablyNotObjCCollection;
      if (!InheritsFromClassNamed(IFace, "NSArray"))
        IndexedGetterPriority += CCD_ProbablyNotObjCCollection;
    }

    if (!InheritsFromClassNamed(IFace, "NSMutableSet")) {
      UnorderedSetterPriority += CCD_ProbablyNotObjCCollection;
      if (!InheritsFromClassNamed(IFace, "NSSet"))
        UnorderedGetterPriority += CCD_ProbablyNotObjCCollection;
    }
  }
} else {
  IndexedGetterPriority += CCD_ProbablyNotObjCCollection;
  IndexedSetterPriority += CCD_ProbablyNotObjCCollection;
  UnorderedGetterPriority += CCD_ProbablyNotObjCCollection;
  UnorderedSetterPriority += CCD_ProbablyNotObjCCollection;
}

// Add -(NSUInteger)countOf<key>
if (IsInstanceMethod &&
    (ReturnType.isNull() || ReturnType->isIntegerType())) {
  std::string SelectorName = (Twine("countOf") + UpperKey).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getNullarySelector(SelectorId))
          .second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("NSUInteger");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorId->getName()));
    Results.AddResult(
        Result(Builder.TakeString(),
               std::min(IndexedGetterPriority, UnorderedGetterPriority),
               CXCursor_ObjCInstanceMethodDecl));
  }
}

// Indexed getters
// Add -(id)objectInKeyAtIndex:(NSUInteger)index
if (IsInstanceMethod &&
    (ReturnType.isNull() || ReturnType->isObjCObjectPointerType())) {
  std::string SelectorName = (Twine("objectIn") + UpperKey + "AtIndex").str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("id");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("NSUInteger");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("index");
    Results.AddResult(Result(Builder.TakeString(), IndexedGetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// Add -(NSArray *)keyAtIndexes:(NSIndexSet *)indexes
if (IsInstanceMethod &&
    (ReturnType.isNull() ||
     (ReturnType->isObjCObjectPointerType() &&
      ReturnType->castAs<ObjCObjectPointerType>()->getInterfaceDecl() &&
      ReturnType->castAs<ObjCObjectPointerType>()
              ->getInterfaceDecl()
              ->getName() == "NSArray"))) {
  std::string SelectorName = (Twine(Property->getName()) + "AtIndexes").str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("NSArray *");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("NSIndexSet *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("indexes");
    Results.AddResult(Result(Builder.TakeString(), IndexedGetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// Add -(void)getKey:(type **)buffer range:(NSRange)inRange
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName = (Twine("get") + UpperKey).str();
  IdentifierInfo *SelectorIds[2] = {&Context.Idents.get(SelectorName),
                                    &Context.Idents.get("range")};

  if (KnownSelectors.insert(Selectors.getSelector(2, SelectorIds)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("object-type");
    Builder.AddTextChunk(" **");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("buffer");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddTypedTextChunk("range:");
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("NSRange");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("inRange");
    Results.AddResult(Result(Builder.TakeString(), IndexedGetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// Mutable indexed accessors

// - (void)insertObject:(type *)object inKeyAtIndex:(NSUInteger)index
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName = (Twine("in") + UpperKey + "AtIndex").str();
  IdentifierInfo *SelectorIds[2] = {&Context.Idents.get("insertObject"),
                                    &Context.Idents.get(SelectorName)};

  if (KnownSelectors.insert(Selectors.getSelector(2, SelectorIds)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk("insertObject:");
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("object-type");
    Builder.AddTextChunk(" *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("object");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("NSUInteger");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("index");
    Results.AddResult(Result(Builder.TakeString(), IndexedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// - (void)insertKey:(NSArray *)array atIndexes:(NSIndexSet *)indexes
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName = (Twine("insert") + UpperKey).str();
  IdentifierInfo *SelectorIds[2] = {&Context.Idents.get(SelectorName),
                                    &Context.Idents.get("atIndexes")};

  if (KnownSelectors.insert(Selectors.getSelector(2, SelectorIds)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("NSArray *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("array");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddTypedTextChunk("atIndexes:");
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("NSIndexSet *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("indexes");
    Results.AddResult(Result(Builder.TakeString(), IndexedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// -(void)removeObjectFromKeyAtIndex:(NSUInteger)index
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName =
      (Twine("removeObjectFrom") + UpperKey + "AtIndex").str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("NSUInteger");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("index");
    Results.AddResult(Result(Builder.TakeString(), IndexedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// -(void)removeKeyAtIndexes:(NSIndexSet *)indexes
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName = (Twine("remove") + UpperKey + "AtIndexes").str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("NSIndexSet *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("indexes");
    Results.AddResult(Result(Builder.TakeString(), IndexedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// - (void)replaceObjectInKeyAtIndex:(NSUInteger)index withObject:(id)object
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName =
      (Twine("replaceObjectIn") + UpperKey + "AtIndex").str();
  IdentifierInfo *SelectorIds[2] = {&Context.Idents.get(SelectorName),
                                    &Context.Idents.get("withObject")};

  if (KnownSelectors.insert(Selectors.getSelector(2, SelectorIds)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("NSUInteger");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("index");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddTypedTextChunk("withObject:");
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("id");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("object");
    Results.AddResult(Result(Builder.TakeString(), IndexedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// - (void)replaceKeyAtIndexes:(NSIndexSet *)indexes withKey:(NSArray *)array
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName1 =
      (Twine("replace") + UpperKey + "AtIndexes").str();
  std::string SelectorName2 = (Twine("with") + UpperKey).str();
  IdentifierInfo *SelectorIds[2] = {&Context.Idents.get(SelectorName1),
                                    &Context.Idents.get(SelectorName2)};

  if (KnownSelectors.insert(Selectors.getSelector(2, SelectorIds)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName1 + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("NSIndexSet *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("indexes");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName2 + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("NSArray *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("array");
    Results.AddResult(Result(Builder.TakeString(), IndexedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// Unordered getters
// - (NSEnumerator *)enumeratorOfKey
if (IsInstanceMethod &&
    (ReturnType.isNull() ||
     (ReturnType->isObjCObjectPointerType() &&
      ReturnType->castAs<ObjCObjectPointerType>()->getInterfaceDecl() &&
      ReturnType->castAs<ObjCObjectPointerType>()
              ->getInterfaceDecl()
              ->getName() == "NSEnumerator"))) {
  std::string SelectorName = (Twine("enumeratorOf") + UpperKey).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getNullarySelector(SelectorId))
          .second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("NSEnumerator *");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName));
    Results.AddResult(Result(Builder.TakeString(), UnorderedGetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// - (type *)memberOfKey:(type *)object
if (IsInstanceMethod &&
    (ReturnType.isNull() || ReturnType->isObjCObjectPointerType())) {
  std::string SelectorName = (Twine("memberOf") + UpperKey).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddPlaceholderChunk("object-type");
      Builder.AddTextChunk(" *");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    if (ReturnType.isNull()) {
      Builder.AddPlaceholderChunk("object-type");
      Builder.AddTextChunk(" *");
    } else {
      Builder.AddTextChunk(GetCompletionTypeString(
          ReturnType, Context, Policy, Builder.getAllocator()));
    }
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("object");
    Results.AddResult(Result(Builder.TakeString(), UnorderedGetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// Mutable unordered accessors
// - (void)addKeyObject:(type *)object
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName =
      (Twine("add") + UpperKey + Twine("Object")).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("object-type");
    Builder.AddTextChunk(" *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("object");
    Results.AddResult(Result(Builder.TakeString(), UnorderedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// - (void)addKey:(NSSet *)objects
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName = (Twine("add") + UpperKey).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("NSSet *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("objects");
    Results.AddResult(Result(Builder.TakeString(), UnorderedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// - (void)removeKeyObject:(type *)object
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName =
      (Twine("remove") + UpperKey + Twine("Object")).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddPlaceholderChunk("object-type");
    Builder.AddTextChunk(" *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("object");
    Results.AddResult(Result(Builder.TakeString(), UnorderedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// - (void)removeKey:(NSSet *)objects
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName = (Twine("remove") + UpperKey).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("NSSet *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("objects");
    Results.AddResult(Result(Builder.TakeString(), UnorderedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// - (void)intersectKey:(NSSet *)objects
if (IsInstanceMethod && ReturnTypeMatchesVoid) {
  std::string SelectorName = (Twine("intersect") + UpperKey).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getUnarySelector(SelectorId)).second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("void");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName + ":"));
    Builder.AddChunk(CodeCompletionString::CK_LeftParen);
    Builder.AddTextChunk("NSSet *");
    Builder.AddChunk(CodeCompletionString::CK_RightParen);
    Builder.AddTextChunk("objects");
    Results.AddResult(Result(Builder.TakeString(), UnorderedSetterPriority,
                             CXCursor_ObjCInstanceMethodDecl));
  }
}

// Key-Value Observing
// + (NSSet *)keyPathsForValuesAffectingKey
if (!IsInstanceMethod &&
    (ReturnType.isNull() ||
     (ReturnType->isObjCObjectPointerType() &&
      ReturnType->castAs<ObjCObjectPointerType>()->getInterfaceDecl() &&
      ReturnType->castAs<ObjCObjectPointerType>()
              ->getInterfaceDecl()
              ->getName() == "NSSet"))) {
  std::string SelectorName =
      (Twine("keyPathsForValuesAffecting") + UpperKey).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getNullarySelector(SelectorId))
          .second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("NSSet<NSString *> *");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName));
    Results.AddResult(Result(Builder.TakeString(), CCP_CodePattern,
                             CXCursor_ObjCClassMethodDecl));
  }
}

// + (BOOL)automaticallyNotifiesObserversForKey
if (!IsInstanceMethod &&
    (ReturnType.isNull() || ReturnType->isIntegerType() ||
     ReturnType->isBooleanType())) {
  std::string SelectorName =
      (Twine("automaticallyNotifiesObserversOf") + UpperKey).str();
  IdentifierInfo *SelectorId = &Context.Idents.get(SelectorName);
  if (KnownSelectors.insert(Selectors.getNullarySelector(SelectorId))
          .second) {
    if (ReturnType.isNull()) {
      Builder.AddChunk(CodeCompletionString::CK_LeftParen);
      Builder.AddTextChunk("BOOL");
      Builder.AddChunk(CodeCompletionString::CK_RightParen);
    }

    Builder.AddTypedTextChunk(Allocator.CopyString(SelectorName));
    Results.AddResult(Result(Builder.TakeString(), CCP_CodePattern,
                             CXCursor_ObjCClassMethodDecl));
  }
}
9445}

9447void Sema::CodeCompleteObjCMethodDecl(Scope *S,
                                    std::optional<bool> IsInstanceMethod,
                                    ParsedType ReturnTy) {
// Determine the return type of the method we're declaring, if
// provided.
QualType ReturnType = GetTypeFromParser(ReturnTy);
Decl *IDecl = nullptr;
if (CurContext->isObjCContainer()) {
  ObjCContainerDecl *OCD = dyn_cast<ObjCContainerDecl>(CurContext);
  IDecl = OCD;
}
// Determine where we should start searching for methods.
ObjCContainerDecl *SearchDecl = nullptr;
bool IsInImplementation = false;
if (Decl *D = IDecl) {
  if (ObjCImplementationDecl *Impl = dyn_cast<ObjCImplementationDecl>(D)) {
    SearchDecl = Impl->getClassInterface();
    IsInImplementation = true;
  } else if (ObjCCategoryImplDecl *CatImpl =
                 dyn_cast<ObjCCategoryImplDecl>(D)) {
    SearchDecl = CatImpl->getCategoryDecl();
    IsInImplementation = true;
  } else
    SearchDecl = dyn_cast<ObjCContainerDecl>(D);
}

if (!SearchDecl && S) {
  if (DeclContext *DC = S->getEntity())
    SearchDecl = dyn_cast<ObjCContainerDecl>(DC);
}

if (!SearchDecl) {
  HandleCodeCompleteResults(this, CodeCompleter,
                            CodeCompletionContext::CCC_Other, nullptr, 0);
  return;
}

// Find all of the methods that we could declare/implement here.
KnownMethodsMap KnownMethods;
FindImplementableMethods(Context, SearchDecl, IsInstanceMethod, ReturnType,
                         KnownMethods);

// Add declarations or definitions for each of the known methods.
typedef CodeCompletionResult Result;
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();
PrintingPolicy Policy = getCompletionPrintingPolicy(*this);
for (KnownMethodsMap::iterator M = KnownMethods.begin(),
                               MEnd = KnownMethods.end();
     M != MEnd; ++M) {
  ObjCMethodDecl *Method = M->second.getPointer();
  CodeCompletionBuilder Builder(Results.getAllocator(),
                                Results.getCodeCompletionTUInfo());

  // Add the '-'/'+' prefix if it wasn't provided yet.
  if (!IsInstanceMethod) {
    Builder.AddTextChunk(Method->isInstanceMethod() ? "-" : "+");
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  }

  // If the result type was not already provided, add it to the
  // pattern as (type).
  if (ReturnType.isNull()) {
    QualType ResTy = Method->getSendResultType().stripObjCKindOfType(Context);
    AttributedType::stripOuterNullability(ResTy);
    AddObjCPassingTypeChunk(ResTy, Method->getObjCDeclQualifier(), Context,
                            Policy, Builder);
  }

  Selector Sel = Method->getSelector();

  if (Sel.isUnarySelector()) {
    // Unary selectors have no arguments.
    Builder.AddTypedTextChunk(
        Builder.getAllocator().CopyString(Sel.getNameForSlot(0)));
  } else {
    // Add all parameters to the pattern.
    unsigned I = 0;
    for (ObjCMethodDecl::param_iterator P = Method->param_begin(),
                                        PEnd = Method->param_end();
         P != PEnd; (void)++P, ++I) {
      // Add the part of the selector name.
      if (I == 0)
        Builder.AddTypedTextChunk(
            Builder.getAllocator().CopyString(Sel.getNameForSlot(I) + ":"));
      else if (I < Sel.getNumArgs()) {
        Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
        Builder.AddTypedTextChunk(
            Builder.getAllocator().CopyString(Sel.getNameForSlot(I) + ":"));
      } else
        break;

      // Add the parameter type.
      QualType ParamType;
      if ((*P)->getObjCDeclQualifier() & Decl::OBJC_TQ_CSNullability)
        ParamType = (*P)->getType();
      else
        ParamType = (*P)->getOriginalType();
      ParamType = ParamType.substObjCTypeArgs(
          Context, {}, ObjCSubstitutionContext::Parameter);
      AttributedType::stripOuterNullability(ParamType);
      AddObjCPassingTypeChunk(ParamType, (*P)->getObjCDeclQualifier(),
                              Context, Policy, Builder);

      if (IdentifierInfo *Id = (*P)->getIdentifier())
        Builder.AddTextChunk(
            Builder.getAllocator().CopyString(Id->getName()));
    }
  }

  if (Method->isVariadic()) {
    if (Method->param_size() > 0)
      Builder.AddChunk(CodeCompletionString::CK_Comma);
    Builder.AddTextChunk("...");
  }

  if (IsInImplementation && Results.includeCodePatterns()) {
    // We will be defining the method here, so add a compound statement.
    Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
    Builder.AddChunk(CodeCompletionString::CK_LeftBrace);
    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    if (!Method->getReturnType()->isVoidType()) {
      // If the result type is not void, add a return clause.
      Builder.AddTextChunk("return");
      Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
      Builder.AddPlaceholderChunk("expression");
      Builder.AddChunk(CodeCompletionString::CK_SemiColon);
    } else
      Builder.AddPlaceholderChunk("statements");

    Builder.AddChunk(CodeCompletionString::CK_VerticalSpace);
    Builder.AddChunk(CodeCompletionString::CK_RightBrace);
  }

  unsigned Priority = CCP_CodePattern;
  auto R = Result(Builder.TakeString(), Method, Priority);
  if (!M->second.getInt())
    setInBaseClass(R);
  Results.AddResult(std::move(R));
}

// Add Key-Value-Coding and Key-Value-Observing accessor methods for all of
// the properties in this class and its categories.
if (Context.getLangOpts().ObjC) {
  SmallVector<ObjCContainerDecl *, 4> Containers;
  Containers.push_back(SearchDecl);

  VisitedSelectorSet KnownSelectors;
  for (KnownMethodsMap::iterator M = KnownMethods.begin(),
                                 MEnd = KnownMethods.end();
       M != MEnd; ++M)
    KnownSelectors.insert(M->first);

  ObjCInterfaceDecl *IFace = dyn_cast<ObjCInterfaceDecl>(SearchDecl);
  if (!IFace)
    if (ObjCCategoryDecl *Category = dyn_cast<ObjCCategoryDecl>(SearchDecl))
      IFace = Category->getClassInterface();

  if (IFace)
    llvm::append_range(Containers, IFace->visible_categories());

  if (IsInstanceMethod) {
    for (unsigned I = 0, N = Containers.size(); I != N; ++I)
      for (auto *P : Containers[I]->instance_properties())
        AddObjCKeyValueCompletions(P, *IsInstanceMethod, ReturnType, Context,
                                   KnownSelectors, Results);
  }
}

Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
9622}

9624void Sema::CodeCompleteObjCMethodDeclSelector(
  Scope *S, bool IsInstanceMethod, bool AtParameterName, ParsedType ReturnTy,
  ArrayRef<IdentifierInfo *> SelIdents) {
// If we have an external source, load the entire class method
// pool from the AST file.
if (ExternalSource) {
  for (uint32_t I = 0, N = ExternalSource->GetNumExternalSelectors(); I != N;
       ++I) {
    Selector Sel = ExternalSource->GetExternalSelector(I);
    if (Sel.isNull() || MethodPool.count(Sel))
      continue;

    ReadMethodPool(Sel);
  }
}

// Build the set of methods we can see.
typedef CodeCompletionResult Result;
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);

if (ReturnTy)
  Results.setPreferredType(GetTypeFromParser(ReturnTy).getNonReferenceType());

Results.EnterNewScope();
for (GlobalMethodPool::iterator M = MethodPool.begin(),
                                MEnd = MethodPool.end();
     M != MEnd; ++M) {
  for (ObjCMethodList *MethList = IsInstanceMethod ? &M->second.first
                                                   : &M->second.second;
       MethList && MethList->getMethod(); MethList = MethList->getNext()) {
    if (!isAcceptableObjCMethod(MethList->getMethod(), MK_Any, SelIdents))
      continue;

    if (AtParameterName) {
      // Suggest parameter names we've seen before.
      unsigned NumSelIdents = SelIdents.size();
      if (NumSelIdents &&
          NumSelIdents <= MethList->getMethod()->param_size()) {
        ParmVarDecl *Param =
            MethList->getMethod()->parameters()[NumSelIdents - 1];
        if (Param->getIdentifier()) {
          CodeCompletionBuilder Builder(Results.getAllocator(),
                                        Results.getCodeCompletionTUInfo());
          Builder.AddTypedTextChunk(Builder.getAllocator().CopyString(
              Param->getIdentifier()->getName()));
          Results.AddResult(Builder.TakeString());
        }
      }

      continue;
    }

    Result R(MethList->getMethod(),
             Results.getBasePriority(MethList->getMethod()), nullptr);
    R.StartParameter = SelIdents.size();
    R.AllParametersAreInformative = false;
    R.DeclaringEntity = true;
    Results.MaybeAddResult(R, CurContext);
  }
}

Results.ExitScope();

if (!AtParameterName && !SelIdents.empty() &&
    SelIdents.front()->getName().startswith("init")) {
  for (const auto &M : PP.macros()) {
    if (M.first->getName() != "NS_DESIGNATED_INITIALIZER")
      continue;
    Results.EnterNewScope();
    CodeCompletionBuilder Builder(Results.getAllocator(),
                                  Results.getCodeCompletionTUInfo());
    Builder.AddTypedTextChunk(
        Builder.getAllocator().CopyString(M.first->getName()));
    Results.AddResult(CodeCompletionResult(Builder.TakeString(), CCP_Macro,
                                           CXCursor_MacroDefinition));
    Results.ExitScope();
  }
}

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
9707}

9709void Sema::CodeCompletePreprocessorDirective(bool InConditional) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_PreprocessorDirective);
Results.EnterNewScope();

// #if <condition>
CodeCompletionBuilder Builder(Results.getAllocator(),
                              Results.getCodeCompletionTUInfo());
Builder.AddTypedTextChunk("if");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("condition");
Results.AddResult(Builder.TakeString());

// #ifdef <macro>
Builder.AddTypedTextChunk("ifdef");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("macro");
Results.AddResult(Builder.TakeString());

// #ifndef <macro>
Builder.AddTypedTextChunk("ifndef");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("macro");
Results.AddResult(Builder.TakeString());

if (InConditional) {
  // #elif <condition>
  Builder.AddTypedTextChunk("elif");
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("condition");
  Results.AddResult(Builder.TakeString());

  // #elifdef <macro>
  Builder.AddTypedTextChunk("elifdef");
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("macro");
  Results.AddResult(Builder.TakeString());

  // #elifndef <macro>
  Builder.AddTypedTextChunk("elifndef");
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddPlaceholderChunk("macro");
  Results.AddResult(Builder.TakeString());

  // #else
  Builder.AddTypedTextChunk("else");
  Results.AddResult(Builder.TakeString());

  // #endif
  Builder.AddTypedTextChunk("endif");
  Results.AddResult(Builder.TakeString());
}

// #include "header"
Builder.AddTypedTextChunk("include");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddTextChunk("\"");
Builder.AddPlaceholderChunk("header");
Builder.AddTextChunk("\"");
Results.AddResult(Builder.TakeString());

// #include <header>
Builder.AddTypedTextChunk("include");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddTextChunk("<");
Builder.AddPlaceholderChunk("header");
Builder.AddTextChunk(">");
Results.AddResult(Builder.TakeString());

// #define <macro>
Builder.AddTypedTextChunk("define");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("macro");
Results.AddResult(Builder.TakeString());

// #define <macro>(<args>)
Builder.AddTypedTextChunk("define");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("macro");
Builder.AddChunk(CodeCompletionString::CK_LeftParen);
Builder.AddPlaceholderChunk("args");
Builder.AddChunk(CodeCompletionString::CK_RightParen);
Results.AddResult(Builder.TakeString());

// #undef <macro>
Builder.AddTypedTextChunk("undef");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("macro");
Results.AddResult(Builder.TakeString());

// #line <number>
Builder.AddTypedTextChunk("line");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("number");
Results.AddResult(Builder.TakeString());

// #line <number> "filename"
Builder.AddTypedTextChunk("line");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("number");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddTextChunk("\"");
Builder.AddPlaceholderChunk("filename");
Builder.AddTextChunk("\"");
Results.AddResult(Builder.TakeString());

// #error <message>
Builder.AddTypedTextChunk("error");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("message");
Results.AddResult(Builder.TakeString());

// #pragma <arguments>
Builder.AddTypedTextChunk("pragma");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("arguments");
Results.AddResult(Builder.TakeString());

if (getLangOpts().ObjC) {
  // #import "header"
  Builder.AddTypedTextChunk("import");
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddTextChunk("\"");
  Builder.AddPlaceholderChunk("header");
  Builder.AddTextChunk("\"");
  Results.AddResult(Builder.TakeString());

  // #import <header>
  Builder.AddTypedTextChunk("import");
  Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
  Builder.AddTextChunk("<");
  Builder.AddPlaceholderChunk("header");
  Builder.AddTextChunk(">");
  Results.AddResult(Builder.TakeString());
}

// #include_next "header"
Builder.AddTypedTextChunk("include_next");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddTextChunk("\"");
Builder.AddPlaceholderChunk("header");
Builder.AddTextChunk("\"");
Results.AddResult(Builder.TakeString());

// #include_next <header>
Builder.AddTypedTextChunk("include_next");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddTextChunk("<");
Builder.AddPlaceholderChunk("header");
Builder.AddTextChunk(">");
Results.AddResult(Builder.TakeString());

// #warning <message>
Builder.AddTypedTextChunk("warning");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddPlaceholderChunk("message");
Results.AddResult(Builder.TakeString());

// Note: #ident and #sccs are such crazy anachronisms that we don't provide
// completions for them. And __include_macros is a Clang-internal extension
// that we don't want to encourage anyone to use.

// FIXME: we don't support #assert or #unassert, so don't suggest them.
Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
9877}

9879void Sema::CodeCompleteInPreprocessorConditionalExclusion(Scope *S) {
CodeCompleteOrdinaryName(S, S->getFnParent() ? Sema::PCC_RecoveryInFunction
                                             : Sema::PCC_Namespace);
9882}

9884void Sema::CodeCompletePreprocessorMacroName(bool IsDefinition) {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      IsDefinition ? CodeCompletionContext::CCC_MacroName
                                   : CodeCompletionContext::CCC_MacroNameUse);
if (!IsDefinition && CodeCompleter->includeMacros()) {
  // Add just the names of macros, not their arguments.
  CodeCompletionBuilder Builder(Results.getAllocator(),
                                Results.getCodeCompletionTUInfo());
  Results.EnterNewScope();
  for (Preprocessor::macro_iterator M = PP.macro_begin(),
                                    MEnd = PP.macro_end();
       M != MEnd; ++M) {
    Builder.AddTypedTextChunk(
        Builder.getAllocator().CopyString(M->first->getName()));
    Results.AddResult(CodeCompletionResult(
        Builder.TakeString(), CCP_CodePattern, CXCursor_MacroDefinition));
  }
  Results.ExitScope();
} else if (IsDefinition) {
  // FIXME: Can we detect when the user just wrote an include guard above?
}

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
9909}

9911void Sema::CodeCompletePreprocessorExpression() {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_PreprocessorExpression);

if (CodeCompleter->includeMacros())
  AddMacroResults(PP, Results, CodeCompleter->loadExternal(), true);

// defined (<macro>)
Results.EnterNewScope();
CodeCompletionBuilder Builder(Results.getAllocator(),
                              Results.getCodeCompletionTUInfo());
Builder.AddTypedTextChunk("defined");
Builder.AddChunk(CodeCompletionString::CK_HorizontalSpace);
Builder.AddChunk(CodeCompletionString::CK_LeftParen);
Builder.AddPlaceholderChunk("macro");
Builder.AddChunk(CodeCompletionString::CK_RightParen);
Results.AddResult(Builder.TakeString());
Results.ExitScope();

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
9933}

9935void Sema::CodeCompletePreprocessorMacroArgument(Scope *S,
                                               IdentifierInfo *Macro,
                                               MacroInfo *MacroInfo,
                                               unsigned Argument) {
// FIXME: In the future, we could provide "overload" results, much like we
// do for function calls.

// Now just ignore this. There will be another code-completion callback
// for the expanded tokens.
9944}

9946// This handles completion inside an #include filename, e.g. #include <foo/ba
9947// We look for the directory "foo" under each directory on the include path,
9948// list its files, and reassemble the appropriate #include.
9949void Sema::CodeCompleteIncludedFile(llvm::StringRef Dir, bool Angled) {
// RelDir should use /, but unescaped \ is possible on windows!
// Our completions will normalize to / for simplicity, this case is rare.
std::string RelDir = llvm::sys::path::convert_to_slash(Dir);
// We need the native slashes for the actual file system interactions.
SmallString<128> NativeRelDir = StringRef(RelDir);
llvm::sys::path::native(NativeRelDir);
llvm::vfs::FileSystem &FS =
    getSourceManager().getFileManager().getVirtualFileSystem();

ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_IncludedFile);
llvm::DenseSet<StringRef> SeenResults; // To deduplicate results.

// Helper: adds one file or directory completion result.
auto AddCompletion = [&](StringRef Filename, bool IsDirectory) {
  SmallString<64> TypedChunk = Filename;
  // Directory completion is up to the slash, e.g. <sys/
  TypedChunk.push_back(IsDirectory ? '/' : Angled ? '>' : '"');
  auto R = SeenResults.insert(TypedChunk);
  if (R.second) { // New completion
    const char *InternedTyped = Results.getAllocator().CopyString(TypedChunk);
    *R.first = InternedTyped; // Avoid dangling StringRef.
    CodeCompletionBuilder Builder(CodeCompleter->getAllocator(),
                                  CodeCompleter->getCodeCompletionTUInfo());
    Builder.AddTypedTextChunk(InternedTyped);
    // The result is a "Pattern", which is pretty opaque.
    // We may want to include the real filename to allow smart ranking.
    Results.AddResult(CodeCompletionResult(Builder.TakeString()));
  }
};

// Helper: scans IncludeDir for nice files, and adds results for each.
auto AddFilesFromIncludeDir = [&](StringRef IncludeDir,
                                  bool IsSystem,
                                  DirectoryLookup::LookupType_t LookupType) {
  llvm::SmallString<128> Dir = IncludeDir;
  if (!NativeRelDir.empty()) {
    if (LookupType == DirectoryLookup::LT_Framework) {
      // For a framework dir, #include <Foo/Bar/> actually maps to
      // a path of Foo.framework/Headers/Bar/.
      auto Begin = llvm::sys::path::begin(NativeRelDir);
      auto End = llvm::sys::path::end(NativeRelDir);

      llvm::sys::path::append(Dir, *Begin + ".framework", "Headers");
      llvm::sys::path::append(Dir, ++Begin, End);
    } else {
      llvm::sys::path::append(Dir, NativeRelDir);
    }
  }

  const StringRef &Dirname = llvm::sys::path::filename(Dir);
  const bool isQt = Dirname.startswith("Qt") || Dirname == "ActiveQt";
  const bool ExtensionlessHeaders =
      IsSystem || isQt || Dir.endswith(".framework/Headers");
  std::error_code EC;
  unsigned Count = 0;
  for (auto It = FS.dir_begin(Dir, EC);
       !EC && It != llvm::vfs::directory_iterator(); It.increment(EC)) {
    if (++Count == 2500) // If we happen to hit a huge directory,
      break;             // bail out early so we're not too slow.
    StringRef Filename = llvm::sys::path::filename(It->path());

    // To know whether a symlink should be treated as file or a directory, we
    // have to stat it. This should be cheap enough as there shouldn't be many
    // symlinks.
    llvm::sys::fs::file_type Type = It->type();
    if (Type == llvm::sys::fs::file_type::symlink_file) {
      if (auto FileStatus = FS.status(It->path()))
        Type = FileStatus->getType();
    }
    switch (Type) {
    case llvm::sys::fs::file_type::directory_file:
      // All entries in a framework directory must have a ".framework" suffix,
      // but the suffix does not appear in the source code's include/import.
      if (LookupType == DirectoryLookup::LT_Framework &&
          NativeRelDir.empty() && !Filename.consume_back(".framework"))
        break;

      AddCompletion(Filename, /*IsDirectory=*/true);
      break;
    case llvm::sys::fs::file_type::regular_file: {
      // Only files that really look like headers. (Except in special dirs).
      const bool IsHeader = Filename.endswith_insensitive(".h") ||
                            Filename.endswith_insensitive(".hh") ||
                            Filename.endswith_insensitive(".hpp") ||
                            Filename.endswith_insensitive(".hxx") ||
                            Filename.endswith_insensitive(".inc") ||
                            (ExtensionlessHeaders && !Filename.contains('.'));
      if (!IsHeader)
        break;
      AddCompletion(Filename, /*IsDirectory=*/false);
      break;
    }
    default:
      break;
    }
  }
};

// Helper: adds results relative to IncludeDir, if possible.
auto AddFilesFromDirLookup = [&](const DirectoryLookup &IncludeDir,
                                 bool IsSystem) {
  switch (IncludeDir.getLookupType()) {
  case DirectoryLookup::LT_HeaderMap:
    // header maps are not (currently) enumerable.
    break;
  case DirectoryLookup::LT_NormalDir:
    AddFilesFromIncludeDir(IncludeDir.getDir()->getName(), IsSystem,
                           DirectoryLookup::LT_NormalDir);
    break;
  case DirectoryLookup::LT_Framework:
    AddFilesFromIncludeDir(IncludeDir.getFrameworkDir()->getName(), IsSystem,
                           DirectoryLookup::LT_Framework);
    break;
  }
};

// Finally with all our helpers, we can scan the include path.
// Do this in standard order so deduplication keeps the right file.
// (In case we decide to add more details to the results later).
const auto &S = PP.getHeaderSearchInfo();
using llvm::make_range;
if (!Angled) {
  // The current directory is on the include path for "quoted" includes.
  const FileEntry *CurFile = PP.getCurrentFileLexer()->getFileEntry();
  if (CurFile && CurFile->getDir())
    AddFilesFromIncludeDir(CurFile->getDir()->getName(), false,
                           DirectoryLookup::LT_NormalDir);
  for (const auto &D : make_range(S.quoted_dir_begin(), S.quoted_dir_end()))
    AddFilesFromDirLookup(D, false);
}
for (const auto &D : make_range(S.angled_dir_begin(), S.angled_dir_end()))
  AddFilesFromDirLookup(D, false);
for (const auto &D : make_range(S.system_dir_begin(), S.system_dir_end()))
  AddFilesFromDirLookup(D, true);

HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
10089}

10091void Sema::CodeCompleteNaturalLanguage() {
HandleCodeCompleteResults(this, CodeCompleter,
                          CodeCompletionContext::CCC_NaturalLanguage, nullptr,
                          0);
10095}

10097void Sema::CodeCompleteAvailabilityPlatformName() {
ResultBuilder Results(*this, CodeCompleter->getAllocator(),
                      CodeCompleter->getCodeCompletionTUInfo(),
                      CodeCompletionContext::CCC_Other);
Results.EnterNewScope();
static const char *Platforms[] = {"macOS", "iOS", "watchOS", "tvOS"};
for (const char *Platform : llvm::ArrayRef(Platforms)) {
  Results.AddResult(CodeCompletionResult(Platform));
  Results.AddResult(CodeCompletionResult(Results.getAllocator().CopyString(
      Twine(Platform) + "ApplicationExtension")));
}
Results.ExitScope();
HandleCodeCompleteResults(this, CodeCompleter, Results.getCompletionContext(),
                          Results.data(), Results.size());
10111}

10113void Sema::GatherGlobalCodeCompletions(
  CodeCompletionAllocator &Allocator, CodeCompletionTUInfo &CCTUInfo,
  SmallVectorImpl<CodeCompletionResult> &Results) {
ResultBuilder Builder(*this, Allocator, CCTUInfo,
                      CodeCompletionContext::CCC_Recovery);
1
Calling implicit destructor for 'CodeCompletionContext'→
2
←
Calling implicit destructor for 'optional<clang::CXXScopeSpec>'→
3
←
Calling implicit destructor for '_Optional_base<clang::CXXScopeSpec, false, false>'→
4
←
Calling '~_Optional_payload'→
if (!CodeCompleter || CodeCompleter->includeGlobals()) {
  CodeCompletionDeclConsumer Consumer(Builder,
                                      Context.getTranslationUnitDecl());
  LookupVisibleDecls(Context.getTranslationUnitDecl(), LookupAnyName,
                     Consumer,
                     !CodeCompleter || CodeCompleter->loadExternal());
}

if (!CodeCompleter || CodeCompleter->includeMacros())
  AddMacroResults(PP, Builder,
                  !CodeCompleter || CodeCompleter->loadExternal(), true);

Results.clear();
Results.insert(Results.end(), Builder.data(),
               Builder.data() + Builder.size());
10133}

←

/build/source/clang/include/clang/Sema/CodeCompleteConsumer.h

→

1	//===- CodeCompleteConsumer.h - Code Completion Interface -------- 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	// This file defines the CodeCompleteConsumer class.
10	//
11	//===----------------------------------------------------------------------===//
12
13	#ifndef LLVM_CLANG_SEMA_CODECOMPLETECONSUMER_H
14	#define LLVM_CLANG_SEMA_CODECOMPLETECONSUMER_H
15
16	#include "clang-c/Index.h"
17	#include "clang/AST/Type.h"
18	#include "clang/Basic/LLVM.h"
19	#include "clang/Lex/MacroInfo.h"
20	#include "clang/Sema/CodeCompleteOptions.h"
21	#include "clang/Sema/DeclSpec.h"
22	#include "llvm/ADT/ArrayRef.h"
23	#include "llvm/ADT/DenseMap.h"
24	#include "llvm/ADT/SmallPtrSet.h"
25	#include "llvm/ADT/SmallVector.h"
26	#include "llvm/ADT/StringRef.h"
27	#include "llvm/Support/Allocator.h"
28	#include "llvm/Support/type_traits.h"
29	#include <cassert>
30	#include <memory>
31	#include <optional>
32	#include <string>
33	#include <utility>
34
35	namespace clang {
36
37	class ASTContext;
38	class Decl;
39	class DeclContext;
40	class FunctionDecl;
41	class FunctionTemplateDecl;
42	class IdentifierInfo;
43	class LangOptions;
44	class NamedDecl;
45	class NestedNameSpecifier;
46	class Preprocessor;
47	class RawComment;
48	class Sema;
49	class UsingShadowDecl;
50
51	/// Default priority values for code-completion results based
52	/// on their kind.
53	enum {
54	/// Priority for the next initialization in a constructor initializer
55	/// list.
56	CCP_NextInitializer = 7,
57
58	/// Priority for an enumeration constant inside a switch whose
59	/// condition is of the enumeration type.
60	CCP_EnumInCase = 7,
61
62	/// Priority for a send-to-super completion.
63	CCP_SuperCompletion = 20,
64
65	/// Priority for a declaration that is in the local scope.
66	CCP_LocalDeclaration = 34,
67
68	/// Priority for a member declaration found from the current
69	/// method or member function.
70	CCP_MemberDeclaration = 35,
71
72	/// Priority for a language keyword (that isn't any of the other
73	/// categories).
74	CCP_Keyword = 40,
75
76	/// Priority for a code pattern.
77	CCP_CodePattern = 40,
78
79	/// Priority for a non-type declaration.
80	CCP_Declaration = 50,
81
82	/// Priority for a type.
83	CCP_Type = CCP_Declaration,
84
85	/// Priority for a constant value (e.g., enumerator).
86	CCP_Constant = 65,
87
88	/// Priority for a preprocessor macro.
89	CCP_Macro = 70,
90
91	/// Priority for a nested-name-specifier.
92	CCP_NestedNameSpecifier = 75,
93
94	/// Priority for a result that isn't likely to be what the user wants,
95	/// but is included for completeness.
96	CCP_Unlikely = 80,
97
98	/// Priority for the Objective-C "_cmd" implicit parameter.
99	CCP_ObjC_cmd = CCP_Unlikely
100	};
101
102	/// Priority value deltas that are added to code-completion results
103	/// based on the context of the result.
104	enum {
105	/// The result is in a base class.
106	CCD_InBaseClass = 2,
107
108	/// The result is a C++ non-static member function whose qualifiers
109	/// exactly match the object type on which the member function can be called.
110	CCD_ObjectQualifierMatch = -1,
111
112	/// The selector of the given message exactly matches the selector
113	/// of the current method, which might imply that some kind of delegation
114	/// is occurring.
115	CCD_SelectorMatch = -3,
116
117	/// Adjustment to the "bool" type in Objective-C, where the typedef
118	/// "BOOL" is preferred.
119	CCD_bool_in_ObjC = 1,
120
121	/// Adjustment for KVC code pattern priorities when it doesn't look
122	/// like the
123	CCD_ProbablyNotObjCCollection = 15,
124
125	/// An Objective-C method being used as a property.
126	CCD_MethodAsProperty = 2,
127
128	/// An Objective-C block property completed as a setter with a
129	/// block placeholder.
130	CCD_BlockPropertySetter = 3
131	};
132
133	/// Priority value factors by which we will divide or multiply the
134	/// priority of a code-completion result.
135	enum {
136	/// Divide by this factor when a code-completion result's type exactly
137	/// matches the type we expect.
138	CCF_ExactTypeMatch = 4,
139
140	/// Divide by this factor when a code-completion result's type is
141	/// similar to the type we expect (e.g., both arithmetic types, both
142	/// Objective-C object pointer types).
143	CCF_SimilarTypeMatch = 2
144	};
145
146	/// A simplified classification of types used when determining
147	/// "similar" types for code completion.
148	enum SimplifiedTypeClass {
149	STC_Arithmetic,
150	STC_Array,
151	STC_Block,
152	STC_Function,
153	STC_ObjectiveC,
154	STC_Other,
155	STC_Pointer,
156	STC_Record,
157	STC_Void
158	};
159
160	/// Determine the simplified type class of the given canonical type.
161	SimplifiedTypeClass getSimplifiedTypeClass(CanQualType T);
162
163	/// Determine the type that this declaration will have if it is used
164	/// as a type or in an expression.
165	QualType getDeclUsageType(ASTContext &C, const NamedDecl *ND);
166
167	/// Determine the priority to be given to a macro code completion result
168	/// with the given name.
169	///
170	/// \param MacroName The name of the macro.
171	///
172	/// \param LangOpts Options describing the current language dialect.
173	///
174	/// \param PreferredTypeIsPointer Whether the preferred type for the context
175	/// of this macro is a pointer type.
176	unsigned getMacroUsagePriority(StringRef MacroName,
177	const LangOptions &LangOpts,
178	bool PreferredTypeIsPointer = false);
179
180	/// Determine the libclang cursor kind associated with the given
181	/// declaration.
182	CXCursorKind getCursorKindForDecl(const Decl *D);
183
184	/// The context in which code completion occurred, so that the
185	/// code-completion consumer can process the results accordingly.
186	class CodeCompletionContext {
187	public:
188	enum Kind {
189	/// An unspecified code-completion context.
190	CCC_Other,
191
192	/// An unspecified code-completion context where we should also add
193	/// macro completions.
194	CCC_OtherWithMacros,
195
196	/// Code completion occurred within a "top-level" completion context,
197	/// e.g., at namespace or global scope.
198	CCC_TopLevel,
199
200	/// Code completion occurred within an Objective-C interface,
201	/// protocol, or category interface.
202	CCC_ObjCInterface,
203
204	/// Code completion occurred within an Objective-C implementation
205	/// or category implementation.
206	CCC_ObjCImplementation,
207
208	/// Code completion occurred within the instance variable list of
209	/// an Objective-C interface, implementation, or category implementation.
210	CCC_ObjCIvarList,
211
212	/// Code completion occurred within a class, struct, or union.
213	CCC_ClassStructUnion,
214
215	/// Code completion occurred where a statement (or declaration) is
216	/// expected in a function, method, or block.
217	CCC_Statement,
218
219	/// Code completion occurred where an expression is expected.
220	CCC_Expression,
221
222	/// Code completion occurred where an Objective-C message receiver
223	/// is expected.
224	CCC_ObjCMessageReceiver,
225
226	/// Code completion occurred on the right-hand side of a member
227	/// access expression using the dot operator.
228	///
229	/// The results of this completion are the members of the type being
230	/// accessed. The type itself is available via
231	/// \c CodeCompletionContext::getType().
232	CCC_DotMemberAccess,
233
234	/// Code completion occurred on the right-hand side of a member
235	/// access expression using the arrow operator.
236	///
237	/// The results of this completion are the members of the type being
238	/// accessed. The type itself is available via
239	/// \c CodeCompletionContext::getType().
240	CCC_ArrowMemberAccess,
241
242	/// Code completion occurred on the right-hand side of an Objective-C
243	/// property access expression.
244	///
245	/// The results of this completion are the members of the type being
246	/// accessed. The type itself is available via
247	/// \c CodeCompletionContext::getType().
248	CCC_ObjCPropertyAccess,
249
250	/// Code completion occurred after the "enum" keyword, to indicate
251	/// an enumeration name.
252	CCC_EnumTag,
253
254	/// Code completion occurred after the "union" keyword, to indicate
255	/// a union name.
256	CCC_UnionTag,
257
258	/// Code completion occurred after the "struct" or "class" keyword,
259	/// to indicate a struct or class name.
260	CCC_ClassOrStructTag,
261
262	/// Code completion occurred where a protocol name is expected.
263	CCC_ObjCProtocolName,
264
265	/// Code completion occurred where a namespace or namespace alias
266	/// is expected.
267	CCC_Namespace,
268
269	/// Code completion occurred where a type name is expected.
270	CCC_Type,
271
272	/// Code completion occurred where a new name is expected.
273	CCC_NewName,
274
275	/// Code completion occurred where both a new name and an existing symbol is
276	/// permissible.
277	CCC_SymbolOrNewName,
278
279	/// Code completion occurred where an existing name(such as type, function
280	/// or variable) is expected.
281	CCC_Symbol,
282
283	/// Code completion occurred where an macro is being defined.
284	CCC_MacroName,
285
286	/// Code completion occurred where a macro name is expected
287	/// (without any arguments, in the case of a function-like macro).
288	CCC_MacroNameUse,
289
290	/// Code completion occurred within a preprocessor expression.
291	CCC_PreprocessorExpression,
292
293	/// Code completion occurred where a preprocessor directive is
294	/// expected.
295	CCC_PreprocessorDirective,
296
297	/// Code completion occurred in a context where natural language is
298	/// expected, e.g., a comment or string literal.
299	///
300	/// This context usually implies that no completions should be added,
301	/// unless they come from an appropriate natural-language dictionary.
302	CCC_NaturalLanguage,
303
304	/// Code completion for a selector, as in an \@selector expression.
305	CCC_SelectorName,
306
307	/// Code completion within a type-qualifier list.
308	CCC_TypeQualifiers,
309
310	/// Code completion in a parenthesized expression, which means that
311	/// we may also have types here in C and Objective-C (as well as in C++).
312	CCC_ParenthesizedExpression,
313
314	/// Code completion where an Objective-C instance message is
315	/// expected.
316	CCC_ObjCInstanceMessage,
317
318	/// Code completion where an Objective-C class message is expected.
319	CCC_ObjCClassMessage,
320
321	/// Code completion where the name of an Objective-C class is
322	/// expected.
323	CCC_ObjCInterfaceName,
324
325	/// Code completion where an Objective-C category name is expected.
326	CCC_ObjCCategoryName,
327
328	/// Code completion inside the filename part of a #include directive.
329	CCC_IncludedFile,
330
331	/// Code completion of an attribute name.
332	CCC_Attribute,
333
334	/// An unknown context, in which we are recovering from a parsing
335	/// error and don't know which completions we should give.
336	CCC_Recovery
337	};
338
339	using VisitedContextSet = llvm::SmallPtrSet<DeclContext *, 8>;
340
341	private:
342	Kind CCKind;
343
344	/// Indicates whether we are completing a name of a using declaration, e.g.
345	/// using ^;
346	/// using a::^;
347	bool IsUsingDeclaration;
348
349	/// The type that would prefer to see at this point (e.g., the type
350	/// of an initializer or function parameter).
351	QualType PreferredType;
352
353	/// The type of the base object in a member access expression.
354	QualType BaseType;
355
356	/// The identifiers for Objective-C selector parts.
357	ArrayRef<IdentifierInfo *> SelIdents;
358
359	/// The scope specifier that comes before the completion token e.g.
360	/// "a::b::"
361	std::optional<CXXScopeSpec> ScopeSpecifier;
362
363	/// A set of declaration contexts visited by Sema when doing lookup for
364	/// code completion.
365	VisitedContextSet VisitedContexts;
366
367	public:
368	/// Construct a new code-completion context of the given kind.
369	CodeCompletionContext(Kind CCKind)
370	: CCKind(CCKind), IsUsingDeclaration(false), SelIdents(std::nullopt) {}
371
372	/// Construct a new code-completion context of the given kind.
373	CodeCompletionContext(Kind CCKind, QualType T,
374	ArrayRef<IdentifierInfo *> SelIdents = std::nullopt)
375	: CCKind(CCKind), IsUsingDeclaration(false), SelIdents(SelIdents) {
376	if (CCKind == CCC_DotMemberAccess \|\| CCKind == CCC_ArrowMemberAccess \|\|
377	CCKind == CCC_ObjCPropertyAccess \|\| CCKind == CCC_ObjCClassMessage \|\|
378	CCKind == CCC_ObjCInstanceMessage)
379	BaseType = T;
380	else
381	PreferredType = T;
382	}
383
384	bool isUsingDeclaration() const { return IsUsingDeclaration; }
385	void setIsUsingDeclaration(bool V) { IsUsingDeclaration = V; }
386
387	/// Retrieve the kind of code-completion context.
388	Kind getKind() const { return CCKind; }
389
390	/// Retrieve the type that this expression would prefer to have, e.g.,
391	/// if the expression is a variable initializer or a function argument, the
392	/// type of the corresponding variable or function parameter.
393	QualType getPreferredType() const { return PreferredType; }
394	void setPreferredType(QualType T) { PreferredType = T; }
395
396	/// Retrieve the type of the base object in a member-access
397	/// expression.
398	QualType getBaseType() const { return BaseType; }
399
400	/// Retrieve the Objective-C selector identifiers.
401	ArrayRef<IdentifierInfo *> getSelIdents() const { return SelIdents; }
402
403	/// Determines whether we want C++ constructors as results within this
404	/// context.
405	bool wantConstructorResults() const;
406
407	/// Sets the scope specifier that comes before the completion token.
408	/// This is expected to be set in code completions on qualfied specifiers
409	/// (e.g. "a::b::").
410	void setCXXScopeSpecifier(CXXScopeSpec SS) {
411	this->ScopeSpecifier = std::move(SS);
412	}
413
414	/// Adds a visited context.
415	void addVisitedContext(DeclContext *Ctx) {
416	VisitedContexts.insert(Ctx);
417	}
418
419	/// Retrieves all visited contexts.
420	const VisitedContextSet &getVisitedContexts() const {
421	return VisitedContexts;
422	}
423
424	std::optional<const CXXScopeSpec *> getCXXScopeSpecifier() {
425	if (ScopeSpecifier)
426	return &*ScopeSpecifier;
427	return std::nullopt;
428	}
429	};
430
431	/// Get string representation of \p Kind, useful for debugging.
432	llvm::StringRef getCompletionKindString(CodeCompletionContext::Kind Kind);
433
434	/// A "string" used to describe how code completion can
435	/// be performed for an entity.
436	///
437	/// A code completion string typically shows how a particular entity can be
438	/// used. For example, the code completion string for a function would show
439	/// the syntax to call it, including the parentheses, placeholders for the
440	/// arguments, etc.
441	class CodeCompletionString {
442	public:
443	/// The different kinds of "chunks" that can occur within a code
444	/// completion string.
445	enum ChunkKind {
446	/// The piece of text that the user is expected to type to
447	/// match the code-completion string, typically a keyword or the name of a
448	/// declarator or macro.
449	CK_TypedText,
450
451	/// A piece of text that should be placed in the buffer, e.g.,
452	/// parentheses or a comma in a function call.
453	CK_Text,
454
455	/// A code completion string that is entirely optional. For example,
456	/// an optional code completion string that describes the default arguments
457	/// in a function call.
458	CK_Optional,
459
460	/// A string that acts as a placeholder for, e.g., a function
461	/// call argument.
462	CK_Placeholder,
463
464	/// A piece of text that describes something about the result but
465	/// should not be inserted into the buffer.
466	CK_Informative,
467	/// A piece of text that describes the type of an entity or, for
468	/// functions and methods, the return type.
469	CK_ResultType,
470
471	/// A piece of text that describes the parameter that corresponds
472	/// to the code-completion location within a function call, message send,
473	/// macro invocation, etc.
474	CK_CurrentParameter,
475
476	/// A left parenthesis ('(').
477	CK_LeftParen,
478
479	/// A right parenthesis (')').
480	CK_RightParen,
481
482	/// A left bracket ('[').
483	CK_LeftBracket,
484
485	/// A right bracket (']').
486	CK_RightBracket,
487
488	/// A left brace ('{').
489	CK_LeftBrace,
490
491	/// A right brace ('}').
492	CK_RightBrace,
493
494	/// A left angle bracket ('<').
495	CK_LeftAngle,
496
497	/// A right angle bracket ('>').
498	CK_RightAngle,
499
500	/// A comma separator (',').
501	CK_Comma,
502
503	/// A colon (':').
504	CK_Colon,
505
506	/// A semicolon (';').
507	CK_SemiColon,
508
509	/// An '=' sign.
510	CK_Equal,
511
512	/// Horizontal whitespace (' ').
513	CK_HorizontalSpace,
514
515	/// Vertical whitespace ('\\n' or '\\r\\n', depending on the
516	/// platform).
517	CK_VerticalSpace
518	};
519
520	/// One piece of the code completion string.
521	struct Chunk {
522	/// The kind of data stored in this piece of the code completion
523	/// string.
524	ChunkKind Kind = CK_Text;
525
526	union {
527	/// The text string associated with a CK_Text, CK_Placeholder,
528	/// CK_Informative, or CK_Comma chunk.
529	/// The string is owned by the chunk and will be deallocated
530	/// (with delete[]) when the chunk is destroyed.
531	const char *Text;
532
533	/// The code completion string associated with a CK_Optional chunk.
534	/// The optional code completion string is owned by the chunk, and will
535	/// be deallocated (with delete) when the chunk is destroyed.
536	CodeCompletionString *Optional;
537	};
538
539	Chunk() : Text(nullptr) {}
540
541	explicit Chunk(ChunkKind Kind, const char *Text = "");
542
543	/// Create a new text chunk.
544	static Chunk CreateText(const char *Text);
545
546	/// Create a new optional chunk.
547	static Chunk CreateOptional(CodeCompletionString *Optional);
548
549	/// Create a new placeholder chunk.
550	static Chunk CreatePlaceholder(const char *Placeholder);
551
552	/// Create a new informative chunk.
553	static Chunk CreateInformative(const char *Informative);
554
555	/// Create a new result type chunk.
556	static Chunk CreateResultType(const char *ResultType);
557
558	/// Create a new current-parameter chunk.
559	static Chunk CreateCurrentParameter(const char *CurrentParameter);
560	};
561
562	private:
563	friend class CodeCompletionBuilder;
564	friend class CodeCompletionResult;
565
566	/// The number of chunks stored in this string.
567	unsigned NumChunks : 16;
568
569	/// The number of annotations for this code-completion result.
570	unsigned NumAnnotations : 16;
571
572	/// The priority of this code-completion string.
573	unsigned Priority : 16;
574
575	/// The availability of this code-completion result.
576	unsigned Availability : 2;
577
578	/// The name of the parent context.
579	StringRef ParentName;
580
581	/// A brief documentation comment attached to the declaration of
582	/// entity being completed by this result.
583	const char *BriefComment;
584
585	CodeCompletionString(const Chunk *Chunks, unsigned NumChunks,
586	unsigned Priority, CXAvailabilityKind Availability,
587	const char **Annotations, unsigned NumAnnotations,
588	StringRef ParentName,
589	const char *BriefComment);
590	~CodeCompletionString() = default;
591
592	public:
593	CodeCompletionString(const CodeCompletionString &) = delete;
594	CodeCompletionString &operator=(const CodeCompletionString &) = delete;
595
596	using iterator = const Chunk *;
597
598	iterator begin() const { return reinterpret_cast<const Chunk *>(this + 1); }
599	iterator end() const { return begin() + NumChunks; }
600	bool empty() const { return NumChunks == 0; }
601	unsigned size() const { return NumChunks; }
602
603	const Chunk &operator[](unsigned I) const {
604	assert(I < size() && "Chunk index out-of-range")(static_cast <bool> (I < size() && "Chunk index out-of-range" ) ? void (0) : __assert_fail ("I < size() && \"Chunk index out-of-range\"" , "clang/include/clang/Sema/CodeCompleteConsumer.h", 604, __extension__ __PRETTY_FUNCTION__));
605	return begin()[I];
606	}
607
608	/// Returns the text in the first TypedText chunk.
609	const char *getTypedText() const;
610
611	/// Returns the combined text from all TypedText chunks.
612	std::string getAllTypedText() const;
613
614	/// Retrieve the priority of this code completion result.
615	unsigned getPriority() const { return Priority; }
616
617	/// Retrieve the availability of this code completion result.
618	unsigned getAvailability() const { return Availability; }
619
620	/// Retrieve the number of annotations for this code completion result.
621	unsigned getAnnotationCount() const;
622
623	/// Retrieve the annotation string specified by \c AnnotationNr.
624	const char *getAnnotation(unsigned AnnotationNr) const;
625
626	/// Retrieve the name of the parent context.
627	StringRef getParentContextName() const {
628	return ParentName;
629	}
630
631	const char *getBriefComment() const {
632	return BriefComment;
633	}
634
635	/// Retrieve a string representation of the code completion string,
636	/// which is mainly useful for debugging.
637	std::string getAsString() const;
638	};
639
640	/// An allocator used specifically for the purpose of code completion.
641	class CodeCompletionAllocator : public llvm::BumpPtrAllocator {
642	public:
643	/// Copy the given string into this allocator.
644	const char *CopyString(const Twine &String);
645	};
646
647	/// Allocator for a cached set of global code completions.
648	class GlobalCodeCompletionAllocator : public CodeCompletionAllocator {};
649
650	class CodeCompletionTUInfo {
651	llvm::DenseMap<const DeclContext *, StringRef> ParentNames;
652	std::shared_ptr<GlobalCodeCompletionAllocator> AllocatorRef;
653
654	public:
655	explicit CodeCompletionTUInfo(
656	std::shared_ptr<GlobalCodeCompletionAllocator> Allocator)
657	: AllocatorRef(std::move(Allocator)) {}
658
659	std::shared_ptr<GlobalCodeCompletionAllocator> getAllocatorRef() const {
660	return AllocatorRef;
661	}
662
663	CodeCompletionAllocator &getAllocator() const {
664	assert(AllocatorRef)(static_cast <bool> (AllocatorRef) ? void (0) : __assert_fail ("AllocatorRef", "clang/include/clang/Sema/CodeCompleteConsumer.h" , 664, __extension__ __PRETTY_FUNCTION__));
665	return *AllocatorRef;
666	}
667
668	StringRef getParentName(const DeclContext *DC);
669	};
670
671	} // namespace clang
672
673	namespace clang {
674
675	/// A builder class used to construct new code-completion strings.
676	class CodeCompletionBuilder {
677	public:
678	using Chunk = CodeCompletionString::Chunk;
679
680	private:
681	CodeCompletionAllocator &Allocator;
682	CodeCompletionTUInfo &CCTUInfo;
683	unsigned Priority = 0;
684	CXAvailabilityKind Availability = CXAvailability_Available;
685	StringRef ParentName;
686	const char *BriefComment = nullptr;
687
688	/// The chunks stored in this string.
689	SmallVector<Chunk, 4> Chunks;
690
691	SmallVector<const char *, 2> Annotations;
692
693	public:
694	CodeCompletionBuilder(CodeCompletionAllocator &Allocator,
695	CodeCompletionTUInfo &CCTUInfo)
696	: Allocator(Allocator), CCTUInfo(CCTUInfo) {}
697
698	CodeCompletionBuilder(CodeCompletionAllocator &Allocator,
699	CodeCompletionTUInfo &CCTUInfo,
700	unsigned Priority, CXAvailabilityKind Availability)
701	: Allocator(Allocator), CCTUInfo(CCTUInfo), Priority(Priority),
702	Availability(Availability) {}
703
704	/// Retrieve the allocator into which the code completion
705	/// strings should be allocated.
706	CodeCompletionAllocator &getAllocator() const { return Allocator; }
707
708	CodeCompletionTUInfo &getCodeCompletionTUInfo() const { return CCTUInfo; }
709
710	/// Take the resulting completion string.
711	///
712	/// This operation can only be performed once.
713	CodeCompletionString *TakeString();
714
715	/// Add a new typed-text chunk.
716	void AddTypedTextChunk(const char *Text);
717
718	/// Add a new text chunk.
719	void AddTextChunk(const char *Text);
720
721	/// Add a new optional chunk.
722	void AddOptionalChunk(CodeCompletionString *Optional);
723
724	/// Add a new placeholder chunk.
725	void AddPlaceholderChunk(const char *Placeholder);
726
727	/// Add a new informative chunk.
728	void AddInformativeChunk(const char *Text);
729
730	/// Add a new result-type chunk.
731	void AddResultTypeChunk(const char *ResultType);
732
733	/// Add a new current-parameter chunk.
734	void AddCurrentParameterChunk(const char *CurrentParameter);
735
736	/// Add a new chunk.
737	void AddChunk(CodeCompletionString::ChunkKind CK, const char *Text = "");
738
739	void AddAnnotation(const char *A) { Annotations.push_back(A); }
740
741	/// Add the parent context information to this code completion.
742	void addParentContext(const DeclContext *DC);
743
744	const char *getBriefComment() const { return BriefComment; }
745	void addBriefComment(StringRef Comment);
746
747	StringRef getParentName() const { return ParentName; }
748	};
749
750	/// Captures a result of code completion.
751	class CodeCompletionResult {
752	public:
753	/// Describes the kind of result generated.
754	enum ResultKind {
755	/// Refers to a declaration.
756	RK_Declaration = 0,
757
758	/// Refers to a keyword or symbol.
759	RK_Keyword,
760
761	/// Refers to a macro.
762	RK_Macro,
763
764	/// Refers to a precomputed pattern.
765	RK_Pattern
766	};
767
768	/// When Kind == RK_Declaration or RK_Pattern, the declaration we are
769	/// referring to. In the latter case, the declaration might be NULL.
770	const NamedDecl *Declaration = nullptr;
771
772	union {
773	/// When Kind == RK_Keyword, the string representing the keyword
774	/// or symbol's spelling.
775	const char *Keyword;
776
777	/// When Kind == RK_Pattern, the code-completion string that
778	/// describes the completion text to insert.
779	CodeCompletionString *Pattern;
780
781	/// When Kind == RK_Macro, the identifier that refers to a macro.
782	const IdentifierInfo *Macro;
783	};
784
785	/// The priority of this particular code-completion result.
786	unsigned Priority;
787
788	/// Specifies which parameter (of a function, Objective-C method,
789	/// macro, etc.) we should start with when formatting the result.
790	unsigned StartParameter = 0;
791
792	/// The kind of result stored here.
793	ResultKind Kind;
794
795	/// The cursor kind that describes this result.
796	CXCursorKind CursorKind;
797
798	/// The availability of this result.
799	CXAvailabilityKind Availability = CXAvailability_Available;
800
801	/// Fix-its that must be applied before inserting the text for the
802	/// corresponding completion.
803	///
804	/// By default, CodeCompletionBuilder only returns completions with empty
805	/// fix-its. Extra completions with non-empty fix-its should be explicitly
806	/// requested by setting CompletionOptions::IncludeFixIts.
807	///
808	/// For the clients to be able to compute position of the cursor after
809	/// applying fix-its, the following conditions are guaranteed to hold for
810	/// RemoveRange of the stored fix-its:
811	/// - Ranges in the fix-its are guaranteed to never contain the completion
812	/// point (or identifier under completion point, if any) inside them, except
813	/// at the start or at the end of the range.
814	/// - If a fix-it range starts or ends with completion point (or starts or
815	/// ends after the identifier under completion point), it will contain at
816	/// least one character. It allows to unambiguously recompute completion
817	/// point after applying the fix-it.
818	///
819	/// The intuition is that provided fix-its change code around the identifier
820	/// we complete, but are not allowed to touch the identifier itself or the
821	/// completion point. One example of completions with corrections are the ones
822	/// replacing '.' with '->' and vice versa:
823	///
824	/// std::unique_ptr<std::vector<int>> vec_ptr;
825	/// In 'vec_ptr.^', one of the completions is 'push_back', it requires
826	/// replacing '.' with '->'.
827	/// In 'vec_ptr->^', one of the completions is 'release', it requires
828	/// replacing '->' with '.'.
829	std::vector<FixItHint> FixIts;
830
831	/// Whether this result is hidden by another name.
832	bool Hidden : 1;
833
834	/// Whether this is a class member from base class.
835	bool InBaseClass : 1;
836
837	/// Whether this result was found via lookup into a base class.
838	bool QualifierIsInformative : 1;
839
840	/// Whether this declaration is the beginning of a
841	/// nested-name-specifier and, therefore, should be followed by '::'.
842	bool StartsNestedNameSpecifier : 1;
843
844	/// Whether all parameters (of a function, Objective-C
845	/// method, etc.) should be considered "informative".
846	bool AllParametersAreInformative : 1;
847
848	/// Whether we're completing a declaration of the given entity,
849	/// rather than a use of that entity.
850	bool DeclaringEntity : 1;
851
852	/// When completing a function, whether it can be a call. This will usually be
853	/// true, but we have some heuristics, e.g. when a pointer to a non-static
854	/// member function is completed outside of that class' scope, it can never
855	/// be a call.
856	bool FunctionCanBeCall : 1;
857
858	/// If the result should have a nested-name-specifier, this is it.
859	/// When \c QualifierIsInformative, the nested-name-specifier is
860	/// informative rather than required.
861	NestedNameSpecifier *Qualifier = nullptr;
862
863	/// If this Decl was unshadowed by using declaration, this can store a
864	/// pointer to the UsingShadowDecl which was used in the unshadowing process.
865	/// This information can be used to uprank CodeCompletionResults / which have
866	/// corresponding `using decl::qualified::name;` nearby.
867	const UsingShadowDecl *ShadowDecl = nullptr;
868
869	/// If the result is RK_Macro, this can store the information about the macro
870	/// definition. This should be set in most cases but can be missing when
871	/// the macro has been undefined.
872	const MacroInfo *MacroDefInfo = nullptr;
873
874	/// Build a result that refers to a declaration.
875	CodeCompletionResult(const NamedDecl *Declaration, unsigned Priority,
876	NestedNameSpecifier *Qualifier = nullptr,
877	bool QualifierIsInformative = false,
878	bool Accessible = true,
879	std::vector<FixItHint> FixIts = std::vector<FixItHint>())
880	: Declaration(Declaration), Priority(Priority), Kind(RK_Declaration),
881	FixIts(std::move(FixIts)), Hidden(false), InBaseClass(false),
882	QualifierIsInformative(QualifierIsInformative),
883	StartsNestedNameSpecifier(false), AllParametersAreInformative(false),
884	DeclaringEntity(false), FunctionCanBeCall(true), Qualifier(Qualifier) {
885	// FIXME: Add assert to check FixIts range requirements.
886	computeCursorKindAndAvailability(Accessible);
887	}
888
889	/// Build a result that refers to a keyword or symbol.
890	CodeCompletionResult(const char *Keyword, unsigned Priority = CCP_Keyword)
891	: Keyword(Keyword), Priority(Priority), Kind(RK_Keyword),
892	CursorKind(CXCursor_NotImplemented), Hidden(false), InBaseClass(false),
893	QualifierIsInformative(false), StartsNestedNameSpecifier(false),
894	AllParametersAreInformative(false), DeclaringEntity(false),
895	FunctionCanBeCall(true) {}
896
897	/// Build a result that refers to a macro.
898	CodeCompletionResult(const IdentifierInfo *Macro,
899	const MacroInfo *MI = nullptr,
900	unsigned Priority = CCP_Macro)
901	: Macro(Macro), Priority(Priority), Kind(RK_Macro),
902	CursorKind(CXCursor_MacroDefinition), Hidden(false), InBaseClass(false),
903	QualifierIsInformative(false), StartsNestedNameSpecifier(false),
904	AllParametersAreInformative(false), DeclaringEntity(false),
905	FunctionCanBeCall(true), MacroDefInfo(MI) {}
906
907	/// Build a result that refers to a pattern.
908	CodeCompletionResult(
909	CodeCompletionString *Pattern, unsigned Priority = CCP_CodePattern,
910	CXCursorKind CursorKind = CXCursor_NotImplemented,
911	CXAvailabilityKind Availability = CXAvailability_Available,
912	const NamedDecl *D = nullptr)
913	: Declaration(D), Pattern(Pattern), Priority(Priority), Kind(RK_Pattern),
914	CursorKind(CursorKind), Availability(Availability), Hidden(false),
915	InBaseClass(false), QualifierIsInformative(false),
916	StartsNestedNameSpecifier(false), AllParametersAreInformative(false),
917	DeclaringEntity(false), FunctionCanBeCall(true) {}
918
919	/// Build a result that refers to a pattern with an associated
920	/// declaration.
921	CodeCompletionResult(CodeCompletionString Pattern, const NamedDecl D,
922	unsigned Priority)
923	: Declaration(D), Pattern(Pattern), Priority(Priority), Kind(RK_Pattern),
924	Hidden(false), InBaseClass(false), QualifierIsInformative(false),
925	StartsNestedNameSpecifier(false), AllParametersAreInformative(false),
926	DeclaringEntity(false), FunctionCanBeCall(true) {
927	computeCursorKindAndAvailability();
928	}
929
930	/// Retrieve the declaration stored in this result. This might be nullptr if
931	/// Kind is RK_Pattern.
932	const NamedDecl *getDeclaration() const {
933	assert(((Kind == RK_Declaration) \|\| (Kind == RK_Pattern)) &&(static_cast <bool> (((Kind == RK_Declaration) \|\| (Kind == RK_Pattern)) && "Not a declaration or pattern result" ) ? void (0) : __assert_fail ("((Kind == RK_Declaration) \|\| (Kind == RK_Pattern)) && \"Not a declaration or pattern result\"" , "clang/include/clang/Sema/CodeCompleteConsumer.h", 934, __extension__ __PRETTY_FUNCTION__))
934	"Not a declaration or pattern result")(static_cast <bool> (((Kind == RK_Declaration) \|\| (Kind == RK_Pattern)) && "Not a declaration or pattern result" ) ? void (0) : __assert_fail ("((Kind == RK_Declaration) \|\| (Kind == RK_Pattern)) && \"Not a declaration or pattern result\"" , "clang/include/clang/Sema/CodeCompleteConsumer.h", 934, __extension__ __PRETTY_FUNCTION__));
935	return Declaration;
936	}
937
938	/// Retrieve the keyword stored in this result.
939	const char *getKeyword() const {
940	assert(Kind == RK_Keyword && "Not a keyword result")(static_cast <bool> (Kind == RK_Keyword && "Not a keyword result" ) ? void (0) : __assert_fail ("Kind == RK_Keyword && \"Not a keyword result\"" , "clang/include/clang/Sema/CodeCompleteConsumer.h", 940, __extension__ __PRETTY_FUNCTION__));
941	return Keyword;
942	}
943
944	/// Create a new code-completion string that describes how to insert
945	/// this result into a program.
946	///
947	/// \param S The semantic analysis that created the result.
948	///
949	/// \param Allocator The allocator that will be used to allocate the
950	/// string itself.
951	CodeCompletionString *CreateCodeCompletionString(Sema &S,
952	const CodeCompletionContext &CCContext,
953	CodeCompletionAllocator &Allocator,
954	CodeCompletionTUInfo &CCTUInfo,
955	bool IncludeBriefComments);
956	CodeCompletionString *CreateCodeCompletionString(ASTContext &Ctx,
957	Preprocessor &PP,
958	const CodeCompletionContext &CCContext,
959	CodeCompletionAllocator &Allocator,
960	CodeCompletionTUInfo &CCTUInfo,
961	bool IncludeBriefComments);
962	/// Creates a new code-completion string for the macro result. Similar to the
963	/// above overloads, except this only requires preprocessor information.
964	/// The result kind must be `RK_Macro`.
965	CodeCompletionString *
966	CreateCodeCompletionStringForMacro(Preprocessor &PP,
967	CodeCompletionAllocator &Allocator,
968	CodeCompletionTUInfo &CCTUInfo);
969
970	CodeCompletionString *createCodeCompletionStringForDecl(
971	Preprocessor &PP, ASTContext &Ctx, CodeCompletionBuilder &Result,
972	bool IncludeBriefComments, const CodeCompletionContext &CCContext,
973	PrintingPolicy &Policy);
974
975	CodeCompletionString *createCodeCompletionStringForOverride(
976	Preprocessor &PP, ASTContext &Ctx, CodeCompletionBuilder &Result,
977	bool IncludeBriefComments, const CodeCompletionContext &CCContext,
978	PrintingPolicy &Policy);
979
980	/// Retrieve the name that should be used to order a result.
981	///
982	/// If the name needs to be constructed as a string, that string will be
983	/// saved into Saved and the returned StringRef will refer to it.
984	StringRef getOrderedName(std::string &Saved) const;
985
986	private:
987	void computeCursorKindAndAvailability(bool Accessible = true);
988	};
989
990	bool operator<(const CodeCompletionResult &X, const CodeCompletionResult &Y);
991
992	inline bool operator>(const CodeCompletionResult &X,
993	const CodeCompletionResult &Y) {
994	return Y < X;
995	}
996
997	inline bool operator<=(const CodeCompletionResult &X,
998	const CodeCompletionResult &Y) {
999	return !(Y < X);
1000	}
1001
1002	inline bool operator>=(const CodeCompletionResult &X,
1003	const CodeCompletionResult &Y) {
1004	return !(X < Y);
1005	}
1006
1007	/// Abstract interface for a consumer of code-completion
1008	/// information.
1009	class CodeCompleteConsumer {
1010	protected:
1011	const CodeCompleteOptions CodeCompleteOpts;
1012
1013	public:
1014	class OverloadCandidate {
1015	public:
1016	/// Describes the type of overload candidate.
1017	enum CandidateKind {
1018	/// The candidate is a function declaration.
1019	CK_Function,
1020
1021	/// The candidate is a function template, arguments are being completed.
1022	CK_FunctionTemplate,
1023
1024	/// The "candidate" is actually a variable, expression, or block
1025	/// for which we only have a function prototype.
1026	CK_FunctionType,
1027
1028	/// The candidate is a variable or expression of function type
1029	/// for which we have the location of the prototype declaration.
1030	CK_FunctionProtoTypeLoc,
1031
1032	/// The candidate is a template, template arguments are being completed.
1033	CK_Template,
1034
1035	/// The candidate is aggregate initialization of a record type.
1036	CK_Aggregate,
1037	};
1038
1039	private:
1040	/// The kind of overload candidate.
1041	CandidateKind Kind;
1042
1043	union {
1044	/// The function overload candidate, available when
1045	/// Kind == CK_Function.
1046	FunctionDecl *Function;
1047
1048	/// The function template overload candidate, available when
1049	/// Kind == CK_FunctionTemplate.
1050	FunctionTemplateDecl *FunctionTemplate;
1051
1052	/// The function type that describes the entity being called,
1053	/// when Kind == CK_FunctionType.
1054	const FunctionType *Type;
1055
1056	/// The location of the function prototype that describes the entity being
1057	/// called, when Kind == CK_FunctionProtoTypeLoc.
1058	FunctionProtoTypeLoc ProtoTypeLoc;
1059
1060	/// The template overload candidate, available when
1061	/// Kind == CK_Template.
1062	const TemplateDecl *Template;
1063
1064	/// The class being aggregate-initialized,
1065	/// when Kind == CK_Aggregate
1066	const RecordDecl *AggregateType;
1067	};
1068
1069	public:
1070	OverloadCandidate(FunctionDecl *Function)
1071	: Kind(CK_Function), Function(Function) {
1072	assert(Function != nullptr)(static_cast <bool> (Function != nullptr) ? void (0) : __assert_fail ("Function != nullptr", "clang/include/clang/Sema/CodeCompleteConsumer.h" , 1072, __extension__ __PRETTY_FUNCTION__));
1073	}
1074
1075	OverloadCandidate(FunctionTemplateDecl *FunctionTemplateDecl)
1076	: Kind(CK_FunctionTemplate), FunctionTemplate(FunctionTemplateDecl) {
1077	assert(FunctionTemplateDecl != nullptr)(static_cast <bool> (FunctionTemplateDecl != nullptr) ? void (0) : __assert_fail ("FunctionTemplateDecl != nullptr", "clang/include/clang/Sema/CodeCompleteConsumer.h", 1077, __extension__ __PRETTY_FUNCTION__));
1078	}
1079
1080	OverloadCandidate(const FunctionType *Type)
1081	: Kind(CK_FunctionType), Type(Type) {
1082	assert(Type != nullptr)(static_cast <bool> (Type != nullptr) ? void (0) : __assert_fail ("Type != nullptr", "clang/include/clang/Sema/CodeCompleteConsumer.h" , 1082, __extension__ __PRETTY_FUNCTION__));
1083	}
1084
1085	OverloadCandidate(FunctionProtoTypeLoc Prototype)
1086	: Kind(CK_FunctionProtoTypeLoc), ProtoTypeLoc(Prototype) {
1087	assert(!Prototype.isNull())(static_cast <bool> (!Prototype.isNull()) ? void (0) : __assert_fail ("!Prototype.isNull()", "clang/include/clang/Sema/CodeCompleteConsumer.h" , 1087, __extension__ __PRETTY_FUNCTION__));
1088	}
1089
1090	OverloadCandidate(const RecordDecl *Aggregate)
1091	: Kind(CK_Aggregate), AggregateType(Aggregate) {
1092	assert(Aggregate != nullptr)(static_cast <bool> (Aggregate != nullptr) ? void (0) : __assert_fail ("Aggregate != nullptr", "clang/include/clang/Sema/CodeCompleteConsumer.h" , 1092, __extension__ __PRETTY_FUNCTION__));
1093	}
1094
1095	OverloadCandidate(const TemplateDecl *Template)
1096	: Kind(CK_Template), Template(Template) {}
1097
1098	/// Determine the kind of overload candidate.
1099	CandidateKind getKind() const { return Kind; }
1100
1101	/// Retrieve the function overload candidate or the templated
1102	/// function declaration for a function template.
1103	FunctionDecl *getFunction() const;
1104
1105	/// Retrieve the function template overload candidate.
1106	FunctionTemplateDecl *getFunctionTemplate() const {
1107	assert(getKind() == CK_FunctionTemplate && "Not a function template")(static_cast <bool> (getKind() == CK_FunctionTemplate && "Not a function template") ? void (0) : __assert_fail ("getKind() == CK_FunctionTemplate && \"Not a function template\"" , "clang/include/clang/Sema/CodeCompleteConsumer.h", 1107, __extension__ __PRETTY_FUNCTION__));
1108	return FunctionTemplate;
1109	}
1110
1111	/// Retrieve the function type of the entity, regardless of how the
1112	/// function is stored.
1113	const FunctionType *getFunctionType() const;
1114
1115	/// Retrieve the function ProtoTypeLoc candidate.
1116	/// This can be called for any Kind, but returns null for kinds
1117	/// other than CK_FunctionProtoTypeLoc.
1118	const FunctionProtoTypeLoc getFunctionProtoTypeLoc() const;
1119
1120	const TemplateDecl *getTemplate() const {
1121	assert(getKind() == CK_Template && "Not a template")(static_cast <bool> (getKind() == CK_Template && "Not a template") ? void (0) : __assert_fail ("getKind() == CK_Template && \"Not a template\"" , "clang/include/clang/Sema/CodeCompleteConsumer.h", 1121, __extension__ __PRETTY_FUNCTION__));
1122	return Template;
1123	}
1124
1125	/// Retrieve the aggregate type being initialized.
1126	const RecordDecl *getAggregate() const {
1127	assert(getKind() == CK_Aggregate)(static_cast <bool> (getKind() == CK_Aggregate) ? void ( 0) : __assert_fail ("getKind() == CK_Aggregate", "clang/include/clang/Sema/CodeCompleteConsumer.h" , 1127, __extension__ __PRETTY_FUNCTION__));
1128	return AggregateType;
1129	}
1130
1131	/// Get the number of parameters in this signature.
1132	unsigned getNumParams() const;
1133
1134	/// Get the type of the Nth parameter.
1135	/// Returns null if the type is unknown or N is out of range.
1136	QualType getParamType(unsigned N) const;
1137
1138	/// Get the declaration of the Nth parameter.
1139	/// Returns null if the decl is unknown or N is out of range.
1140	const NamedDecl *getParamDecl(unsigned N) const;
1141
1142	/// Create a new code-completion string that describes the function
1143	/// signature of this overload candidate.
1144	CodeCompletionString *
1145	CreateSignatureString(unsigned CurrentArg, Sema &S,
1146	CodeCompletionAllocator &Allocator,
1147	CodeCompletionTUInfo &CCTUInfo,
1148	bool IncludeBriefComments, bool Braced) const;
1149	};
1150
1151	CodeCompleteConsumer(const CodeCompleteOptions &CodeCompleteOpts)
1152	: CodeCompleteOpts(CodeCompleteOpts) {}
1153
1154	/// Whether the code-completion consumer wants to see macros.
1155	bool includeMacros() const {
1156	return CodeCompleteOpts.IncludeMacros;
1157	}
1158
1159	/// Whether the code-completion consumer wants to see code patterns.
1160	bool includeCodePatterns() const {
1161	return CodeCompleteOpts.IncludeCodePatterns;
1162	}
1163
1164	/// Whether to include global (top-level) declaration results.
1165	bool includeGlobals() const { return CodeCompleteOpts.IncludeGlobals; }
1166
1167	/// Whether to include declarations in namespace contexts (including
1168	/// the global namespace). If this is false, `includeGlobals()` will be
1169	/// ignored.
1170	bool includeNamespaceLevelDecls() const {
1171	return CodeCompleteOpts.IncludeNamespaceLevelDecls;
1172	}
1173
1174	/// Whether to include brief documentation comments within the set of
1175	/// code completions returned.
1176	bool includeBriefComments() const {
1177	return CodeCompleteOpts.IncludeBriefComments;
1178	}
1179
1180	/// Whether to include completion items with small fix-its, e.g. change
1181	/// '.' to '->' on member access, etc.
1182	bool includeFixIts() const { return CodeCompleteOpts.IncludeFixIts; }
1183
1184	/// Hint whether to load data from the external AST in order to provide
1185	/// full results. If false, declarations from the preamble may be omitted.
1186	bool loadExternal() const {
1187	return CodeCompleteOpts.LoadExternal;
1188	}
1189
1190	/// Deregisters and destroys this code-completion consumer.
1191	virtual ~CodeCompleteConsumer();
1192
1193	/// \name Code-completion filtering
1194	/// Check if the result should be filtered out.
1195	virtual bool isResultFilteredOut(StringRef Filter,
1196	CodeCompletionResult Results) {
1197	return false;
1198	}
1199
1200	/// \name Code-completion callbacks
1201	//@{
1202	/// Process the finalized code-completion results.
1203	virtual void ProcessCodeCompleteResults(Sema &S,
1204	CodeCompletionContext Context,
1205	CodeCompletionResult *Results,
1206	unsigned NumResults) {}
1207
1208	/// \param S the semantic-analyzer object for which code-completion is being
1209	/// done.
1210	///
1211	/// \param CurrentArg the index of the current argument.
1212	///
1213	/// \param Candidates an array of overload candidates.
1214	///
1215	/// \param NumCandidates the number of overload candidates
1216	///
1217	/// \param OpenParLoc location of the opening parenthesis of the argument
1218	/// list.
1219	virtual void ProcessOverloadCandidates(Sema &S, unsigned CurrentArg,
1220	OverloadCandidate *Candidates,
1221	unsigned NumCandidates,
1222	SourceLocation OpenParLoc,
1223	bool Braced) {}
1224	//@}
1225
1226	/// Retrieve the allocator that will be used to allocate
1227	/// code completion strings.
1228	virtual CodeCompletionAllocator &getAllocator() = 0;
1229
1230	virtual CodeCompletionTUInfo &getCodeCompletionTUInfo() = 0;
1231	};
1232
1233	/// Get the documentation comment used to produce
1234	/// CodeCompletionString::BriefComment for RK_Declaration.
1235	const RawComment *getCompletionComment(const ASTContext &Ctx,
1236	const NamedDecl *Decl);
1237
1238	/// Get the documentation comment used to produce
1239	/// CodeCompletionString::BriefComment for RK_Pattern.
1240	const RawComment *getPatternCompletionComment(const ASTContext &Ctx,
1241	const NamedDecl *Decl);
1242
1243	/// Get the documentation comment used to produce
1244	/// CodeCompletionString::BriefComment for OverloadCandidate.
1245	const RawComment *
1246	getParameterComment(const ASTContext &Ctx,
1247	const CodeCompleteConsumer::OverloadCandidate &Result,
1248	unsigned ArgIndex);
1249
1250	/// A simple code-completion consumer that prints the results it
1251	/// receives in a simple format.
1252	class PrintingCodeCompleteConsumer : public CodeCompleteConsumer {
1253	/// The raw output stream.
1254	raw_ostream &OS;
1255
1256	CodeCompletionTUInfo CCTUInfo;
1257
1258	public:
1259	/// Create a new printing code-completion consumer that prints its
1260	/// results to the given raw output stream.
1261	PrintingCodeCompleteConsumer(const CodeCompleteOptions &CodeCompleteOpts,
1262	raw_ostream &OS)
1263	: CodeCompleteConsumer(CodeCompleteOpts), OS(OS),
1264	CCTUInfo(std::make_shared<GlobalCodeCompletionAllocator>()) {}
1265
1266	/// Prints the finalized code-completion results.
1267	void ProcessCodeCompleteResults(Sema &S, CodeCompletionContext Context,
1268	CodeCompletionResult *Results,
1269	unsigned NumResults) override;
1270
1271	void ProcessOverloadCandidates(Sema &S, unsigned CurrentArg,
1272	OverloadCandidate *Candidates,
1273	unsigned NumCandidates,
1274	SourceLocation OpenParLoc,
1275	bool Braced) override;
1276
1277	bool isResultFilteredOut(StringRef Filter, CodeCompletionResult Results) override;
1278
1279	CodeCompletionAllocator &getAllocator() override {
1280	return CCTUInfo.getAllocator();
1281	}
1282
1283	CodeCompletionTUInfo &getCodeCompletionTUInfo() override { return CCTUInfo; }
1284	};
1285
1286	} // namespace clang
1287
1288	#endif // LLVM_CLANG_SEMA_CODECOMPLETECONSUMER_H

←

/usr/lib/gcc/x86_64-linux-gnu/10/../../../../include/c++/10/optional

→

1// <optional> -*- C++ -*-

3// Copyright (C) 2013-2020 Free Software Foundation, Inc.
4//
5// This file is part of the GNU ISO C++ Library.  This library is free
6// software; you can redistribute it and/or modify it under the
7// terms of the GNU General Public License as published by the
8// Free Software Foundation; either version 3, or (at your option)
9// any later version.

11// This library is distributed in the hope that it will be useful,
12// but WITHOUT ANY WARRANTY; without even the implied warranty of
13// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14// GNU General Public License for more details.

16// Under Section 7 of GPL version 3, you are granted additional
17// permissions described in the GCC Runtime Library Exception, version
18// 3.1, as published by the Free Software Foundation.

20// You should have received a copy of the GNU General Public License and
21// a copy of the GCC Runtime Library Exception along with this program;
22// see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
23// <http://www.gnu.org/licenses/>.

25/** @file include/optional
*  This is a Standard C++ Library header.
*/

29#ifndef _GLIBCXX_OPTIONAL1
30#define _GLIBCXX_OPTIONAL1 1

32#pragma GCC system_header

34#if __cplusplus201703L >= 201703L

36#include <utility>
37#include <type_traits>
38#include <exception>
39#include <new>
40#include <initializer_list>
41#include <bits/exception_defines.h>
42#include <bits/functional_hash.h>
43#include <bits/enable_special_members.h>
44#if __cplusplus201703L > 201703L
45# include <compare>
46#endif

48namespace std _GLIBCXX_VISIBILITY(default)__attribute__ ((__visibility__ ("default")))
49{
50_GLIBCXX_BEGIN_NAMESPACE_VERSION

/**
 *  @addtogroup utilities
 *  @{
 */

57#define __cpp_lib_optional201606L 201606L

template<typename _Tp>
  class optional;

/// Tag type to disengage optional objects.
struct nullopt_t
{
  // Do not user-declare default constructor at all for
  // optional_value = {} syntax to work.
  // nullopt_t() = delete;

  // Used for constructing nullopt.
  enum class _Construct { _Token };

  // Must be constexpr for nullopt_t to be literal.
  explicit constexpr nullopt_t(_Construct) { }
};

/// Tag to disengage optional objects.
inline constexpr nullopt_t nullopt { nullopt_t::_Construct::_Token };

/**
 *  @brief Exception class thrown when a disengaged optional object is
 *  dereferenced.
 *  @ingroup exceptions
 */
class bad_optional_access : public exception
{
public:
  bad_optional_access() { }

  virtual const char* what() const noexcept override
  { return "bad optional access"; }

  virtual ~bad_optional_access() noexcept = default;
};

void
__throw_bad_optional_access()
__attribute__((__noreturn__));

// XXX Does not belong here.
inline void
__throw_bad_optional_access()
{ _GLIBCXX_THROW_OR_ABORT(bad_optional_access())(__builtin_abort()); }

// This class template manages construction/destruction of
// the contained value for a std::optional.
template <typename _Tp>
  struct _Optional_payload_base
  {
    using _Stored_type = remove_const_t<_Tp>;

    _Optional_payload_base() = default;
    ~_Optional_payload_base() = default;
20
←
Calling '~_Storage'→

    template<typename... _Args>
constexpr
_Optional_payload_base(in_place_t __tag, _Args&&... __args)
: _M_payload(__tag, std::forward<_Args>(__args)...),
 _M_engaged(true)
{ }

    template<typename _Up, typename... _Args>
constexpr
_Optional_payload_base(std::initializer_list<_Up> __il,
	       _Args&&... __args)
: _M_payload(__il, std::forward<_Args>(__args)...),
 _M_engaged(true)
{ }

    // Constructor used by _Optional_base copy constructor when the
    // contained value is not trivially copy constructible.
    constexpr
    _Optional_payload_base(bool __engaged,
	     const _Optional_payload_base& __other)
    {
if (__other._M_engaged)
 this->_M_construct(__other._M_get());
    }

    // Constructor used by _Optional_base move constructor when the
    // contained value is not trivially move constructible.
    constexpr
    _Optional_payload_base(bool __engaged,
	     _Optional_payload_base&& __other)
    {
if (__other._M_engaged)
 this->_M_construct(std::move(__other._M_get()));
    }

    // Copy constructor is only used to when the contained value is
    // trivially copy constructible.
    _Optional_payload_base(const _Optional_payload_base&) = default;

    // Move constructor is only used to when the contained value is
    // trivially copy constructible.
    _Optional_payload_base(_Optional_payload_base&&) = default;

    _Optional_payload_base&
    operator=(const _Optional_payload_base&) = default;

    _Optional_payload_base&
    operator=(_Optional_payload_base&&) = default;

    // used to perform non-trivial copy assignment.
    constexpr void
    _M_copy_assign(const _Optional_payload_base& __other)
    {
      if (this->_M_engaged && __other._M_engaged)
        this->_M_get() = __other._M_get();
      else
 {
   if (__other._M_engaged)
     this->_M_construct(__other._M_get());
   else
     this->_M_reset();
 }
    }

    // used to perform non-trivial move assignment.
    constexpr void
    _M_move_assign(_Optional_payload_base&& __other)
    noexcept(__and_v<is_nothrow_move_constructible<_Tp>,
       is_nothrow_move_assignable<_Tp>>)
    {
if (this->_M_engaged && __other._M_engaged)
 this->_M_get() = std::move(__other._M_get());
else
 {
   if (__other._M_engaged)
     this->_M_construct(std::move(__other._M_get()));
   else
     this->_M_reset();
 }
    }

    struct _Empty_byte { };

    template<typename _Up, bool = is_trivially_destructible_v<_Up>>
union _Storage
{
 constexpr _Storage() noexcept : _M_empty() { }

 template<typename... _Args>
   constexpr
   _Storage(in_place_t, _Args&&... __args)
   : _M_value(std::forward<_Args>(__args)...)
   { }

 template<typename _Vp, typename... _Args>
   constexpr
   _Storage(std::initializer_list<_Vp> __il, _Args&&... __args)
   : _M_value(__il, std::forward<_Args>(__args)...)
   { }

 _Empty_byte _M_empty;
        _Up _M_value;
};

    template<typename _Up>
union _Storage<_Up, false>
{
 constexpr _Storage() noexcept : _M_empty() { }

 template<typename... _Args>
   constexpr
   _Storage(in_place_t, _Args&&... __args)
   : _M_value(std::forward<_Args>(__args)...)
   { }

 template<typename _Vp, typename... _Args>
   constexpr
   _Storage(std::initializer_list<_Vp> __il, _Args&&... __args)
   : _M_value(__il, std::forward<_Args>(__args)...)
   { }

 // User-provided destructor is needed when _Up has non-trivial dtor.
 ~_Storage() { }
21
←
Calling implicit destructor for 'CXXScopeSpec'→
22
←
Calling '~NestedNameSpecifierLocBuilder'→

 _Empty_byte _M_empty;
        _Up _M_value;
};

    _Storage<_Stored_type> _M_payload;

    bool _M_engaged = false;

    template<typename... _Args>
      void
      _M_construct(_Args&&... __args)
      noexcept(is_nothrow_constructible_v<_Stored_type, _Args...>)
      {
        ::new ((void *) std::__addressof(this->_M_payload))
          _Stored_type(std::forward<_Args>(__args)...);
        this->_M_engaged = true;
      }

    constexpr void
    _M_destroy() noexcept
    {
_M_engaged = false;
_M_payload._M_value.~_Stored_type();
9
←
Calling implicit destructor for 'CXXScopeSpec'→
10
←
Calling '~NestedNameSpecifierLocBuilder'→
14
←
Returning from '~NestedNameSpecifierLocBuilder'→
15
←
Returning; memory was released→
    }

    // The _M_get() operations have _M_engaged as a precondition.
    // They exist to access the contained value with the appropriate
    // const-qualification, because _M_payload has had the const removed.

    constexpr _Tp&
    _M_get() noexcept
    { return this->_M_payload._M_value; }

    constexpr const _Tp&
    _M_get() const noexcept
    { return this->_M_payload._M_value; }

    // _M_reset is a 'safe' operation with no precondition.
    constexpr void
    _M_reset() noexcept
    {
if (this->_M_engaged)
6
←
Assuming field '_M_engaged' is true→
7
←
Taking true branch→
 _M_destroy();
8
←
Calling '_Optional_payload_base::_M_destroy'→
16
←
Returning; memory was released→
    }
  };

// Class template that manages the payload for optionals.
template <typename _Tp,
   bool /*_HasTrivialDestructor*/ =
     is_trivially_destructible_v<_Tp>,
   bool /*_HasTrivialCopy */ =
     is_trivially_copy_assignable_v<_Tp>
     && is_trivially_copy_constructible_v<_Tp>,
   bool /*_HasTrivialMove */ =
     is_trivially_move_assignable_v<_Tp>
     && is_trivially_move_constructible_v<_Tp>>
  struct _Optional_payload;

// Payload for potentially-constexpr optionals (trivial copy/move/destroy).
template <typename _Tp>
  struct _Optional_payload<_Tp, true, true, true>
  : _Optional_payload_base<_Tp>
  {
    using _Optional_payload_base<_Tp>::_Optional_payload_base;

    _Optional_payload() = default;
  };

// Payload for optionals with non-trivial copy construction/assignment.
template <typename _Tp>
  struct _Optional_payload<_Tp, true, false, true>
  : _Optional_payload_base<_Tp>
  {
    using _Optional_payload_base<_Tp>::_Optional_payload_base;

    _Optional_payload() = default;
    ~_Optional_payload() = default;
    _Optional_payload(const _Optional_payload&) = default;
    _Optional_payload(_Optional_payload&&) = default;
    _Optional_payload& operator=(_Optional_payload&&) = default;

    // Non-trivial copy assignment.
    constexpr
    _Optional_payload&
    operator=(const _Optional_payload& __other)
    {
this->_M_copy_assign(__other);
return *this;
    }
  };

// Payload for optionals with non-trivial move construction/assignment.
template <typename _Tp>
  struct _Optional_payload<_Tp, true, true, false>
  : _Optional_payload_base<_Tp>
  {
    using _Optional_payload_base<_Tp>::_Optional_payload_base;

    _Optional_payload() = default;
    ~_Optional_payload() = default;
    _Optional_payload(const _Optional_payload&) = default;
    _Optional_payload(_Optional_payload&&) = default;
    _Optional_payload& operator=(const _Optional_payload&) = default;

    // Non-trivial move assignment.
    constexpr
    _Optional_payload&
    operator=(_Optional_payload&& __other)
    noexcept(__and_v<is_nothrow_move_constructible<_Tp>,
       is_nothrow_move_assignable<_Tp>>)
    {
this->_M_move_assign(std::move(__other));
return *this;
    }
  };

// Payload for optionals with non-trivial copy and move assignment.
template <typename _Tp>
  struct _Optional_payload<_Tp, true, false, false>
  : _Optional_payload_base<_Tp>
  {
    using _Optional_payload_base<_Tp>::_Optional_payload_base;

    _Optional_payload() = default;
    ~_Optional_payload() = default;
19
←
Calling defaulted destructor for '_Optional_payload_base<clang::CXXScopeSpec>'→
    _Optional_payload(const _Optional_payload&) = default;
    _Optional_payload(_Optional_payload&&) = default;

    // Non-trivial copy assignment.
    constexpr
    _Optional_payload&
    operator=(const _Optional_payload& __other)
    {
this->_M_copy_assign(__other);
return *this;
    }

    // Non-trivial move assignment.
    constexpr
    _Optional_payload&
    operator=(_Optional_payload&& __other)
    noexcept(__and_v<is_nothrow_move_constructible<_Tp>,
       is_nothrow_move_assignable<_Tp>>)
    {
this->_M_move_assign(std::move(__other));
return *this;
    }
  };

// Payload for optionals with non-trivial destructors.
template <typename _Tp, bool _Copy, bool _Move>
  struct _Optional_payload<_Tp, false, _Copy, _Move>
  : _Optional_payload<_Tp, true, false, false>
  {
    // Base class implements all the constructors and assignment operators:
    using _Optional_payload<_Tp, true, false, false>::_Optional_payload;
    _Optional_payload() = default;
    _Optional_payload(const _Optional_payload&) = default;
    _Optional_payload(_Optional_payload&&) = default;
    _Optional_payload& operator=(const _Optional_payload&) = default;
    _Optional_payload& operator=(_Optional_payload&&) = default;

    // Destructor needs to destroy the contained value:
    ~_Optional_payload() { this->_M_reset(); }
5
←
Calling '_Optional_payload_base::_M_reset'→
17
←
Returning; memory was released→
18
←
Calling defaulted destructor for '_Optional_payload<clang::CXXScopeSpec, true, false, false>'→
  };

// Common base class for _Optional_base<T> to avoid repeating these
// member functions in each specialization.
template<typename _Tp, typename _Dp>
  class _Optional_base_impl
  {
  protected:
    using _Stored_type = remove_const_t<_Tp>;

    // The _M_construct operation has !_M_engaged as a precondition
    // while _M_destruct has _M_engaged as a precondition.
    template<typename... _Args>
void
_M_construct(_Args&&... __args)
noexcept(is_nothrow_constructible_v<_Stored_type, _Args...>)
{
 ::new
   (std::__addressof(static_cast<_Dp*>(this)->_M_payload._M_payload))
   _Stored_type(std::forward<_Args>(__args)...);
 static_cast<_Dp*>(this)->_M_payload._M_engaged = true;
}

    void
    _M_destruct() noexcept
    { static_cast<_Dp*>(this)->_M_payload._M_destroy(); }

    // _M_reset is a 'safe' operation with no precondition.
    constexpr void
    _M_reset() noexcept
    { static_cast<_Dp*>(this)->_M_payload._M_reset(); }

    constexpr bool _M_is_engaged() const noexcept
    { return static_cast<const _Dp*>(this)->_M_payload._M_engaged; }

    // The _M_get operations have _M_engaged as a precondition.
    constexpr _Tp&
    _M_get() noexcept
    {
__glibcxx_assert(this->_M_is_engaged())do { if (! (this->_M_is_engaged())) std::__replacement_assert
("/usr/lib/gcc/x86_64-linux-gnu/10/../../../../include/c++/10/optional"
, 441, __PRETTY_FUNCTION__, "this->_M_is_engaged()"); } while
 (false);
return static_cast<_Dp*>(this)->_M_payload._M_get();
    }

    constexpr const _Tp&
    _M_get() const noexcept
    {
__glibcxx_assert(this->_M_is_engaged())do { if (! (this->_M_is_engaged())) std::__replacement_assert
("/usr/lib/gcc/x86_64-linux-gnu/10/../../../../include/c++/10/optional"
, 448, __PRETTY_FUNCTION__, "this->_M_is_engaged()"); } while
 (false);
return static_cast<const _Dp*>(this)->_M_payload._M_get();
    }
  };

/**
  * @brief Class template that provides copy/move constructors of optional.
  *
  * Such a separate base class template is necessary in order to
  * conditionally make copy/move constructors trivial.
  *
  * When the contained value is trivially copy/move constructible,
  * the copy/move constructors of _Optional_base will invoke the
  * trivial copy/move constructor of _Optional_payload. Otherwise,
  * they will invoke _Optional_payload(bool, const _Optional_payload&)
  * or _Optional_payload(bool, _Optional_payload&&) to initialize
  * the contained value, if copying/moving an engaged optional.
  *
  * Whether the other special members are trivial is determined by the
  * _Optional_payload<_Tp> specialization used for the _M_payload member.
  *
  * @see optional, _Enable_special_members
  */
template<typename _Tp,
  bool = is_trivially_copy_constructible_v<_Tp>,
  bool = is_trivially_move_constructible_v<_Tp>>
  struct _Optional_base
    : _Optional_base_impl<_Tp, _Optional_base<_Tp>>
  {
    // Constructors for disengaged optionals.
    constexpr _Optional_base() = default;

    // Constructors for engaged optionals.
    template<typename... _Args,
      enable_if_t<is_constructible_v<_Tp, _Args&&...>, bool> = false>
      constexpr explicit _Optional_base(in_place_t, _Args&&... __args)
      : _M_payload(in_place,
     std::forward<_Args>(__args)...) { }

    template<typename _Up, typename... _Args,
             enable_if_t<is_constructible_v<_Tp,
			      initializer_list<_Up>&,
			      _Args&&...>, bool> = false>
      constexpr explicit _Optional_base(in_place_t,
                                        initializer_list<_Up> __il,
                                        _Args&&... __args)
      : _M_payload(in_place,
     __il, std::forward<_Args>(__args)...)
      { }

    // Copy and move constructors.
    constexpr _Optional_base(const _Optional_base& __other)
: _M_payload(__other._M_payload._M_engaged,
     __other._M_payload)
    { }

    constexpr _Optional_base(_Optional_base&& __other)
    noexcept(is_nothrow_move_constructible_v<_Tp>)
: _M_payload(__other._M_payload._M_engaged,
     std::move(__other._M_payload))
    { }

    // Assignment operators.
    _Optional_base& operator=(const _Optional_base&) = default;
    _Optional_base& operator=(_Optional_base&&) = default;

    _Optional_payload<_Tp> _M_payload;
  };

template<typename _Tp>
  struct _Optional_base<_Tp, false, true>
    : _Optional_base_impl<_Tp, _Optional_base<_Tp>>
  {
    // Constructors for disengaged optionals.
    constexpr _Optional_base() = default;

    // Constructors for engaged optionals.
    template<typename... _Args,
      enable_if_t<is_constructible_v<_Tp, _Args&&...>, bool> = false>
      constexpr explicit _Optional_base(in_place_t, _Args&&... __args)
      : _M_payload(in_place,
     std::forward<_Args>(__args)...) { }

    template<typename _Up, typename... _Args,
             enable_if_t<is_constructible_v<_Tp,
			      initializer_list<_Up>&,
			      _Args&&...>, bool> = false>
      constexpr explicit _Optional_base(in_place_t,
                                        initializer_list<_Up> __il,
                                        _Args&&... __args)
      : _M_payload(in_place,
     __il, std::forward<_Args>(__args)...)
      { }

    // Copy and move constructors.
    constexpr _Optional_base(const _Optional_base& __other)
: _M_payload(__other._M_payload._M_engaged,
     __other._M_payload)
    { }

    constexpr _Optional_base(_Optional_base&& __other) = default;

    // Assignment operators.
    _Optional_base& operator=(const _Optional_base&) = default;
    _Optional_base& operator=(_Optional_base&&) = default;

    _Optional_payload<_Tp> _M_payload;
  };

template<typename _Tp>
  struct _Optional_base<_Tp, true, false>
    : _Optional_base_impl<_Tp, _Optional_base<_Tp>>
  {
    // Constructors for disengaged optionals.
    constexpr _Optional_base() = default;

    // Constructors for engaged optionals.
    template<typename... _Args,
      enable_if_t<is_constructible_v<_Tp, _Args&&...>, bool> = false>
      constexpr explicit _Optional_base(in_place_t, _Args&&... __args)
      : _M_payload(in_place,
     std::forward<_Args>(__args)...) { }

    template<typename _Up, typename... _Args,
             enable_if_t<is_constructible_v<_Tp,
			      initializer_list<_Up>&,
			      _Args&&...>, bool> = false>
      constexpr explicit _Optional_base(in_place_t,
                                        initializer_list<_Up> __il,
                                        _Args&&... __args)
      : _M_payload(in_place,
     __il, std::forward<_Args>(__args)...)
      { }

    // Copy and move constructors.
    constexpr _Optional_base(const _Optional_base& __other) = default;

    constexpr _Optional_base(_Optional_base&& __other)
    noexcept(is_nothrow_move_constructible_v<_Tp>)
: _M_payload(__other._M_payload._M_engaged,
     std::move(__other._M_payload))
    { }

    // Assignment operators.
    _Optional_base& operator=(const _Optional_base&) = default;
    _Optional_base& operator=(_Optional_base&&) = default;

    _Optional_payload<_Tp> _M_payload;
  };

template<typename _Tp>
  struct _Optional_base<_Tp, true, true>
    : _Optional_base_impl<_Tp, _Optional_base<_Tp>>
  {
    // Constructors for disengaged optionals.
    constexpr _Optional_base() = default;

    // Constructors for engaged optionals.
    template<typename... _Args,
      enable_if_t<is_constructible_v<_Tp, _Args&&...>, bool> = false>
      constexpr explicit _Optional_base(in_place_t, _Args&&... __args)
      : _M_payload(in_place,
     std::forward<_Args>(__args)...) { }

    template<typename _Up, typename... _Args,
             enable_if_t<is_constructible_v<_Tp,
			      initializer_list<_Up>&,
			      _Args&&...>, bool> = false>
      constexpr explicit _Optional_base(in_place_t,
                                        initializer_list<_Up> __il,
                                        _Args&&... __args)
      : _M_payload(in_place,
     __il, std::forward<_Args>(__args)...)
      { }

    // Copy and move constructors.
    constexpr _Optional_base(const _Optional_base& __other) = default;
    constexpr _Optional_base(_Optional_base&& __other) = default;

    // Assignment operators.
    _Optional_base& operator=(const _Optional_base&) = default;
    _Optional_base& operator=(_Optional_base&&) = default;

    _Optional_payload<_Tp> _M_payload;
  };

template<typename _Tp>
class optional;

template<typename _Tp, typename _Up>
  using __converts_from_optional =
    __or_<is_constructible<_Tp, const optional<_Up>&>,
   is_constructible<_Tp, optional<_Up>&>,
   is_constructible<_Tp, const optional<_Up>&&>,
   is_constructible<_Tp, optional<_Up>&&>,
   is_convertible<const optional<_Up>&, _Tp>,
   is_convertible<optional<_Up>&, _Tp>,
   is_convertible<const optional<_Up>&&, _Tp>,
   is_convertible<optional<_Up>&&, _Tp>>;

template<typename _Tp, typename _Up>
  using __assigns_from_optional =
    __or_<is_assignable<_Tp&, const optional<_Up>&>,
   is_assignable<_Tp&, optional<_Up>&>,
   is_assignable<_Tp&, const optional<_Up>&&>,
   is_assignable<_Tp&, optional<_Up>&&>>;

/**
  * @brief Class template for optional values.
  */
template<typename _Tp>
  class optional
  : private _Optional_base<_Tp>,
    private _Enable_copy_move<
// Copy constructor.
is_copy_constructible_v<_Tp>,
// Copy assignment.
__and_v<is_copy_constructible<_Tp>, is_copy_assignable<_Tp>>,
// Move constructor.
is_move_constructible_v<_Tp>,
// Move assignment.
__and_v<is_move_constructible<_Tp>, is_move_assignable<_Tp>>,
// Unique tag type.
optional<_Tp>>
  {
    static_assert(!is_same_v<remove_cv_t<_Tp>, nullopt_t>);
    static_assert(!is_same_v<remove_cv_t<_Tp>, in_place_t>);
    static_assert(!is_reference_v<_Tp>);

  private:
    using _Base = _Optional_base<_Tp>;

    // SFINAE helpers
    template<typename _Up>
using __not_self = __not_<is_same<optional, __remove_cvref_t<_Up>>>;
    template<typename _Up>
using __not_tag = __not_<is_same<in_place_t, __remove_cvref_t<_Up>>>;
    template<typename... _Cond>
using _Requires = enable_if_t<__and_v<_Cond...>, bool>;

  public:
    using value_type = _Tp;

    constexpr optional() = default;

    constexpr optional(nullopt_t) noexcept { }

    // Converting constructors for engaged optionals.
    template<typename _Up = _Tp,
      _Requires<__not_self<_Up>, __not_tag<_Up>,
	 is_constructible<_Tp, _Up&&>,
	 is_convertible<_Up&&, _Tp>> = true>
constexpr
optional(_Up&& __t)
: _Base(std::in_place, std::forward<_Up>(__t)) { }

    template<typename _Up = _Tp,
      _Requires<__not_self<_Up>, __not_tag<_Up>,
	 is_constructible<_Tp, _Up&&>,
	 __not_<is_convertible<_Up&&, _Tp>>> = false>
explicit constexpr
optional(_Up&& __t)
      : _Base(std::in_place, std::forward<_Up>(__t)) { }

    template<typename _Up,
      _Requires<__not_<is_same<_Tp, _Up>>,
	 is_constructible<_Tp, const _Up&>,
	 is_convertible<const _Up&, _Tp>,
	 __not_<__converts_from_optional<_Tp, _Up>>> = true>
constexpr
optional(const optional<_Up>& __t)
{
 if (__t)
   emplace(*__t);
}

    template<typename _Up,
      _Requires<__not_<is_same<_Tp, _Up>>,
	 is_constructible<_Tp, const _Up&>,
	 __not_<is_convertible<const _Up&, _Tp>>,
	 __not_<__converts_from_optional<_Tp, _Up>>> = false>
explicit constexpr
optional(const optional<_Up>& __t)
{
 if (__t)
   emplace(*__t);
}

    template <typename _Up,
_Requires<__not_<is_same<_Tp, _Up>>,
	  is_constructible<_Tp, _Up&&>,
	  is_convertible<_Up&&, _Tp>,
	  __not_<__converts_from_optional<_Tp, _Up>>> = true>
constexpr
optional(optional<_Up>&& __t)
{
 if (__t)
   emplace(std::move(*__t));
}

    template <typename _Up,
_Requires<__not_<is_same<_Tp, _Up>>,
	  is_constructible<_Tp, _Up&&>,
	  __not_<is_convertible<_Up&&, _Tp>>,
	  __not_<__converts_from_optional<_Tp, _Up>>> = false>
explicit constexpr
optional(optional<_Up>&& __t)
{
 if (__t)
   emplace(std::move(*__t));
}

    template<typename... _Args,
      _Requires<is_constructible<_Tp, _Args&&...>> = false>
explicit constexpr
optional(in_place_t, _Args&&... __args)
: _Base(std::in_place, std::forward<_Args>(__args)...) { }

    template<typename _Up, typename... _Args,
      _Requires<is_constructible<_Tp,
			  initializer_list<_Up>&,
			  _Args&&...>> = false>
explicit constexpr
optional(in_place_t, initializer_list<_Up> __il, _Args&&... __args)
: _Base(std::in_place, __il, std::forward<_Args>(__args)...) { }

    // Assignment operators.
    optional&
    operator=(nullopt_t) noexcept
    {
this->_M_reset();
return *this;
    }

    template<typename _Up = _Tp>
enable_if_t<__and_v<__not_self<_Up>,
	    __not_<__and_<is_scalar<_Tp>,
			  is_same<_Tp, decay_t<_Up>>>>,
	    is_constructible<_Tp, _Up>,
	    is_assignable<_Tp&, _Up>>,
    optional&>
operator=(_Up&& __u)
{
 if (this->_M_is_engaged())
   this->_M_get() = std::forward<_Up>(__u);
 else
   this->_M_construct(std::forward<_Up>(__u));

 return *this;
}

    template<typename _Up>
enable_if_t<__and_v<__not_<is_same<_Tp, _Up>>,
	    is_constructible<_Tp, const _Up&>,
	    is_assignable<_Tp&, _Up>,
	    __not_<__converts_from_optional<_Tp, _Up>>,
	    __not_<__assigns_from_optional<_Tp, _Up>>>,
    optional&>
operator=(const optional<_Up>& __u)
{
 if (__u)
   {
     if (this->_M_is_engaged())
this->_M_get() = *__u;
     else
this->_M_construct(*__u);
   }
 else
   {
     this->_M_reset();
   }
 return *this;
}

    template<typename _Up>
      enable_if_t<__and_v<__not_<is_same<_Tp, _Up>>,
	    is_constructible<_Tp, _Up>,
	    is_assignable<_Tp&, _Up>,
	    __not_<__converts_from_optional<_Tp, _Up>>,
	    __not_<__assigns_from_optional<_Tp, _Up>>>,
    optional&>
operator=(optional<_Up>&& __u)
{
 if (__u)
   {
     if (this->_M_is_engaged())
this->_M_get() = std::move(*__u);
     else
this->_M_construct(std::move(*__u));
   }
 else
   {
     this->_M_reset();
   }

 return *this;
}

    template<typename... _Args>
enable_if_t<is_constructible_v<_Tp, _Args&&...>, _Tp&>
emplace(_Args&&... __args)
{
 this->_M_reset();
 this->_M_construct(std::forward<_Args>(__args)...);
 return this->_M_get();
}

    template<typename _Up, typename... _Args>
enable_if_t<is_constructible_v<_Tp, initializer_list<_Up>&,
		       _Args&&...>, _Tp&>
emplace(initializer_list<_Up> __il, _Args&&... __args)
{
 this->_M_reset();
 this->_M_construct(__il, std::forward<_Args>(__args)...);
 return this->_M_get();
}

    // Destructor is implicit, implemented in _Optional_base.

    // Swap.
    void
    swap(optional& __other)
    noexcept(is_nothrow_move_constructible_v<_Tp>
      && is_nothrow_swappable_v<_Tp>)
    {
using std::swap;

if (this->_M_is_engaged() && __other._M_is_engaged())
 swap(this->_M_get(), __other._M_get());
else if (this->_M_is_engaged())
 {
   __other._M_construct(std::move(this->_M_get()));
   this->_M_destruct();
 }
else if (__other._M_is_engaged())
 {
   this->_M_construct(std::move(__other._M_get()));
   __other._M_destruct();
 }
    }

    // Observers.
    constexpr const _Tp*
    operator->() const
    { return std::__addressof(this->_M_get()); }

    constexpr _Tp*
    operator->()
    { return std::__addressof(this->_M_get()); }

    constexpr const _Tp&
    operator*() const&
    { return this->_M_get(); }

    constexpr _Tp&
    operator*()&
    { return this->_M_get(); }

    constexpr _Tp&&
    operator*()&&
    { return std::move(this->_M_get()); }

    constexpr const _Tp&&
    operator*() const&&
    { return std::move(this->_M_get()); }

    constexpr explicit operator bool() const noexcept
    { return this->_M_is_engaged(); }

    constexpr bool has_value() const noexcept
    { return this->_M_is_engaged(); }

    constexpr const _Tp&
    value() const&
    {
return this->_M_is_engaged()
 ? this->_M_get()
 : (__throw_bad_optional_access(), this->_M_get());
    }

    constexpr _Tp&
    value()&
    {
return this->_M_is_engaged()
 ? this->_M_get()
 : (__throw_bad_optional_access(), this->_M_get());
    }

    constexpr _Tp&&
    value()&&
    {
return this->_M_is_engaged()
 ? std::move(this->_M_get())
 : (__throw_bad_optional_access(), std::move(this->_M_get()));
    }

    constexpr const _Tp&&
    value() const&&
    {
return this->_M_is_engaged()
 ? std::move(this->_M_get())
 : (__throw_bad_optional_access(), std::move(this->_M_get()));
    }

    template<typename _Up>
constexpr _Tp
value_or(_Up&& __u) const&
{
 static_assert(is_copy_constructible_v<_Tp>);
 static_assert(is_convertible_v<_Up&&, _Tp>);

 return this->_M_is_engaged()
   ? this->_M_get() : static_cast<_Tp>(std::forward<_Up>(__u));
}

    template<typename _Up>
constexpr _Tp
value_or(_Up&& __u) &&
{
 static_assert(is_move_constructible_v<_Tp>);
 static_assert(is_convertible_v<_Up&&, _Tp>);

 return this->_M_is_engaged()
   ? std::move(this->_M_get())
   : static_cast<_Tp>(std::forward<_Up>(__u));
}

    void reset() noexcept { this->_M_reset(); }
  };

template<typename _Tp>
  using __optional_relop_t =
    enable_if_t<is_convertible<_Tp, bool>::value, bool>;

template<typename _Tp, typename _Up>
  using __optional_eq_t = __optional_relop_t<
    decltype(std::declval<const _Tp&>() == std::declval<const _Up&>())
    >;

template<typename _Tp, typename _Up>
  using __optional_ne_t = __optional_relop_t<
    decltype(std::declval<const _Tp&>() != std::declval<const _Up&>())
    >;

template<typename _Tp, typename _Up>
  using __optional_lt_t = __optional_relop_t<
    decltype(std::declval<const _Tp&>() < std::declval<const _Up&>())
    >;

template<typename _Tp, typename _Up>
  using __optional_gt_t = __optional_relop_t<
    decltype(std::declval<const _Tp&>() > std::declval<const _Up&>())
    >;

template<typename _Tp, typename _Up>
  using __optional_le_t = __optional_relop_t<
    decltype(std::declval<const _Tp&>() <= std::declval<const _Up&>())
    >;

template<typename _Tp, typename _Up>
  using __optional_ge_t = __optional_relop_t<
    decltype(std::declval<const _Tp&>() >= std::declval<const _Up&>())
    >;

// Comparisons between optional values.
template<typename _Tp, typename _Up>
  constexpr auto
  operator==(const optional<_Tp>& __lhs, const optional<_Up>& __rhs)
  -> __optional_eq_t<_Tp, _Up>
  {
    return static_cast<bool>(__lhs) == static_cast<bool>(__rhs)
    && (!__lhs || *__lhs == *__rhs);
  }

template<typename _Tp, typename _Up>
  constexpr auto
  operator!=(const optional<_Tp>& __lhs, const optional<_Up>& __rhs)
  -> __optional_ne_t<_Tp, _Up>
  {
    return static_cast<bool>(__lhs) != static_cast<bool>(__rhs)
|| (static_cast<bool>(__lhs) && *__lhs != *__rhs);
  }

template<typename _Tp, typename _Up>
  constexpr auto
  operator<(const optional<_Tp>& __lhs, const optional<_Up>& __rhs)
  -> __optional_lt_t<_Tp, _Up>
  {
    return static_cast<bool>(__rhs) && (!__lhs || *__lhs < *__rhs);
  }

template<typename _Tp, typename _Up>
  constexpr auto
  operator>(const optional<_Tp>& __lhs, const optional<_Up>& __rhs)
  -> __optional_gt_t<_Tp, _Up>
  {
    return static_cast<bool>(__lhs) && (!__rhs || *__lhs > *__rhs);
  }

template<typename _Tp, typename _Up>
  constexpr auto
  operator<=(const optional<_Tp>& __lhs, const optional<_Up>& __rhs)
  -> __optional_le_t<_Tp, _Up>
  {
    return !__lhs || (static_cast<bool>(__rhs) && *__lhs <= *__rhs);
  }

template<typename _Tp, typename _Up>
  constexpr auto
  operator>=(const optional<_Tp>& __lhs, const optional<_Up>& __rhs)
  -> __optional_ge_t<_Tp, _Up>
  {
    return !__rhs || (static_cast<bool>(__lhs) && *__lhs >= *__rhs);
  }

1063#ifdef __cpp_lib_three_way_comparison
template<typename _Tp, three_way_comparable_with<_Tp> _Up>
  constexpr compare_three_way_result_t<_Tp, _Up>
  operator<=>(const optional<_Tp>& __x, const optional<_Up>& __y)
  {
    return __x && __y ? *__x <=> *__y : bool(__x) <=> bool(__y);
  }
1070#endif

// Comparisons with nullopt.
template<typename _Tp>
  constexpr bool
  operator==(const optional<_Tp>& __lhs, nullopt_t) noexcept
  { return !__lhs; }

1078#ifdef __cpp_lib_three_way_comparison
template<typename _Tp>
  constexpr strong_ordering
  operator<=>(const optional<_Tp>& __x, nullopt_t) noexcept
  { return bool(__x) <=> false; }
1083#else
template<typename _Tp>
  constexpr bool
  operator==(nullopt_t, const optional<_Tp>& __rhs) noexcept
  { return !__rhs; }

template<typename _Tp>
  constexpr bool
  operator!=(const optional<_Tp>& __lhs, nullopt_t) noexcept
  { return static_cast<bool>(__lhs); }

template<typename _Tp>
  constexpr bool
  operator!=(nullopt_t, const optional<_Tp>& __rhs) noexcept
  { return static_cast<bool>(__rhs); }

template<typename _Tp>
  constexpr bool
  operator<(const optional<_Tp>& /* __lhs */, nullopt_t) noexcept
  { return false; }

template<typename _Tp>
  constexpr bool
  operator<(nullopt_t, const optional<_Tp>& __rhs) noexcept
  { return static_cast<bool>(__rhs); }

template<typename _Tp>
  constexpr bool
  operator>(const optional<_Tp>& __lhs, nullopt_t) noexcept
  { return static_cast<bool>(__lhs); }

template<typename _Tp>
  constexpr bool
  operator>(nullopt_t, const optional<_Tp>& /* __rhs */) noexcept
  { return false; }

template<typename _Tp>
  constexpr bool
  operator<=(const optional<_Tp>& __lhs, nullopt_t) noexcept
  { return !__lhs; }

template<typename _Tp>
  constexpr bool
  operator<=(nullopt_t, const optional<_Tp>& /* __rhs */) noexcept
  { return true; }

template<typename _Tp>
  constexpr bool
  operator>=(const optional<_Tp>& /* __lhs */, nullopt_t) noexcept
  { return true; }

template<typename _Tp>
  constexpr bool
  operator>=(nullopt_t, const optional<_Tp>& __rhs) noexcept
  { return !__rhs; }
1138#endif // three-way-comparison

// Comparisons with value type.
template<typename _Tp, typename _Up>
  constexpr auto
  operator==(const optional<_Tp>& __lhs, const _Up& __rhs)
  -> __optional_eq_t<_Tp, _Up>
  { return __lhs && *__lhs == __rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator==(const _Up& __lhs, const optional<_Tp>& __rhs)
  -> __optional_eq_t<_Up, _Tp>
  { return __rhs && __lhs == *__rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator!=(const optional<_Tp>& __lhs, const _Up& __rhs)
  -> __optional_ne_t<_Tp, _Up>
  { return !__lhs || *__lhs != __rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator!=(const _Up& __lhs, const optional<_Tp>& __rhs)
  -> __optional_ne_t<_Up, _Tp>
  { return !__rhs || __lhs != *__rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator<(const optional<_Tp>& __lhs, const _Up& __rhs)
  -> __optional_lt_t<_Tp, _Up>
  { return !__lhs || *__lhs < __rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator<(const _Up& __lhs, const optional<_Tp>& __rhs)
  -> __optional_lt_t<_Up, _Tp>
  { return __rhs && __lhs < *__rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator>(const optional<_Tp>& __lhs, const _Up& __rhs)
  -> __optional_gt_t<_Tp, _Up>
  { return __lhs && *__lhs > __rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator>(const _Up& __lhs, const optional<_Tp>& __rhs)
  -> __optional_gt_t<_Up, _Tp>
  { return !__rhs || __lhs > *__rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator<=(const optional<_Tp>& __lhs, const _Up& __rhs)
  -> __optional_le_t<_Tp, _Up>
  { return !__lhs || *__lhs <= __rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator<=(const _Up& __lhs, const optional<_Tp>& __rhs)
  -> __optional_le_t<_Up, _Tp>
  { return __rhs && __lhs <= *__rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator>=(const optional<_Tp>& __lhs, const _Up& __rhs)
  -> __optional_ge_t<_Tp, _Up>
  { return __lhs && *__lhs >= __rhs; }

template<typename _Tp, typename _Up>
  constexpr auto
  operator>=(const _Up& __lhs, const optional<_Tp>& __rhs)
  -> __optional_ge_t<_Up, _Tp>
  { return !__rhs || __lhs >= *__rhs; }

1213#ifdef __cpp_lib_three_way_comparison
template<typename _Tp, typename _Up>
  constexpr compare_three_way_result_t<_Tp, _Up>
  operator<=>(const optional<_Tp>& __x, const _Up& __v)
  { return bool(__x) ? *__x <=> __v : strong_ordering::less; }
1218#endif

// Swap and creation functions.

// _GLIBCXX_RESOLVE_LIB_DEFECTS
// 2748. swappable traits for optionals
template<typename _Tp>
  inline enable_if_t<is_move_constructible_v<_Tp> && is_swappable_v<_Tp>>
  swap(optional<_Tp>& __lhs, optional<_Tp>& __rhs)
  noexcept(noexcept(__lhs.swap(__rhs)))
  { __lhs.swap(__rhs); }

template<typename _Tp>
  enable_if_t<!(is_move_constructible_v<_Tp> && is_swappable_v<_Tp>)>
  swap(optional<_Tp>&, optional<_Tp>&) = delete;

template<typename _Tp>
  constexpr optional<decay_t<_Tp>>
  make_optional(_Tp&& __t)
  { return optional<decay_t<_Tp>> { std::forward<_Tp>(__t) }; }

template<typename _Tp, typename ..._Args>
  constexpr optional<_Tp>
  make_optional(_Args&&... __args)
  { return optional<_Tp> { in_place, std::forward<_Args>(__args)... }; }

template<typename _Tp, typename _Up, typename ..._Args>
  constexpr optional<_Tp>
  make_optional(initializer_list<_Up> __il, _Args&&... __args)
  { return optional<_Tp> { in_place, __il, std::forward<_Args>(__args)... }; }

// Hash.

template<typename _Tp, typename _Up = remove_const_t<_Tp>,
         bool = __poison_hash<_Up>::__enable_hash_call>
  struct __optional_hash_call_base
  {
    size_t
    operator()(const optional<_Tp>& __t) const
    noexcept(noexcept(hash<_Up>{}(*__t)))
    {
      // We pick an arbitrary hash for disengaged optionals which hopefully
      // usual values of _Tp won't typically hash to.
      constexpr size_t __magic_disengaged_hash = static_cast<size_t>(-3333);
      return __t ? hash<_Up>{}(*__t) : __magic_disengaged_hash;
    }
  };

template<typename _Tp, typename _Up>
  struct __optional_hash_call_base<_Tp, _Up, false> {};

template<typename _Tp>
  struct hash<optional<_Tp>>
  : private __poison_hash<remove_const_t<_Tp>>,
    public __optional_hash_call_base<_Tp>
  {
    using result_type [[__deprecated__]] = size_t;
    using argument_type [[__deprecated__]] = optional<_Tp>;
  };

template<typename _Tp>
  struct __is_fast_hash<hash<optional<_Tp>>> : __is_fast_hash<hash<_Tp>>
  { };

/// @}

1284#if __cpp_deduction_guides201703L >= 201606
template <typename _Tp> optional(_Tp) -> optional<_Tp>;
1286#endif

1288_GLIBCXX_END_NAMESPACE_VERSION
1289} // namespace std

1291#endif // C++17

1293#endif // _GLIBCXX_OPTIONAL

←

/build/source/clang/include/clang/Sema/DeclSpec.h

→

1	//===--- DeclSpec.h - Parsed declaration specifiers -------------- 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	/// \file
10	/// This file defines the classes used to store parsed information about
11	/// declaration-specifiers and declarators.
12	///
13	/// \verbatim
14	/// static const int volatile x, y, ((z)[10])(const void *x);
15	/// ------------------------- - -- ---------------------------
16	/// declaration-specifiers \ \| /
17	/// declarators
18	/// \endverbatim
19	///
20	//===----------------------------------------------------------------------===//
21
22	#ifndef LLVM_CLANG_SEMA_DECLSPEC_H
23	#define LLVM_CLANG_SEMA_DECLSPEC_H
24
25	#include "clang/AST/DeclCXX.h"
26	#include "clang/AST/DeclObjCCommon.h"
27	#include "clang/AST/NestedNameSpecifier.h"
28	#include "clang/Basic/ExceptionSpecificationType.h"
29	#include "clang/Basic/Lambda.h"
30	#include "clang/Basic/OperatorKinds.h"
31	#include "clang/Basic/Specifiers.h"
32	#include "clang/Lex/Token.h"
33	#include "clang/Sema/Ownership.h"
34	#include "clang/Sema/ParsedAttr.h"
35	#include "llvm/ADT/STLExtras.h"
36	#include "llvm/ADT/SmallVector.h"
37	#include "llvm/Support/Compiler.h"
38	#include "llvm/Support/ErrorHandling.h"
39
40	namespace clang {
41	class ASTContext;
42	class CXXRecordDecl;
43	class TypeLoc;
44	class LangOptions;
45	class IdentifierInfo;
46	class NamespaceAliasDecl;
47	class NamespaceDecl;
48	class ObjCDeclSpec;
49	class Sema;
50	class Declarator;
51	struct TemplateIdAnnotation;
52
53	/// Represents a C++ nested-name-specifier or a global scope specifier.
54	///
55	/// These can be in 3 states:
56	/// 1) Not present, identified by isEmpty()
57	/// 2) Present, identified by isNotEmpty()
58	/// 2.a) Valid, identified by isValid()
59	/// 2.b) Invalid, identified by isInvalid().
60	///
61	/// isSet() is deprecated because it mostly corresponded to "valid" but was
62	/// often used as if it meant "present".
63	///
64	/// The actual scope is described by getScopeRep().
65	///
66	/// If the kind of getScopeRep() is TypeSpec then TemplateParamLists may be empty
67	/// or contain the template parameter lists attached to the current declaration.
68	/// Consider the following example:
69	/// template <class T> void SomeType<T>::some_method() {}
70	/// If CXXScopeSpec refers to SomeType<T> then TemplateParamLists will contain
71	/// a single element referring to template <class T>.
72
73	class CXXScopeSpec {
74	SourceRange Range;
75	NestedNameSpecifierLocBuilder Builder;
76	ArrayRef<TemplateParameterList *> TemplateParamLists;
77
78	public:
79	SourceRange getRange() const { return Range; }
80	void setRange(SourceRange R) { Range = R; }
81	void setBeginLoc(SourceLocation Loc) { Range.setBegin(Loc); }
82	void setEndLoc(SourceLocation Loc) { Range.setEnd(Loc); }
83	SourceLocation getBeginLoc() const { return Range.getBegin(); }
84	SourceLocation getEndLoc() const { return Range.getEnd(); }
85
86	void setTemplateParamLists(ArrayRef<TemplateParameterList *> L) {
87	TemplateParamLists = L;
88	}
89	ArrayRef<TemplateParameterList *> getTemplateParamLists() const {
90	return TemplateParamLists;
91	}
92
93	/// Retrieve the representation of the nested-name-specifier.
94	NestedNameSpecifier *getScopeRep() const {
95	return Builder.getRepresentation();
96	}
97
98	/// Extend the current nested-name-specifier by another
99	/// nested-name-specifier component of the form 'type::'.
100	///
101	/// \param Context The AST context in which this nested-name-specifier
102	/// resides.
103	///
104	/// \param TemplateKWLoc The location of the 'template' keyword, if present.
105	///
106	/// \param TL The TypeLoc that describes the type preceding the '::'.
107	///
108	/// \param ColonColonLoc The location of the trailing '::'.
109	void Extend(ASTContext &Context, SourceLocation TemplateKWLoc, TypeLoc TL,
110	SourceLocation ColonColonLoc);
111
112	/// Extend the current nested-name-specifier by another
113	/// nested-name-specifier component of the form 'identifier::'.
114	///
115	/// \param Context The AST context in which this nested-name-specifier
116	/// resides.
117	///
118	/// \param Identifier The identifier.
119	///
120	/// \param IdentifierLoc The location of the identifier.
121	///
122	/// \param ColonColonLoc The location of the trailing '::'.
123	void Extend(ASTContext &Context, IdentifierInfo *Identifier,
124	SourceLocation IdentifierLoc, SourceLocation ColonColonLoc);
125
126	/// Extend the current nested-name-specifier by another
127	/// nested-name-specifier component of the form 'namespace::'.
128	///
129	/// \param Context The AST context in which this nested-name-specifier
130	/// resides.
131	///
132	/// \param Namespace The namespace.
133	///
134	/// \param NamespaceLoc The location of the namespace name.
135	///
136	/// \param ColonColonLoc The location of the trailing '::'.
137	void Extend(ASTContext &Context, NamespaceDecl *Namespace,
138	SourceLocation NamespaceLoc, SourceLocation ColonColonLoc);
139
140	/// Extend the current nested-name-specifier by another
141	/// nested-name-specifier component of the form 'namespace-alias::'.
142	///
143	/// \param Context The AST context in which this nested-name-specifier
144	/// resides.
145	///
146	/// \param Alias The namespace alias.
147	///
148	/// \param AliasLoc The location of the namespace alias
149	/// name.
150	///
151	/// \param ColonColonLoc The location of the trailing '::'.
152	void Extend(ASTContext &Context, NamespaceAliasDecl *Alias,
153	SourceLocation AliasLoc, SourceLocation ColonColonLoc);
154
155	/// Turn this (empty) nested-name-specifier into the global
156	/// nested-name-specifier '::'.
157	void MakeGlobal(ASTContext &Context, SourceLocation ColonColonLoc);
158
159	/// Turns this (empty) nested-name-specifier into '__super'
160	/// nested-name-specifier.
161	///
162	/// \param Context The AST context in which this nested-name-specifier
163	/// resides.
164	///
165	/// \param RD The declaration of the class in which nested-name-specifier
166	/// appeared.
167	///
168	/// \param SuperLoc The location of the '__super' keyword.
169	/// name.
170	///
171	/// \param ColonColonLoc The location of the trailing '::'.
172	void MakeSuper(ASTContext &Context, CXXRecordDecl *RD,
173	SourceLocation SuperLoc, SourceLocation ColonColonLoc);
174
175	/// Make a new nested-name-specifier from incomplete source-location
176	/// information.
177	///
178	/// FIXME: This routine should be used very, very rarely, in cases where we
179	/// need to synthesize a nested-name-specifier. Most code should instead use
180	/// \c Adopt() with a proper \c NestedNameSpecifierLoc.
181	void MakeTrivial(ASTContext &Context, NestedNameSpecifier *Qualifier,
182	SourceRange R);
183
184	/// Adopt an existing nested-name-specifier (with source-range
185	/// information).
186	void Adopt(NestedNameSpecifierLoc Other);
187
188	/// Retrieve a nested-name-specifier with location information, copied
189	/// into the given AST context.
190	///
191	/// \param Context The context into which this nested-name-specifier will be
192	/// copied.
193	NestedNameSpecifierLoc getWithLocInContext(ASTContext &Context) const;
194
195	/// Retrieve the location of the name in the last qualifier
196	/// in this nested name specifier.
197	///
198	/// For example, the location of \c bar
199	/// in
200	/// \verbatim
201	/// \::foo::bar<0>::
202	/// ^~~
203	/// \endverbatim
204	SourceLocation getLastQualifierNameLoc() const;
205
206	/// No scope specifier.
207	bool isEmpty() const { return Range.isInvalid() && getScopeRep() == nullptr; }
208	/// A scope specifier is present, but may be valid or invalid.
209	bool isNotEmpty() const { return !isEmpty(); }
210
211	/// An error occurred during parsing of the scope specifier.
212	bool isInvalid() const { return Range.isValid() && getScopeRep() == nullptr; }
213	/// A scope specifier is present, and it refers to a real scope.
214	bool isValid() const { return getScopeRep() != nullptr; }
215
216	/// Indicate that this nested-name-specifier is invalid.
217	void SetInvalid(SourceRange R) {
218	assert(R.isValid() && "Must have a valid source range")(static_cast <bool> (R.isValid() && "Must have a valid source range" ) ? void (0) : __assert_fail ("R.isValid() && \"Must have a valid source range\"" , "clang/include/clang/Sema/DeclSpec.h", 218, __extension__ __PRETTY_FUNCTION__ ));
219	if (Range.getBegin().isInvalid())
220	Range.setBegin(R.getBegin());
221	Range.setEnd(R.getEnd());
222	Builder.Clear();
223	}
224
225	/// Deprecated. Some call sites intend isNotEmpty() while others intend
226	/// isValid().
227	bool isSet() const { return getScopeRep() != nullptr; }
228
229	void clear() {
230	Range = SourceRange();
231	Builder.Clear();
232	}
233
234	/// Retrieve the data associated with the source-location information.
235	char *location_data() const { return Builder.getBuffer().first; }
236
237	/// Retrieve the size of the data associated with source-location
238	/// information.
239	unsigned location_size() const { return Builder.getBuffer().second; }
240	};
241
242	/// Captures information about "declaration specifiers".
243	///
244	/// "Declaration specifiers" encompasses storage-class-specifiers,
245	/// type-specifiers, type-qualifiers, and function-specifiers.
246	class DeclSpec {
247	public:
248	/// storage-class-specifier
249	/// \note The order of these enumerators is important for diagnostics.
250	enum SCS {
251	SCS_unspecified = 0,
252	SCS_typedef,
253	SCS_extern,
254	SCS_static,
255	SCS_auto,
256	SCS_register,
257	SCS_private_extern,
258	SCS_mutable
259	};
260
261	// Import thread storage class specifier enumeration and constants.
262	// These can be combined with SCS_extern and SCS_static.
263	typedef ThreadStorageClassSpecifier TSCS;
264	static const TSCS TSCS_unspecified = clang::TSCS_unspecified;
265	static const TSCS TSCS___thread = clang::TSCS___thread;
266	static const TSCS TSCS_thread_local = clang::TSCS_thread_local;
267	static const TSCS TSCS__Thread_local = clang::TSCS__Thread_local;
268
269	enum TSC {
270	TSC_unspecified,
271	TSC_imaginary,
272	TSC_complex
273	};
274
275	// Import type specifier type enumeration and constants.
276	typedef TypeSpecifierType TST;
277	static const TST TST_unspecified = clang::TST_unspecified;
278	static const TST TST_void = clang::TST_void;
279	static const TST TST_char = clang::TST_char;
280	static const TST TST_wchar = clang::TST_wchar;
281	static const TST TST_char8 = clang::TST_char8;
282	static const TST TST_char16 = clang::TST_char16;
283	static const TST TST_char32 = clang::TST_char32;
284	static const TST TST_int = clang::TST_int;
285	static const TST TST_int128 = clang::TST_int128;
286	static const TST TST_bitint = clang::TST_bitint;
287	static const TST TST_half = clang::TST_half;
288	static const TST TST_BFloat16 = clang::TST_BFloat16;
289	static const TST TST_float = clang::TST_float;
290	static const TST TST_double = clang::TST_double;
291	static const TST TST_float16 = clang::TST_Float16;
292	static const TST TST_accum = clang::TST_Accum;
293	static const TST TST_fract = clang::TST_Fract;
294	static const TST TST_float128 = clang::TST_float128;
295	static const TST TST_ibm128 = clang::TST_ibm128;
296	static const TST TST_bool = clang::TST_bool;
297	static const TST TST_decimal32 = clang::TST_decimal32;
298	static const TST TST_decimal64 = clang::TST_decimal64;
299	static const TST TST_decimal128 = clang::TST_decimal128;
300	static const TST TST_enum = clang::TST_enum;
301	static const TST TST_union = clang::TST_union;
302	static const TST TST_struct = clang::TST_struct;
303	static const TST TST_interface = clang::TST_interface;
304	static const TST TST_class = clang::TST_class;
305	static const TST TST_typename = clang::TST_typename;
306	static const TST TST_typeofType = clang::TST_typeofType;
307	static const TST TST_typeofExpr = clang::TST_typeofExpr;
308	static const TST TST_typeof_unqualType = clang::TST_typeof_unqualType;
309	static const TST TST_typeof_unqualExpr = clang::TST_typeof_unqualExpr;
310	static const TST TST_decltype = clang::TST_decltype;
311	static const TST TST_decltype_auto = clang::TST_decltype_auto;
312	#define TRANSFORM_TYPE_TRAIT_DEF(_, Trait) \
313	static const TST TST_##Trait = clang::TST_##Trait;
314	#include "clang/Basic/TransformTypeTraits.def"
315	static const TST TST_auto = clang::TST_auto;
316	static const TST TST_auto_type = clang::TST_auto_type;
317	static const TST TST_unknown_anytype = clang::TST_unknown_anytype;
318	static const TST TST_atomic = clang::TST_atomic;
319	#define GENERIC_IMAGE_TYPE(ImgType, Id) \
320	static const TST TST_##ImgType##_t = clang::TST_##ImgType##_t;
321	#include "clang/Basic/OpenCLImageTypes.def"
322	static const TST TST_error = clang::TST_error;
323
324	// type-qualifiers
325	enum TQ { // NOTE: These flags must be kept in sync with Qualifiers::TQ.
326	TQ_unspecified = 0,
327	TQ_const = 1,
328	TQ_restrict = 2,
329	TQ_volatile = 4,
330	TQ_unaligned = 8,
331	// This has no corresponding Qualifiers::TQ value, because it's not treated
332	// as a qualifier in our type system.
333	TQ_atomic = 16
334	};
335
336	/// ParsedSpecifiers - Flags to query which specifiers were applied. This is
337	/// returned by getParsedSpecifiers.
338	enum ParsedSpecifiers {
339	PQ_None = 0,
340	PQ_StorageClassSpecifier = 1,
341	PQ_TypeSpecifier = 2,
342	PQ_TypeQualifier = 4,
343	PQ_FunctionSpecifier = 8
344	// FIXME: Attributes should be included here.
345	};
346
347	enum FriendSpecified : bool {
348	No,
349	Yes,
350	};
351
352	private:
353	// storage-class-specifier
354	/SCS/unsigned StorageClassSpec : 3;
355	/TSCS/unsigned ThreadStorageClassSpec : 2;
356	unsigned SCS_extern_in_linkage_spec : 1;
357
358	// type-specifier
359	/TypeSpecifierWidth/ unsigned TypeSpecWidth : 2;
360	/TSC/unsigned TypeSpecComplex : 2;
361	/TSS/unsigned TypeSpecSign : 2;
362	/TST/unsigned TypeSpecType : 7;
363	unsigned TypeAltiVecVector : 1;
364	unsigned TypeAltiVecPixel : 1;
365	unsigned TypeAltiVecBool : 1;
366	unsigned TypeSpecOwned : 1;
367	unsigned TypeSpecPipe : 1;
368	unsigned TypeSpecSat : 1;
369	unsigned ConstrainedAuto : 1;
370
371	// type-qualifiers
372	unsigned TypeQualifiers : 5; // Bitwise OR of TQ.
373
374	// function-specifier
375	unsigned FS_inline_specified : 1;
376	unsigned FS_forceinline_specified: 1;
377	unsigned FS_virtual_specified : 1;
378	unsigned FS_noreturn_specified : 1;
379
380	// friend-specifier
381	unsigned Friend_specified : 1;
382
383	// constexpr-specifier
384	unsigned ConstexprSpecifier : 2;
385
386	union {
387	UnionParsedType TypeRep;
388	Decl *DeclRep;
389	Expr *ExprRep;
390	TemplateIdAnnotation *TemplateIdRep;
391	};
392
393	/// ExplicitSpecifier - Store information about explicit spicifer.
394	ExplicitSpecifier FS_explicit_specifier;
395
396	// attributes.
397	ParsedAttributes Attrs;
398
399	// Scope specifier for the type spec, if applicable.
400	CXXScopeSpec TypeScope;
401
402	// SourceLocation info. These are null if the item wasn't specified or if
403	// the setting was synthesized.
404	SourceRange Range;
405
406	SourceLocation StorageClassSpecLoc, ThreadStorageClassSpecLoc;
407	SourceRange TSWRange;
408	SourceLocation TSCLoc, TSSLoc, TSTLoc, AltiVecLoc, TSSatLoc;
409	/// TSTNameLoc - If TypeSpecType is any of class, enum, struct, union,
410	/// typename, then this is the location of the named type (if present);
411	/// otherwise, it is the same as TSTLoc. Hence, the pair TSTLoc and
412	/// TSTNameLoc provides source range info for tag types.
413	SourceLocation TSTNameLoc;
414	SourceRange TypeofParensRange;
415	SourceLocation TQ_constLoc, TQ_restrictLoc, TQ_volatileLoc, TQ_atomicLoc,
416	TQ_unalignedLoc;
417	SourceLocation FS_inlineLoc, FS_virtualLoc, FS_explicitLoc, FS_noreturnLoc;
418	SourceLocation FS_explicitCloseParenLoc;
419	SourceLocation FS_forceinlineLoc;
420	SourceLocation FriendLoc, ModulePrivateLoc, ConstexprLoc;
421	SourceLocation TQ_pipeLoc;
422
423	WrittenBuiltinSpecs writtenBS;
424	void SaveWrittenBuiltinSpecs();
425
426	ObjCDeclSpec *ObjCQualifiers;
427
428	static bool isTypeRep(TST T) {
429	return T == TST_atomic \|\| T == TST_typename \|\| T == TST_typeofType \|\|
430	T == TST_typeof_unqualType \|\| isTransformTypeTrait(T);
431	}
432	static bool isExprRep(TST T) {
433	return T == TST_typeofExpr \|\| T == TST_typeof_unqualExpr \|\|
434	T == TST_decltype \|\| T == TST_bitint;
435	}
436	static bool isTemplateIdRep(TST T) {
437	return (T == TST_auto \|\| T == TST_decltype_auto);
438	}
439
440	DeclSpec(const DeclSpec &) = delete;
441	void operator=(const DeclSpec &) = delete;
442	public:
443	static bool isDeclRep(TST T) {
444	return (T == TST_enum \|\| T == TST_struct \|\|
445	T == TST_interface \|\| T == TST_union \|\|
446	T == TST_class);
447	}
448	static bool isTransformTypeTrait(TST T) {
449	constexpr std::array<TST, 16> Traits = {
450	#define TRANSFORM_TYPE_TRAIT_DEF(_, Trait) TST_##Trait,
451	#include "clang/Basic/TransformTypeTraits.def"
452	};
453
454	return T >= Traits.front() && T <= Traits.back();
455	}
456
457	DeclSpec(AttributeFactory &attrFactory)
458	: StorageClassSpec(SCS_unspecified),
459	ThreadStorageClassSpec(TSCS_unspecified),
460	SCS_extern_in_linkage_spec(false),
461	TypeSpecWidth(static_cast<unsigned>(TypeSpecifierWidth::Unspecified)),
462	TypeSpecComplex(TSC_unspecified),
463	TypeSpecSign(static_cast<unsigned>(TypeSpecifierSign::Unspecified)),
464	TypeSpecType(TST_unspecified), TypeAltiVecVector(false),
465	TypeAltiVecPixel(false), TypeAltiVecBool(false), TypeSpecOwned(false),
466	TypeSpecPipe(false), TypeSpecSat(false), ConstrainedAuto(false),
467	TypeQualifiers(TQ_unspecified), FS_inline_specified(false),
468	FS_forceinline_specified(false), FS_virtual_specified(false),
469	FS_noreturn_specified(false), Friend_specified(false),
470	ConstexprSpecifier(
471	static_cast<unsigned>(ConstexprSpecKind::Unspecified)),
472	Attrs(attrFactory), writtenBS(), ObjCQualifiers(nullptr) {}
473
474	// storage-class-specifier
475	SCS getStorageClassSpec() const { return (SCS)StorageClassSpec; }
476	TSCS getThreadStorageClassSpec() const {
477	return (TSCS)ThreadStorageClassSpec;
478	}
479	bool isExternInLinkageSpec() const { return SCS_extern_in_linkage_spec; }
480	void setExternInLinkageSpec(bool Value) {
481	SCS_extern_in_linkage_spec = Value;
482	}
483
484	SourceLocation getStorageClassSpecLoc() const { return StorageClassSpecLoc; }
485	SourceLocation getThreadStorageClassSpecLoc() const {
486	return ThreadStorageClassSpecLoc;
487	}
488
489	void ClearStorageClassSpecs() {
490	StorageClassSpec = DeclSpec::SCS_unspecified;
491	ThreadStorageClassSpec = DeclSpec::TSCS_unspecified;
492	SCS_extern_in_linkage_spec = false;
493	StorageClassSpecLoc = SourceLocation();
494	ThreadStorageClassSpecLoc = SourceLocation();
495	}
496
497	void ClearTypeSpecType() {
498	TypeSpecType = DeclSpec::TST_unspecified;
499	TypeSpecOwned = false;
500	TSTLoc = SourceLocation();
501	}
502
503	// type-specifier
504	TypeSpecifierWidth getTypeSpecWidth() const {
505	return static_cast<TypeSpecifierWidth>(TypeSpecWidth);
506	}
507	TSC getTypeSpecComplex() const { return (TSC)TypeSpecComplex; }
508	TypeSpecifierSign getTypeSpecSign() const {
509	return static_cast<TypeSpecifierSign>(TypeSpecSign);
510	}
511	TST getTypeSpecType() const { return (TST)TypeSpecType; }
512	bool isTypeAltiVecVector() const { return TypeAltiVecVector; }
513	bool isTypeAltiVecPixel() const { return TypeAltiVecPixel; }
514	bool isTypeAltiVecBool() const { return TypeAltiVecBool; }
515	bool isTypeSpecOwned() const { return TypeSpecOwned; }
516	bool isTypeRep() const { return isTypeRep((TST) TypeSpecType); }
517	bool isTypeSpecPipe() const { return TypeSpecPipe; }
518	bool isTypeSpecSat() const { return TypeSpecSat; }
519	bool isConstrainedAuto() const { return ConstrainedAuto; }
520
521	ParsedType getRepAsType() const {
522	assert(isTypeRep((TST) TypeSpecType) && "DeclSpec does not store a type")(static_cast <bool> (isTypeRep((TST) TypeSpecType) && "DeclSpec does not store a type") ? void (0) : __assert_fail ("isTypeRep((TST) TypeSpecType) && \"DeclSpec does not store a type\"" , "clang/include/clang/Sema/DeclSpec.h", 522, __extension__ __PRETTY_FUNCTION__ ));
523	return TypeRep;
524	}
525	Decl *getRepAsDecl() const {
526	assert(isDeclRep((TST) TypeSpecType) && "DeclSpec does not store a decl")(static_cast <bool> (isDeclRep((TST) TypeSpecType) && "DeclSpec does not store a decl") ? void (0) : __assert_fail ("isDeclRep((TST) TypeSpecType) && \"DeclSpec does not store a decl\"" , "clang/include/clang/Sema/DeclSpec.h", 526, __extension__ __PRETTY_FUNCTION__ ));
527	return DeclRep;
528	}
529	Expr *getRepAsExpr() const {
530	assert(isExprRep((TST) TypeSpecType) && "DeclSpec does not store an expr")(static_cast <bool> (isExprRep((TST) TypeSpecType) && "DeclSpec does not store an expr") ? void (0) : __assert_fail ("isExprRep((TST) TypeSpecType) && \"DeclSpec does not store an expr\"" , "clang/include/clang/Sema/DeclSpec.h", 530, __extension__ __PRETTY_FUNCTION__ ));
531	return ExprRep;
532	}
533	TemplateIdAnnotation *getRepAsTemplateId() const {
534	assert(isTemplateIdRep((TST) TypeSpecType) &&(static_cast <bool> (isTemplateIdRep((TST) TypeSpecType ) && "DeclSpec does not store a template id") ? void ( 0) : __assert_fail ("isTemplateIdRep((TST) TypeSpecType) && \"DeclSpec does not store a template id\"" , "clang/include/clang/Sema/DeclSpec.h", 535, __extension__ __PRETTY_FUNCTION__ ))
535	"DeclSpec does not store a template id")(static_cast <bool> (isTemplateIdRep((TST) TypeSpecType ) && "DeclSpec does not store a template id") ? void ( 0) : __assert_fail ("isTemplateIdRep((TST) TypeSpecType) && \"DeclSpec does not store a template id\"" , "clang/include/clang/Sema/DeclSpec.h", 535, __extension__ __PRETTY_FUNCTION__ ));
536	return TemplateIdRep;
537	}
538	CXXScopeSpec &getTypeSpecScope() { return TypeScope; }
539	const CXXScopeSpec &getTypeSpecScope() const { return TypeScope; }
540
541	SourceRange getSourceRange() const LLVM_READONLY__attribute__((__pure__)) { return Range; }
542	SourceLocation getBeginLoc() const LLVM_READONLY__attribute__((__pure__)) { return Range.getBegin(); }
543	SourceLocation getEndLoc() const LLVM_READONLY__attribute__((__pure__)) { return Range.getEnd(); }
544
545	SourceLocation getTypeSpecWidthLoc() const { return TSWRange.getBegin(); }
546	SourceRange getTypeSpecWidthRange() const { return TSWRange; }
547	SourceLocation getTypeSpecComplexLoc() const { return TSCLoc; }
548	SourceLocation getTypeSpecSignLoc() const { return TSSLoc; }
549	SourceLocation getTypeSpecTypeLoc() const { return TSTLoc; }
550	SourceLocation getAltiVecLoc() const { return AltiVecLoc; }
551	SourceLocation getTypeSpecSatLoc() const { return TSSatLoc; }
552
553	SourceLocation getTypeSpecTypeNameLoc() const {
554	assert(isDeclRep((TST)TypeSpecType) \|\| isTypeRep((TST)TypeSpecType) \|\|(static_cast <bool> (isDeclRep((TST)TypeSpecType) \|\| isTypeRep ((TST)TypeSpecType) \|\| isExprRep((TST)TypeSpecType)) ? void ( 0) : __assert_fail ("isDeclRep((TST)TypeSpecType) \|\| isTypeRep((TST)TypeSpecType) \|\| isExprRep((TST)TypeSpecType)" , "clang/include/clang/Sema/DeclSpec.h", 555, __extension__ __PRETTY_FUNCTION__ ))
555	isExprRep((TST)TypeSpecType))(static_cast <bool> (isDeclRep((TST)TypeSpecType) \|\| isTypeRep ((TST)TypeSpecType) \|\| isExprRep((TST)TypeSpecType)) ? void ( 0) : __assert_fail ("isDeclRep((TST)TypeSpecType) \|\| isTypeRep((TST)TypeSpecType) \|\| isExprRep((TST)TypeSpecType)" , "clang/include/clang/Sema/DeclSpec.h", 555, __extension__ __PRETTY_FUNCTION__ ));
556	return TSTNameLoc;
557	}
558
559	SourceRange getTypeofParensRange() const { return TypeofParensRange; }
560	void setTypeArgumentRange(SourceRange range) { TypeofParensRange = range; }
561
562	bool hasAutoTypeSpec() const {
563	return (TypeSpecType == TST_auto \|\| TypeSpecType == TST_auto_type \|\|
564	TypeSpecType == TST_decltype_auto);
565	}
566
567	bool hasTagDefinition() const;
568
569	/// Turn a type-specifier-type into a string like "_Bool" or "union".
570	static const char *getSpecifierName(DeclSpec::TST T,
571	const PrintingPolicy &Policy);
572	static const char *getSpecifierName(DeclSpec::TQ Q);
573	static const char *getSpecifierName(TypeSpecifierSign S);
574	static const char *getSpecifierName(DeclSpec::TSC C);
575	static const char *getSpecifierName(TypeSpecifierWidth W);
576	static const char *getSpecifierName(DeclSpec::SCS S);
577	static const char *getSpecifierName(DeclSpec::TSCS S);
578	static const char *getSpecifierName(ConstexprSpecKind C);
579
580	// type-qualifiers
581
582	/// getTypeQualifiers - Return a set of TQs.
583	unsigned getTypeQualifiers() const { return TypeQualifiers; }
584	SourceLocation getConstSpecLoc() const { return TQ_constLoc; }
585	SourceLocation getRestrictSpecLoc() const { return TQ_restrictLoc; }
586	SourceLocation getVolatileSpecLoc() const { return TQ_volatileLoc; }
587	SourceLocation getAtomicSpecLoc() const { return TQ_atomicLoc; }
588	SourceLocation getUnalignedSpecLoc() const { return TQ_unalignedLoc; }
589	SourceLocation getPipeLoc() const { return TQ_pipeLoc; }
590
591	/// Clear out all of the type qualifiers.
592	void ClearTypeQualifiers() {
593	TypeQualifiers = 0;
594	TQ_constLoc = SourceLocation();
595	TQ_restrictLoc = SourceLocation();
596	TQ_volatileLoc = SourceLocation();
597	TQ_atomicLoc = SourceLocation();
598	TQ_unalignedLoc = SourceLocation();
599	TQ_pipeLoc = SourceLocation();
600	}
601
602	// function-specifier
603	bool isInlineSpecified() const {
604	return FS_inline_specified \| FS_forceinline_specified;
605	}
606	SourceLocation getInlineSpecLoc() const {
607	return FS_inline_specified ? FS_inlineLoc : FS_forceinlineLoc;
608	}
609
610	ExplicitSpecifier getExplicitSpecifier() const {
611	return FS_explicit_specifier;
612	}
613
614	bool isVirtualSpecified() const { return FS_virtual_specified; }
615	SourceLocation getVirtualSpecLoc() const { return FS_virtualLoc; }
616
617	bool hasExplicitSpecifier() const {
618	return FS_explicit_specifier.isSpecified();
619	}
620	SourceLocation getExplicitSpecLoc() const { return FS_explicitLoc; }
621	SourceRange getExplicitSpecRange() const {
622	return FS_explicit_specifier.getExpr()
623	? SourceRange(FS_explicitLoc, FS_explicitCloseParenLoc)
624	: SourceRange(FS_explicitLoc);
625	}
626
627	bool isNoreturnSpecified() const { return FS_noreturn_specified; }
628	SourceLocation getNoreturnSpecLoc() const { return FS_noreturnLoc; }
629
630	void ClearFunctionSpecs() {
631	FS_inline_specified = false;
632	FS_inlineLoc = SourceLocation();
633	FS_forceinline_specified = false;
634	FS_forceinlineLoc = SourceLocation();
635	FS_virtual_specified = false;
636	FS_virtualLoc = SourceLocation();
637	FS_explicit_specifier = ExplicitSpecifier();
638	FS_explicitLoc = SourceLocation();
639	FS_explicitCloseParenLoc = SourceLocation();
640	FS_noreturn_specified = false;
641	FS_noreturnLoc = SourceLocation();
642	}
643
644	/// This method calls the passed in handler on each CVRU qual being
645	/// set.
646	/// Handle - a handler to be invoked.
647	void forEachCVRUQualifier(
648	llvm::function_ref<void(TQ, StringRef, SourceLocation)> Handle);
649
650	/// This method calls the passed in handler on each qual being
651	/// set.
652	/// Handle - a handler to be invoked.
653	void forEachQualifier(
654	llvm::function_ref<void(TQ, StringRef, SourceLocation)> Handle);
655
656	/// Return true if any type-specifier has been found.
657	bool hasTypeSpecifier() const {
658	return getTypeSpecType() != DeclSpec::TST_unspecified \|\|
659	getTypeSpecWidth() != TypeSpecifierWidth::Unspecified \|\|
660	getTypeSpecComplex() != DeclSpec::TSC_unspecified \|\|
661	getTypeSpecSign() != TypeSpecifierSign::Unspecified;
662	}
663
664	/// Return a bitmask of which flavors of specifiers this
665	/// DeclSpec includes.
666	unsigned getParsedSpecifiers() const;
667
668	/// isEmpty - Return true if this declaration specifier is completely empty:
669	/// no tokens were parsed in the production of it.
670	bool isEmpty() const {
671	return getParsedSpecifiers() == DeclSpec::PQ_None;
672	}
673
674	void SetRangeStart(SourceLocation Loc) { Range.setBegin(Loc); }
675	void SetRangeEnd(SourceLocation Loc) { Range.setEnd(Loc); }
676
677	/// These methods set the specified attribute of the DeclSpec and
678	/// return false if there was no error. If an error occurs (for
679	/// example, if we tried to set "auto" on a spec with "extern"
680	/// already set), they return true and set PrevSpec and DiagID
681	/// such that
682	/// Diag(Loc, DiagID) << PrevSpec;
683	/// will yield a useful result.
684	///
685	/// TODO: use a more general approach that still allows these
686	/// diagnostics to be ignored when desired.
687	bool SetStorageClassSpec(Sema &S, SCS SC, SourceLocation Loc,
688	const char *&PrevSpec, unsigned &DiagID,
689	const PrintingPolicy &Policy);
690	bool SetStorageClassSpecThread(TSCS TSC, SourceLocation Loc,
691	const char *&PrevSpec, unsigned &DiagID);
692	bool SetTypeSpecWidth(TypeSpecifierWidth W, SourceLocation Loc,
693	const char *&PrevSpec, unsigned &DiagID,
694	const PrintingPolicy &Policy);
695	bool SetTypeSpecComplex(TSC C, SourceLocation Loc, const char *&PrevSpec,
696	unsigned &DiagID);
697	bool SetTypeSpecSign(TypeSpecifierSign S, SourceLocation Loc,
698	const char *&PrevSpec, unsigned &DiagID);
699	bool SetTypeSpecType(TST T, SourceLocation Loc, const char *&PrevSpec,
700	unsigned &DiagID, const PrintingPolicy &Policy);
701	bool SetTypeSpecType(TST T, SourceLocation Loc, const char *&PrevSpec,
702	unsigned &DiagID, ParsedType Rep,
703	const PrintingPolicy &Policy);
704	bool SetTypeSpecType(TST T, SourceLocation Loc, const char *&PrevSpec,
705	unsigned &DiagID, TypeResult Rep,
706	const PrintingPolicy &Policy) {
707	if (Rep.isInvalid())
708	return SetTypeSpecError();
709	return SetTypeSpecType(T, Loc, PrevSpec, DiagID, Rep.get(), Policy);
710	}
711	bool SetTypeSpecType(TST T, SourceLocation Loc, const char *&PrevSpec,
712	unsigned &DiagID, Decl *Rep, bool Owned,
713	const PrintingPolicy &Policy);
714	bool SetTypeSpecType(TST T, SourceLocation TagKwLoc,
715	SourceLocation TagNameLoc, const char *&PrevSpec,
716	unsigned &DiagID, ParsedType Rep,
717	const PrintingPolicy &Policy);
718	bool SetTypeSpecType(TST T, SourceLocation TagKwLoc,
719	SourceLocation TagNameLoc, const char *&PrevSpec,
720	unsigned &DiagID, Decl *Rep, bool Owned,
721	const PrintingPolicy &Policy);
722	bool SetTypeSpecType(TST T, SourceLocation Loc, const char *&PrevSpec,
723	unsigned &DiagID, TemplateIdAnnotation *Rep,
724	const PrintingPolicy &Policy);
725
726	bool SetTypeSpecType(TST T, SourceLocation Loc, const char *&PrevSpec,
727	unsigned &DiagID, Expr *Rep,
728	const PrintingPolicy &policy);
729	bool SetTypeAltiVecVector(bool isAltiVecVector, SourceLocation Loc,
730	const char *&PrevSpec, unsigned &DiagID,
731	const PrintingPolicy &Policy);
732	bool SetTypeAltiVecPixel(bool isAltiVecPixel, SourceLocation Loc,
733	const char *&PrevSpec, unsigned &DiagID,
734	const PrintingPolicy &Policy);
735	bool SetTypeAltiVecBool(bool isAltiVecBool, SourceLocation Loc,
736	const char *&PrevSpec, unsigned &DiagID,
737	const PrintingPolicy &Policy);
738	bool SetTypePipe(bool isPipe, SourceLocation Loc,
739	const char *&PrevSpec, unsigned &DiagID,
740	const PrintingPolicy &Policy);
741	bool SetBitIntType(SourceLocation KWLoc, Expr *BitWidth,
742	const char *&PrevSpec, unsigned &DiagID,
743	const PrintingPolicy &Policy);
744	bool SetTypeSpecSat(SourceLocation Loc, const char *&PrevSpec,
745	unsigned &DiagID);
746	bool SetTypeSpecError();
747	void UpdateDeclRep(Decl *Rep) {
748	assert(isDeclRep((TST) TypeSpecType))(static_cast <bool> (isDeclRep((TST) TypeSpecType)) ? void (0) : __assert_fail ("isDeclRep((TST) TypeSpecType)", "clang/include/clang/Sema/DeclSpec.h" , 748, __extension__ __PRETTY_FUNCTION__));
749	DeclRep = Rep;
750	}
751	void UpdateTypeRep(ParsedType Rep) {
752	assert(isTypeRep((TST) TypeSpecType))(static_cast <bool> (isTypeRep((TST) TypeSpecType)) ? void (0) : __assert_fail ("isTypeRep((TST) TypeSpecType)", "clang/include/clang/Sema/DeclSpec.h" , 752, __extension__ __PRETTY_FUNCTION__));
753	TypeRep = Rep;
754	}
755	void UpdateExprRep(Expr *Rep) {
756	assert(isExprRep((TST) TypeSpecType))(static_cast <bool> (isExprRep((TST) TypeSpecType)) ? void (0) : __assert_fail ("isExprRep((TST) TypeSpecType)", "clang/include/clang/Sema/DeclSpec.h" , 756, __extension__ __PRETTY_FUNCTION__));
757	ExprRep = Rep;
758	}
759
760	bool SetTypeQual(TQ T, SourceLocation Loc);
761
762	bool SetTypeQual(TQ T, SourceLocation Loc, const char *&PrevSpec,
763	unsigned &DiagID, const LangOptions &Lang);
764
765	bool setFunctionSpecInline(SourceLocation Loc, const char *&PrevSpec,
766	unsigned &DiagID);
767	bool setFunctionSpecForceInline(SourceLocation Loc, const char *&PrevSpec,
768	unsigned &DiagID);
769	bool setFunctionSpecVirtual(SourceLocation Loc, const char *&PrevSpec,
770	unsigned &DiagID);
771	bool setFunctionSpecExplicit(SourceLocation Loc, const char *&PrevSpec,
772	unsigned &DiagID, ExplicitSpecifier ExplicitSpec,
773	SourceLocation CloseParenLoc);
774	bool setFunctionSpecNoreturn(SourceLocation Loc, const char *&PrevSpec,
775	unsigned &DiagID);
776
777	bool SetFriendSpec(SourceLocation Loc, const char *&PrevSpec,
778	unsigned &DiagID);
779	bool setModulePrivateSpec(SourceLocation Loc, const char *&PrevSpec,
780	unsigned &DiagID);
781	bool SetConstexprSpec(ConstexprSpecKind ConstexprKind, SourceLocation Loc,
782	const char *&PrevSpec, unsigned &DiagID);
783
784	FriendSpecified isFriendSpecified() const {
785	return static_cast<FriendSpecified>(Friend_specified);
786	}
787
788	SourceLocation getFriendSpecLoc() const { return FriendLoc; }
789
790	bool isModulePrivateSpecified() const { return ModulePrivateLoc.isValid(); }
791	SourceLocation getModulePrivateSpecLoc() const { return ModulePrivateLoc; }
792
793	ConstexprSpecKind getConstexprSpecifier() const {
794	return ConstexprSpecKind(ConstexprSpecifier);
795	}
796
797	SourceLocation getConstexprSpecLoc() const { return ConstexprLoc; }
798	bool hasConstexprSpecifier() const {
799	return getConstexprSpecifier() != ConstexprSpecKind::Unspecified;
800	}
801
802	void ClearConstexprSpec() {
803	ConstexprSpecifier = static_cast<unsigned>(ConstexprSpecKind::Unspecified);
804	ConstexprLoc = SourceLocation();
805	}
806
807	AttributePool &getAttributePool() const {
808	return Attrs.getPool();
809	}
810
811	/// Concatenates two attribute lists.
812	///
813	/// The GCC attribute syntax allows for the following:
814	///
815	/// \code
816	/// short __attribute__(( unused, deprecated ))
817	/// int __attribute__(( may_alias, aligned(16) )) var;
818	/// \endcode
819	///
820	/// This declares 4 attributes using 2 lists. The following syntax is
821	/// also allowed and equivalent to the previous declaration.
822	///
823	/// \code
824	/// short __attribute__((unused)) __attribute__((deprecated))
825	/// int __attribute__((may_alias)) __attribute__((aligned(16))) var;
826	/// \endcode
827	///
828	void addAttributes(const ParsedAttributesView &AL) {
829	Attrs.addAll(AL.begin(), AL.end());
830	}
831
832	bool hasAttributes() const { return !Attrs.empty(); }
833
834	ParsedAttributes &getAttributes() { return Attrs; }
835	const ParsedAttributes &getAttributes() const { return Attrs; }
836
837	void takeAttributesFrom(ParsedAttributes &attrs) {
838	Attrs.takeAllFrom(attrs);
839	}
840
841	/// Finish - This does final analysis of the declspec, issuing diagnostics for
842	/// things like "_Imaginary" (lacking an FP type). After calling this method,
843	/// DeclSpec is guaranteed self-consistent, even if an error occurred.
844	void Finish(Sema &S, const PrintingPolicy &Policy);
845
846	const WrittenBuiltinSpecs& getWrittenBuiltinSpecs() const {
847	return writtenBS;
848	}
849
850	ObjCDeclSpec *getObjCQualifiers() const { return ObjCQualifiers; }
851	void setObjCQualifiers(ObjCDeclSpec *quals) { ObjCQualifiers = quals; }
852
853	/// Checks if this DeclSpec can stand alone, without a Declarator.
854	///
855	/// Only tag declspecs can stand alone.
856	bool isMissingDeclaratorOk();
857	};
858
859	/// Captures information about "declaration specifiers" specific to
860	/// Objective-C.
861	class ObjCDeclSpec {
862	public:
863	/// ObjCDeclQualifier - Qualifier used on types in method
864	/// declarations. Not all combinations are sensible. Parameters
865	/// can be one of { in, out, inout } with one of { bycopy, byref }.
866	/// Returns can either be { oneway } or not.
867	///
868	/// This should be kept in sync with Decl::ObjCDeclQualifier.
869	enum ObjCDeclQualifier {
870	DQ_None = 0x0,
871	DQ_In = 0x1,
872	DQ_Inout = 0x2,
873	DQ_Out = 0x4,
874	DQ_Bycopy = 0x8,
875	DQ_Byref = 0x10,
876	DQ_Oneway = 0x20,
877	DQ_CSNullability = 0x40
878	};
879
880	ObjCDeclSpec()
881	: objcDeclQualifier(DQ_None),
882	PropertyAttributes(ObjCPropertyAttribute::kind_noattr), Nullability(0),
883	GetterName(nullptr), SetterName(nullptr) {}
884
885	ObjCDeclQualifier getObjCDeclQualifier() const {
886	return (ObjCDeclQualifier)objcDeclQualifier;
887	}
888	void setObjCDeclQualifier(ObjCDeclQualifier DQVal) {
889	objcDeclQualifier = (ObjCDeclQualifier) (objcDeclQualifier \| DQVal);
890	}
891	void clearObjCDeclQualifier(ObjCDeclQualifier DQVal) {
892	objcDeclQualifier = (ObjCDeclQualifier) (objcDeclQualifier & ~DQVal);
893	}
894
895	ObjCPropertyAttribute::Kind getPropertyAttributes() const {
896	return ObjCPropertyAttribute::Kind(PropertyAttributes);
897	}
898	void setPropertyAttributes(ObjCPropertyAttribute::Kind PRVal) {
899	PropertyAttributes =
900	(ObjCPropertyAttribute::Kind)(PropertyAttributes \| PRVal);
901	}
902
903	NullabilityKind getNullability() const {
904	assert((static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Objective-C declspec doesn't have nullability" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Objective-C declspec doesn't have nullability\"" , "clang/include/clang/Sema/DeclSpec.h", 907, __extension__ __PRETTY_FUNCTION__ ))
905	((getObjCDeclQualifier() & DQ_CSNullability) \|\|(static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Objective-C declspec doesn't have nullability" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Objective-C declspec doesn't have nullability\"" , "clang/include/clang/Sema/DeclSpec.h", 907, __extension__ __PRETTY_FUNCTION__ ))
906	(getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) &&(static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Objective-C declspec doesn't have nullability" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Objective-C declspec doesn't have nullability\"" , "clang/include/clang/Sema/DeclSpec.h", 907, __extension__ __PRETTY_FUNCTION__ ))
907	"Objective-C declspec doesn't have nullability")(static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Objective-C declspec doesn't have nullability" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Objective-C declspec doesn't have nullability\"" , "clang/include/clang/Sema/DeclSpec.h", 907, __extension__ __PRETTY_FUNCTION__ ));
908	return static_cast<NullabilityKind>(Nullability);
909	}
910
911	SourceLocation getNullabilityLoc() const {
912	assert((static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Objective-C declspec doesn't have nullability" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Objective-C declspec doesn't have nullability\"" , "clang/include/clang/Sema/DeclSpec.h", 915, __extension__ __PRETTY_FUNCTION__ ))
913	((getObjCDeclQualifier() & DQ_CSNullability) \|\|(static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Objective-C declspec doesn't have nullability" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Objective-C declspec doesn't have nullability\"" , "clang/include/clang/Sema/DeclSpec.h", 915, __extension__ __PRETTY_FUNCTION__ ))
914	(getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) &&(static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Objective-C declspec doesn't have nullability" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Objective-C declspec doesn't have nullability\"" , "clang/include/clang/Sema/DeclSpec.h", 915, __extension__ __PRETTY_FUNCTION__ ))
915	"Objective-C declspec doesn't have nullability")(static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Objective-C declspec doesn't have nullability" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Objective-C declspec doesn't have nullability\"" , "clang/include/clang/Sema/DeclSpec.h", 915, __extension__ __PRETTY_FUNCTION__ ));
916	return NullabilityLoc;
917	}
918
919	void setNullability(SourceLocation loc, NullabilityKind kind) {
920	assert((static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Set the nullability declspec or property attribute first" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Set the nullability declspec or property attribute first\"" , "clang/include/clang/Sema/DeclSpec.h", 923, __extension__ __PRETTY_FUNCTION__ ))
921	((getObjCDeclQualifier() & DQ_CSNullability) \|\|(static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Set the nullability declspec or property attribute first" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Set the nullability declspec or property attribute first\"" , "clang/include/clang/Sema/DeclSpec.h", 923, __extension__ __PRETTY_FUNCTION__ ))
922	(getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) &&(static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Set the nullability declspec or property attribute first" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Set the nullability declspec or property attribute first\"" , "clang/include/clang/Sema/DeclSpec.h", 923, __extension__ __PRETTY_FUNCTION__ ))
923	"Set the nullability declspec or property attribute first")(static_cast <bool> (((getObjCDeclQualifier() & DQ_CSNullability ) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability )) && "Set the nullability declspec or property attribute first" ) ? void (0) : __assert_fail ("((getObjCDeclQualifier() & DQ_CSNullability) \|\| (getPropertyAttributes() & ObjCPropertyAttribute::kind_nullability)) && \"Set the nullability declspec or property attribute first\"" , "clang/include/clang/Sema/DeclSpec.h", 923, __extension__ __PRETTY_FUNCTION__ ));
924	Nullability = static_cast<unsigned>(kind);
925	NullabilityLoc = loc;
926	}
927
928	const IdentifierInfo *getGetterName() const { return GetterName; }
929	IdentifierInfo *getGetterName() { return GetterName; }
930	SourceLocation getGetterNameLoc() const { return GetterNameLoc; }
931	void setGetterName(IdentifierInfo *name, SourceLocation loc) {
932	GetterName = name;
933	GetterNameLoc = loc;
934	}
935
936	const IdentifierInfo *getSetterName() const { return SetterName; }
937	IdentifierInfo *getSetterName() { return SetterName; }
938	SourceLocation getSetterNameLoc() const { return SetterNameLoc; }
939	void setSetterName(IdentifierInfo *name, SourceLocation loc) {
940	SetterName = name;
941	SetterNameLoc = loc;
942	}
943
944	private:
945	// FIXME: These two are unrelated and mutually exclusive. So perhaps
946	// we can put them in a union to reflect their mutual exclusivity
947	// (space saving is negligible).
948	unsigned objcDeclQualifier : 7;
949
950	// NOTE: VC++ treats enums as signed, avoid using ObjCPropertyAttribute::Kind
951	unsigned PropertyAttributes : NumObjCPropertyAttrsBits;
952
953	unsigned Nullability : 2;
954
955	SourceLocation NullabilityLoc;
956
957	IdentifierInfo *GetterName; // getter name or NULL if no getter
958	IdentifierInfo *SetterName; // setter name or NULL if no setter
959	SourceLocation GetterNameLoc; // location of the getter attribute's value
960	SourceLocation SetterNameLoc; // location of the setter attribute's value
961
962	};
963
964	/// Describes the kind of unqualified-id parsed.
965	enum class UnqualifiedIdKind {
966	/// An identifier.
967	IK_Identifier,
968	/// An overloaded operator name, e.g., operator+.
969	IK_OperatorFunctionId,
970	/// A conversion function name, e.g., operator int.
971	IK_ConversionFunctionId,
972	/// A user-defined literal name, e.g., operator "" _i.
973	IK_LiteralOperatorId,
974	/// A constructor name.
975	IK_ConstructorName,
976	/// A constructor named via a template-id.
977	IK_ConstructorTemplateId,
978	/// A destructor name.
979	IK_DestructorName,
980	/// A template-id, e.g., f<int>.
981	IK_TemplateId,
982	/// An implicit 'self' parameter
983	IK_ImplicitSelfParam,
984	/// A deduction-guide name (a template-name)
985	IK_DeductionGuideName
986	};
987
988	/// Represents a C++ unqualified-id that has been parsed.
989	class UnqualifiedId {
990	private:
991	UnqualifiedId(const UnqualifiedId &Other) = delete;
992	const UnqualifiedId &operator=(const UnqualifiedId &) = delete;
993
994	/// Describes the kind of unqualified-id parsed.
995	UnqualifiedIdKind Kind;
996
997	public:
998	struct OFI {
999	/// The kind of overloaded operator.
1000	OverloadedOperatorKind Operator;
1001
1002	/// The source locations of the individual tokens that name
1003	/// the operator, e.g., the "new", "[", and "]" tokens in
1004	/// operator new [].
1005	///
1006	/// Different operators have different numbers of tokens in their name,
1007	/// up to three. Any remaining source locations in this array will be
1008	/// set to an invalid value for operators with fewer than three tokens.
1009	SourceLocation SymbolLocations[3];
1010	};
1011
1012	/// Anonymous union that holds extra data associated with the
1013	/// parsed unqualified-id.
1014	union {
1015	/// When Kind == IK_Identifier, the parsed identifier, or when
1016	/// Kind == IK_UserLiteralId, the identifier suffix.
1017	IdentifierInfo *Identifier;
1018
1019	/// When Kind == IK_OperatorFunctionId, the overloaded operator
1020	/// that we parsed.
1021	struct OFI OperatorFunctionId;
1022
1023	/// When Kind == IK_ConversionFunctionId, the type that the
1024	/// conversion function names.
1025	UnionParsedType ConversionFunctionId;
1026
1027	/// When Kind == IK_ConstructorName, the class-name of the type
1028	/// whose constructor is being referenced.
1029	UnionParsedType ConstructorName;
1030
1031	/// When Kind == IK_DestructorName, the type referred to by the
1032	/// class-name.
1033	UnionParsedType DestructorName;
1034
1035	/// When Kind == IK_DeductionGuideName, the parsed template-name.
1036	UnionParsedTemplateTy TemplateName;
1037
1038	/// When Kind == IK_TemplateId or IK_ConstructorTemplateId,
1039	/// the template-id annotation that contains the template name and
1040	/// template arguments.
1041	TemplateIdAnnotation *TemplateId;
1042	};
1043
1044	/// The location of the first token that describes this unqualified-id,
1045	/// which will be the location of the identifier, "operator" keyword,
1046	/// tilde (for a destructor), or the template name of a template-id.
1047	SourceLocation StartLocation;
1048
1049	/// The location of the last token that describes this unqualified-id.
1050	SourceLocation EndLocation;
1051
1052	UnqualifiedId()
1053	: Kind(UnqualifiedIdKind::IK_Identifier), Identifier(nullptr) {}
1054
1055	/// Clear out this unqualified-id, setting it to default (invalid)
1056	/// state.
1057	void clear() {
1058	Kind = UnqualifiedIdKind::IK_Identifier;
1059	Identifier = nullptr;
1060	StartLocation = SourceLocation();
1061	EndLocation = SourceLocation();
1062	}
1063
1064	/// Determine whether this unqualified-id refers to a valid name.
1065	bool isValid() const { return StartLocation.isValid(); }
1066
1067	/// Determine whether this unqualified-id refers to an invalid name.
1068	bool isInvalid() const { return !isValid(); }
1069
1070	/// Determine what kind of name we have.
1071	UnqualifiedIdKind getKind() const { return Kind; }
1072
1073	/// Specify that this unqualified-id was parsed as an identifier.
1074	///
1075	/// \param Id the parsed identifier.
1076	/// \param IdLoc the location of the parsed identifier.
1077	void setIdentifier(const IdentifierInfo *Id, SourceLocation IdLoc) {
1078	Kind = UnqualifiedIdKind::IK_Identifier;
1079	Identifier = const_cast<IdentifierInfo *>(Id);
1080	StartLocation = EndLocation = IdLoc;
1081	}
1082
1083	/// Specify that this unqualified-id was parsed as an
1084	/// operator-function-id.
1085	///
1086	/// \param OperatorLoc the location of the 'operator' keyword.
1087	///
1088	/// \param Op the overloaded operator.
1089	///
1090	/// \param SymbolLocations the locations of the individual operator symbols
1091	/// in the operator.
1092	void setOperatorFunctionId(SourceLocation OperatorLoc,
1093	OverloadedOperatorKind Op,
1094	SourceLocation SymbolLocations[3]);
1095
1096	/// Specify that this unqualified-id was parsed as a
1097	/// conversion-function-id.
1098	///
1099	/// \param OperatorLoc the location of the 'operator' keyword.
1100	///
1101	/// \param Ty the type to which this conversion function is converting.
1102	///
1103	/// \param EndLoc the location of the last token that makes up the type name.
1104	void setConversionFunctionId(SourceLocation OperatorLoc,
1105	ParsedType Ty,
1106	SourceLocation EndLoc) {
1107	Kind = UnqualifiedIdKind::IK_ConversionFunctionId;
1108	StartLocation = OperatorLoc;
1109	EndLocation = EndLoc;
1110	ConversionFunctionId = Ty;
1111	}
1112
1113	/// Specific that this unqualified-id was parsed as a
1114	/// literal-operator-id.
1115	///
1116	/// \param Id the parsed identifier.
1117	///
1118	/// \param OpLoc the location of the 'operator' keyword.
1119	///
1120	/// \param IdLoc the location of the identifier.
1121	void setLiteralOperatorId(const IdentifierInfo *Id, SourceLocation OpLoc,
1122	SourceLocation IdLoc) {
1123	Kind = UnqualifiedIdKind::IK_LiteralOperatorId;
1124	Identifier = const_cast<IdentifierInfo *>(Id);
1125	StartLocation = OpLoc;
1126	EndLocation = IdLoc;
1127	}
1128
1129	/// Specify that this unqualified-id was parsed as a constructor name.
1130	///
1131	/// \param ClassType the class type referred to by the constructor name.
1132	///
1133	/// \param ClassNameLoc the location of the class name.
1134	///
1135	/// \param EndLoc the location of the last token that makes up the type name.
1136	void setConstructorName(ParsedType ClassType,
1137	SourceLocation ClassNameLoc,
1138	SourceLocation EndLoc) {
1139	Kind = UnqualifiedIdKind::IK_ConstructorName;
1140	StartLocation = ClassNameLoc;
1141	EndLocation = EndLoc;
1142	ConstructorName = ClassType;
1143	}
1144
1145	/// Specify that this unqualified-id was parsed as a
1146	/// template-id that names a constructor.
1147	///
1148	/// \param TemplateId the template-id annotation that describes the parsed
1149	/// template-id. This UnqualifiedId instance will take ownership of the
1150	/// \p TemplateId and will free it on destruction.
1151	void setConstructorTemplateId(TemplateIdAnnotation *TemplateId);
1152
1153	/// Specify that this unqualified-id was parsed as a destructor name.
1154	///
1155	/// \param TildeLoc the location of the '~' that introduces the destructor
1156	/// name.
1157	///
1158	/// \param ClassType the name of the class referred to by the destructor name.
1159	void setDestructorName(SourceLocation TildeLoc,
1160	ParsedType ClassType,
1161	SourceLocation EndLoc) {
1162	Kind = UnqualifiedIdKind::IK_DestructorName;
1163	StartLocation = TildeLoc;
1164	EndLocation = EndLoc;
1165	DestructorName = ClassType;
1166	}
1167
1168	/// Specify that this unqualified-id was parsed as a template-id.
1169	///
1170	/// \param TemplateId the template-id annotation that describes the parsed
1171	/// template-id. This UnqualifiedId instance will take ownership of the
1172	/// \p TemplateId and will free it on destruction.
1173	void setTemplateId(TemplateIdAnnotation *TemplateId);
1174
1175	/// Specify that this unqualified-id was parsed as a template-name for
1176	/// a deduction-guide.
1177	///
1178	/// \param Template The parsed template-name.
1179	/// \param TemplateLoc The location of the parsed template-name.
1180	void setDeductionGuideName(ParsedTemplateTy Template,
1181	SourceLocation TemplateLoc) {
1182	Kind = UnqualifiedIdKind::IK_DeductionGuideName;
1183	TemplateName = Template;
1184	StartLocation = EndLocation = TemplateLoc;
1185	}
1186
1187	/// Specify that this unqualified-id is an implicit 'self'
1188	/// parameter.
1189	///
1190	/// \param Id the identifier.
1191	void setImplicitSelfParam(const IdentifierInfo *Id) {
1192	Kind = UnqualifiedIdKind::IK_ImplicitSelfParam;
1193	Identifier = const_cast<IdentifierInfo *>(Id);
1194	StartLocation = EndLocation = SourceLocation();
1195	}
1196
1197	/// Return the source range that covers this unqualified-id.
1198	SourceRange getSourceRange() const LLVM_READONLY__attribute__((__pure__)) {
1199	return SourceRange(StartLocation, EndLocation);
1200	}
1201	SourceLocation getBeginLoc() const LLVM_READONLY__attribute__((__pure__)) { return StartLocation; }
1202	SourceLocation getEndLoc() const LLVM_READONLY__attribute__((__pure__)) { return EndLocation; }
1203	};
1204
1205	/// A set of tokens that has been cached for later parsing.
1206	typedef SmallVector<Token, 4> CachedTokens;
1207
1208	/// One instance of this struct is used for each type in a
1209	/// declarator that is parsed.
1210	///
1211	/// This is intended to be a small value object.
1212	struct DeclaratorChunk {
1213	DeclaratorChunk() {};
1214
1215	enum {
1216	Pointer, Reference, Array, Function, BlockPointer, MemberPointer, Paren, Pipe
1217	} Kind;
1218
1219	/// Loc - The place where this type was defined.
1220	SourceLocation Loc;
1221	/// EndLoc - If valid, the place where this chunck ends.
1222	SourceLocation EndLoc;
1223
1224	SourceRange getSourceRange() const {
1225	if (EndLoc.isInvalid())
1226	return SourceRange(Loc, Loc);
1227	return SourceRange(Loc, EndLoc);
1228	}
1229
1230	ParsedAttributesView AttrList;
1231
1232	struct PointerTypeInfo {
1233	/// The type qualifiers: const/volatile/restrict/unaligned/atomic.
1234	unsigned TypeQuals : 5;
1235
1236	/// The location of the const-qualifier, if any.
1237	SourceLocation ConstQualLoc;
1238
1239	/// The location of the volatile-qualifier, if any.
1240	SourceLocation VolatileQualLoc;
1241
1242	/// The location of the restrict-qualifier, if any.
1243	SourceLocation RestrictQualLoc;
1244
1245	/// The location of the _Atomic-qualifier, if any.
1246	SourceLocation AtomicQualLoc;
1247
1248	/// The location of the __unaligned-qualifier, if any.
1249	SourceLocation UnalignedQualLoc;
1250
1251	void destroy() {
1252	}
1253	};
1254
1255	struct ReferenceTypeInfo {
1256	/// The type qualifier: restrict. [GNU] C++ extension
1257	bool HasRestrict : 1;
1258	/// True if this is an lvalue reference, false if it's an rvalue reference.
1259	bool LValueRef : 1;
1260	void destroy() {
1261	}
1262	};
1263
1264	struct ArrayTypeInfo {
1265	/// The type qualifiers for the array:
1266	/// const/volatile/restrict/__unaligned/_Atomic.
1267	unsigned TypeQuals : 5;
1268
1269	/// True if this dimension included the 'static' keyword.
1270	unsigned hasStatic : 1;
1271
1272	/// True if this dimension was [*]. In this case, NumElts is null.
1273	unsigned isStar : 1;
1274
1275	/// This is the size of the array, or null if [] or [*] was specified.
1276	/// Since the parser is multi-purpose, and we don't want to impose a root
1277	/// expression class on all clients, NumElts is untyped.
1278	Expr *NumElts;
1279
1280	void destroy() {}
1281	};
1282
1283	/// ParamInfo - An array of paraminfo objects is allocated whenever a function
1284	/// declarator is parsed. There are two interesting styles of parameters
1285	/// here:
1286	/// K&R-style identifier lists and parameter type lists. K&R-style identifier
1287	/// lists will have information about the identifier, but no type information.
1288	/// Parameter type lists will have type info (if the actions module provides
1289	/// it), but may have null identifier info: e.g. for 'void foo(int X, int)'.
1290	struct ParamInfo {
1291	IdentifierInfo *Ident;
1292	SourceLocation IdentLoc;
1293	Decl *Param;
1294
1295	/// DefaultArgTokens - When the parameter's default argument
1296	/// cannot be parsed immediately (because it occurs within the
1297	/// declaration of a member function), it will be stored here as a
1298	/// sequence of tokens to be parsed once the class definition is
1299	/// complete. Non-NULL indicates that there is a default argument.
1300	std::unique_ptr<CachedTokens> DefaultArgTokens;
1301
1302	ParamInfo() = default;
1303	ParamInfo(IdentifierInfo *ident, SourceLocation iloc,
1304	Decl *param,
1305	std::unique_ptr<CachedTokens> DefArgTokens = nullptr)
1306	: Ident(ident), IdentLoc(iloc), Param(param),
1307	DefaultArgTokens(std::move(DefArgTokens)) {}
1308	};
1309
1310	struct TypeAndRange {
1311	ParsedType Ty;
1312	SourceRange Range;
1313	};
1314
1315	struct FunctionTypeInfo {
1316	/// hasPrototype - This is true if the function had at least one typed
1317	/// parameter. If the function is () or (a,b,c), then it has no prototype,
1318	/// and is treated as a K&R-style function.
1319	unsigned hasPrototype : 1;
1320
1321	/// isVariadic - If this function has a prototype, and if that
1322	/// proto ends with ',...)', this is true. When true, EllipsisLoc
1323	/// contains the location of the ellipsis.
1324	unsigned isVariadic : 1;
1325
1326	/// Can this declaration be a constructor-style initializer?
1327	unsigned isAmbiguous : 1;
1328
1329	/// Whether the ref-qualifier (if any) is an lvalue reference.
1330	/// Otherwise, it's an rvalue reference.
1331	unsigned RefQualifierIsLValueRef : 1;
1332
1333	/// ExceptionSpecType - An ExceptionSpecificationType value.
1334	unsigned ExceptionSpecType : 4;
1335
1336	/// DeleteParams - If this is true, we need to delete[] Params.
1337	unsigned DeleteParams : 1;
1338
1339	/// HasTrailingReturnType - If this is true, a trailing return type was
1340	/// specified.
1341	unsigned HasTrailingReturnType : 1;
1342
1343	/// The location of the left parenthesis in the source.
1344	SourceLocation LParenLoc;
1345
1346	/// When isVariadic is true, the location of the ellipsis in the source.
1347	SourceLocation EllipsisLoc;
1348
1349	/// The location of the right parenthesis in the source.
1350	SourceLocation RParenLoc;
1351
1352	/// NumParams - This is the number of formal parameters specified by the
1353	/// declarator.
1354	unsigned NumParams;
1355
1356	/// NumExceptionsOrDecls - This is the number of types in the
1357	/// dynamic-exception-decl, if the function has one. In C, this is the
1358	/// number of declarations in the function prototype.
1359	unsigned NumExceptionsOrDecls;
1360
1361	/// The location of the ref-qualifier, if any.
1362	///
1363	/// If this is an invalid location, there is no ref-qualifier.
1364	SourceLocation RefQualifierLoc;
1365
1366	/// The location of the 'mutable' qualifer in a lambda-declarator, if
1367	/// any.
1368	SourceLocation MutableLoc;
1369
1370	/// The beginning location of the exception specification, if any.
1371	SourceLocation ExceptionSpecLocBeg;
1372
1373	/// The end location of the exception specification, if any.
1374	SourceLocation ExceptionSpecLocEnd;
1375
1376	/// Params - This is a pointer to a new[]'d array of ParamInfo objects that
1377	/// describe the parameters specified by this function declarator. null if
1378	/// there are no parameters specified.
1379	ParamInfo *Params;
1380
1381	/// DeclSpec for the function with the qualifier related info.
1382	DeclSpec *MethodQualifiers;
1383
1384	/// AttributeFactory for the MethodQualifiers.
1385	AttributeFactory *QualAttrFactory;
1386
1387	union {
1388	/// Pointer to a new[]'d array of TypeAndRange objects that
1389	/// contain the types in the function's dynamic exception specification
1390	/// and their locations, if there is one.
1391	TypeAndRange *Exceptions;
1392
1393	/// Pointer to the expression in the noexcept-specifier of this
1394	/// function, if it has one.
1395	Expr *NoexceptExpr;
1396
1397	/// Pointer to the cached tokens for an exception-specification
1398	/// that has not yet been parsed.
1399	CachedTokens *ExceptionSpecTokens;
1400
1401	/// Pointer to a new[]'d array of declarations that need to be available
1402	/// for lookup inside the function body, if one exists. Does not exist in
1403	/// C++.
1404	NamedDecl **DeclsInPrototype;
1405	};
1406
1407	/// If HasTrailingReturnType is true, this is the trailing return
1408	/// type specified.
1409	UnionParsedType TrailingReturnType;
1410
1411	/// If HasTrailingReturnType is true, this is the location of the trailing
1412	/// return type.
1413	SourceLocation TrailingReturnTypeLoc;
1414
1415	/// Reset the parameter list to having zero parameters.
1416	///
1417	/// This is used in various places for error recovery.
1418	void freeParams() {
1419	for (unsigned I = 0; I < NumParams; ++I)
1420	Params[I].DefaultArgTokens.reset();
1421	if (DeleteParams) {
1422	delete[] Params;
1423	DeleteParams = false;
1424	}
1425	NumParams = 0;
1426	}
1427
1428	void destroy() {
1429	freeParams();
1430	delete QualAttrFactory;
1431	delete MethodQualifiers;
1432	switch (getExceptionSpecType()) {
1433	default:
1434	break;
1435	case EST_Dynamic:
1436	delete[] Exceptions;
1437	break;
1438	case EST_Unparsed:
1439	delete ExceptionSpecTokens;
1440	break;
1441	case EST_None:
1442	if (NumExceptionsOrDecls != 0)
1443	delete[] DeclsInPrototype;
1444	break;
1445	}
1446	}
1447
1448	DeclSpec &getOrCreateMethodQualifiers() {
1449	if (!MethodQualifiers) {
1450	QualAttrFactory = new AttributeFactory();
1451	MethodQualifiers = new DeclSpec(*QualAttrFactory);
1452	}
1453	return *MethodQualifiers;
1454	}
1455
1456	/// isKNRPrototype - Return true if this is a K&R style identifier list,
1457	/// like "void foo(a,b,c)". In a function definition, this will be followed
1458	/// by the parameter type definitions.
1459	bool isKNRPrototype() const { return !hasPrototype && NumParams != 0; }
1460
1461	SourceLocation getLParenLoc() const { return LParenLoc; }
1462
1463	SourceLocation getEllipsisLoc() const { return EllipsisLoc; }
1464
1465	SourceLocation getRParenLoc() const { return RParenLoc; }
1466
1467	SourceLocation getExceptionSpecLocBeg() const {
1468	return ExceptionSpecLocBeg;
1469	}
1470
1471	SourceLocation getExceptionSpecLocEnd() const {
1472	return ExceptionSpecLocEnd;
1473	}
1474
1475	SourceRange getExceptionSpecRange() const {
1476	return SourceRange(getExceptionSpecLocBeg(), getExceptionSpecLocEnd());
1477	}
1478
1479	/// Retrieve the location of the ref-qualifier, if any.
1480	SourceLocation getRefQualifierLoc() const { return RefQualifierLoc; }
1481
1482	/// Retrieve the location of the 'const' qualifier.
1483	SourceLocation getConstQualifierLoc() const {
1484	assert(MethodQualifiers)(static_cast <bool> (MethodQualifiers) ? void (0) : __assert_fail ("MethodQualifiers", "clang/include/clang/Sema/DeclSpec.h", 1484 , __extension__ __PRETTY_FUNCTION__));
1485	return MethodQualifiers->getConstSpecLoc();
1486	}
1487
1488	/// Retrieve the location of the 'volatile' qualifier.
1489	SourceLocation getVolatileQualifierLoc() const {
1490	assert(MethodQualifiers)(static_cast <bool> (MethodQualifiers) ? void (0) : __assert_fail ("MethodQualifiers", "clang/include/clang/Sema/DeclSpec.h", 1490 , __extension__ __PRETTY_FUNCTION__));
1491	return MethodQualifiers->getVolatileSpecLoc();
1492	}
1493
1494	/// Retrieve the location of the 'restrict' qualifier.
1495	SourceLocation getRestrictQualifierLoc() const {
1496	assert(MethodQualifiers)(static_cast <bool> (MethodQualifiers) ? void (0) : __assert_fail ("MethodQualifiers", "clang/include/clang/Sema/DeclSpec.h", 1496 , __extension__ __PRETTY_FUNCTION__));
1497	return MethodQualifiers->getRestrictSpecLoc();
1498	}
1499
1500	/// Retrieve the location of the 'mutable' qualifier, if any.
1501	SourceLocation getMutableLoc() const { return MutableLoc; }
1502
1503	/// Determine whether this function declaration contains a
1504	/// ref-qualifier.
1505	bool hasRefQualifier() const { return getRefQualifierLoc().isValid(); }
1506
1507	/// Determine whether this lambda-declarator contains a 'mutable'
1508	/// qualifier.
1509	bool hasMutableQualifier() const { return getMutableLoc().isValid(); }
1510
1511	/// Determine whether this method has qualifiers.
1512	bool hasMethodTypeQualifiers() const {
1513	return MethodQualifiers && (MethodQualifiers->getTypeQualifiers() \|\|
1514	MethodQualifiers->getAttributes().size());
1515	}
1516
1517	/// Get the type of exception specification this function has.
1518	ExceptionSpecificationType getExceptionSpecType() const {
1519	return static_cast<ExceptionSpecificationType>(ExceptionSpecType);
1520	}
1521
1522	/// Get the number of dynamic exception specifications.
1523	unsigned getNumExceptions() const {
1524	assert(ExceptionSpecType != EST_None)(static_cast <bool> (ExceptionSpecType != EST_None) ? void (0) : __assert_fail ("ExceptionSpecType != EST_None", "clang/include/clang/Sema/DeclSpec.h" , 1524, __extension__ __PRETTY_FUNCTION__));
1525	return NumExceptionsOrDecls;
1526	}
1527
1528	/// Get the non-parameter decls defined within this function
1529	/// prototype. Typically these are tag declarations.
1530	ArrayRef<NamedDecl *> getDeclsInPrototype() const {
1531	assert(ExceptionSpecType == EST_None)(static_cast <bool> (ExceptionSpecType == EST_None) ? void (0) : __assert_fail ("ExceptionSpecType == EST_None", "clang/include/clang/Sema/DeclSpec.h" , 1531, __extension__ __PRETTY_FUNCTION__));
1532	return llvm::ArrayRef(DeclsInPrototype, NumExceptionsOrDecls);
1533	}
1534
1535	/// Determine whether this function declarator had a
1536	/// trailing-return-type.
1537	bool hasTrailingReturnType() const { return HasTrailingReturnType; }
1538
1539	/// Get the trailing-return-type for this function declarator.
1540	ParsedType getTrailingReturnType() const {
1541	assert(HasTrailingReturnType)(static_cast <bool> (HasTrailingReturnType) ? void (0) : __assert_fail ("HasTrailingReturnType", "clang/include/clang/Sema/DeclSpec.h" , 1541, __extension__ __PRETTY_FUNCTION__));
1542	return TrailingReturnType;
1543	}
1544
1545	/// Get the trailing-return-type location for this function declarator.
1546	SourceLocation getTrailingReturnTypeLoc() const {
1547	assert(HasTrailingReturnType)(static_cast <bool> (HasTrailingReturnType) ? void (0) : __assert_fail ("HasTrailingReturnType", "clang/include/clang/Sema/DeclSpec.h" , 1547, __extension__ __PRETTY_FUNCTION__));
1548	return TrailingReturnTypeLoc;
1549	}
1550	};
1551
1552	struct BlockPointerTypeInfo {
1553	/// For now, sema will catch these as invalid.
1554	/// The type qualifiers: const/volatile/restrict/__unaligned/_Atomic.
1555	unsigned TypeQuals : 5;
1556
1557	void destroy() {
1558	}
1559	};
1560
1561	struct MemberPointerTypeInfo {
1562	/// The type qualifiers: const/volatile/restrict/__unaligned/_Atomic.
1563	unsigned TypeQuals : 5;
1564	/// Location of the '*' token.
1565	SourceLocation StarLoc;
1566	// CXXScopeSpec has a constructor, so it can't be a direct member.
1567	// So we need some pointer-aligned storage and a bit of trickery.
1568	alignas(CXXScopeSpec) char ScopeMem[sizeof(CXXScopeSpec)];
1569	CXXScopeSpec &Scope() {
1570	return reinterpret_cast<CXXScopeSpec >(ScopeMem);
1571	}
1572	const CXXScopeSpec &Scope() const {
1573	return reinterpret_cast<const CXXScopeSpec >(ScopeMem);
1574	}
1575	void destroy() {
1576	Scope().~CXXScopeSpec();
1577	}
1578	};
1579
1580	struct PipeTypeInfo {
1581	/// The access writes.
1582	unsigned AccessWrites : 3;
1583
1584	void destroy() {}
1585	};
1586
1587	union {
1588	PointerTypeInfo Ptr;
1589	ReferenceTypeInfo Ref;
1590	ArrayTypeInfo Arr;
1591	FunctionTypeInfo Fun;
1592	BlockPointerTypeInfo Cls;
1593	MemberPointerTypeInfo Mem;
1594	PipeTypeInfo PipeInfo;
1595	};
1596
1597	void destroy() {
1598	switch (Kind) {
1599	case DeclaratorChunk::Function: return Fun.destroy();
1600	case DeclaratorChunk::Pointer: return Ptr.destroy();
1601	case DeclaratorChunk::BlockPointer: return Cls.destroy();
1602	case DeclaratorChunk::Reference: return Ref.destroy();
1603	case DeclaratorChunk::Array: return Arr.destroy();
1604	case DeclaratorChunk::MemberPointer: return Mem.destroy();
1605	case DeclaratorChunk::Paren: return;
1606	case DeclaratorChunk::Pipe: return PipeInfo.destroy();
1607	}
1608	}
1609
1610	/// If there are attributes applied to this declaratorchunk, return
1611	/// them.
1612	const ParsedAttributesView &getAttrs() const { return AttrList; }
1613	ParsedAttributesView &getAttrs() { return AttrList; }
1614
1615	/// Return a DeclaratorChunk for a pointer.
1616	static DeclaratorChunk getPointer(unsigned TypeQuals, SourceLocation Loc,
1617	SourceLocation ConstQualLoc,
1618	SourceLocation VolatileQualLoc,
1619	SourceLocation RestrictQualLoc,
1620	SourceLocation AtomicQualLoc,
1621	SourceLocation UnalignedQualLoc) {
1622	DeclaratorChunk I;
1623	I.Kind = Pointer;
1624	I.Loc = Loc;
1625	new (&I.Ptr) PointerTypeInfo;
1626	I.Ptr.TypeQuals = TypeQuals;
1627	I.Ptr.ConstQualLoc = ConstQualLoc;
1628	I.Ptr.VolatileQualLoc = VolatileQualLoc;
1629	I.Ptr.RestrictQualLoc = RestrictQualLoc;
1630	I.Ptr.AtomicQualLoc = AtomicQualLoc;
1631	I.Ptr.UnalignedQualLoc = UnalignedQualLoc;
1632	return I;
1633	}
1634
1635	/// Return a DeclaratorChunk for a reference.
1636	static DeclaratorChunk getReference(unsigned TypeQuals, SourceLocation Loc,
1637	bool lvalue) {
1638	DeclaratorChunk I;
1639	I.Kind = Reference;
1640	I.Loc = Loc;
1641	I.Ref.HasRestrict = (TypeQuals & DeclSpec::TQ_restrict) != 0;
1642	I.Ref.LValueRef = lvalue;
1643	return I;
1644	}
1645
1646	/// Return a DeclaratorChunk for an array.
1647	static DeclaratorChunk getArray(unsigned TypeQuals,
1648	bool isStatic, bool isStar, Expr *NumElts,
1649	SourceLocation LBLoc, SourceLocation RBLoc) {
1650	DeclaratorChunk I;
1651	I.Kind = Array;
1652	I.Loc = LBLoc;
1653	I.EndLoc = RBLoc;
1654	I.Arr.TypeQuals = TypeQuals;
1655	I.Arr.hasStatic = isStatic;
1656	I.Arr.isStar = isStar;
1657	I.Arr.NumElts = NumElts;
1658	return I;
1659	}
1660
1661	/// DeclaratorChunk::getFunction - Return a DeclaratorChunk for a function.
1662	/// "TheDeclarator" is the declarator that this will be added to.
1663	static DeclaratorChunk getFunction(bool HasProto,
1664	bool IsAmbiguous,
1665	SourceLocation LParenLoc,
1666	ParamInfo *Params, unsigned NumParams,
1667	SourceLocation EllipsisLoc,
1668	SourceLocation RParenLoc,
1669	bool RefQualifierIsLvalueRef,
1670	SourceLocation RefQualifierLoc,
1671	SourceLocation MutableLoc,
1672	ExceptionSpecificationType ESpecType,
1673	SourceRange ESpecRange,
1674	ParsedType *Exceptions,
1675	SourceRange *ExceptionRanges,
1676	unsigned NumExceptions,
1677	Expr *NoexceptExpr,
1678	CachedTokens *ExceptionSpecTokens,
1679	ArrayRef<NamedDecl *> DeclsInPrototype,
1680	SourceLocation LocalRangeBegin,
1681	SourceLocation LocalRangeEnd,
1682	Declarator &TheDeclarator,
1683	TypeResult TrailingReturnType =
1684	TypeResult(),
1685	SourceLocation TrailingReturnTypeLoc =
1686	SourceLocation(),
1687	DeclSpec *MethodQualifiers = nullptr);
1688
1689	/// Return a DeclaratorChunk for a block.
1690	static DeclaratorChunk getBlockPointer(unsigned TypeQuals,
1691	SourceLocation Loc) {
1692	DeclaratorChunk I;
1693	I.Kind = BlockPointer;
1694	I.Loc = Loc;
1695	I.Cls.TypeQuals = TypeQuals;
1696	return I;
1697	}
1698
1699	/// Return a DeclaratorChunk for a block.
1700	static DeclaratorChunk getPipe(unsigned TypeQuals,
1701	SourceLocation Loc) {
1702	DeclaratorChunk I;
1703	I.Kind = Pipe;
1704	I.Loc = Loc;
1705	I.Cls.TypeQuals = TypeQuals;
1706	return I;
1707	}
1708
1709	static DeclaratorChunk getMemberPointer(const CXXScopeSpec &SS,
1710	unsigned TypeQuals,
1711	SourceLocation StarLoc,
1712	SourceLocation EndLoc) {
1713	DeclaratorChunk I;
1714	I.Kind = MemberPointer;
1715	I.Loc = SS.getBeginLoc();
1716	I.EndLoc = EndLoc;
1717	new (&I.Mem) MemberPointerTypeInfo;
1718	I.Mem.StarLoc = StarLoc;
1719	I.Mem.TypeQuals = TypeQuals;
1720	new (I.Mem.ScopeMem) CXXScopeSpec(SS);
1721	return I;
1722	}
1723
1724	/// Return a DeclaratorChunk for a paren.
1725	static DeclaratorChunk getParen(SourceLocation LParenLoc,
1726	SourceLocation RParenLoc) {
1727	DeclaratorChunk I;
1728	I.Kind = Paren;
1729	I.Loc = LParenLoc;
1730	I.EndLoc = RParenLoc;
1731	return I;
1732	}
1733
1734	bool isParen() const {
1735	return Kind == Paren;
1736	}
1737	};
1738
1739	/// A parsed C++17 decomposition declarator of the form
1740	/// '[' identifier-list ']'
1741	class DecompositionDeclarator {
1742	public:
1743	struct Binding {
1744	IdentifierInfo *Name;
1745	SourceLocation NameLoc;
1746	};
1747
1748	private:
1749	/// The locations of the '[' and ']' tokens.
1750	SourceLocation LSquareLoc, RSquareLoc;
1751
1752	/// The bindings.
1753	Binding *Bindings;
1754	unsigned NumBindings : 31;
1755	unsigned DeleteBindings : 1;
1756
1757	friend class Declarator;
1758
1759	public:
1760	DecompositionDeclarator()
1761	: Bindings(nullptr), NumBindings(0), DeleteBindings(false) {}
1762	DecompositionDeclarator(const DecompositionDeclarator &G) = delete;
1763	DecompositionDeclarator &operator=(const DecompositionDeclarator &G) = delete;
1764	~DecompositionDeclarator() {
1765	if (DeleteBindings)
1766	delete[] Bindings;
1767	}
1768
1769	void clear() {
1770	LSquareLoc = RSquareLoc = SourceLocation();
1771	if (DeleteBindings)
1772	delete[] Bindings;
1773	Bindings = nullptr;
1774	NumBindings = 0;
1775	DeleteBindings = false;
1776	}
1777
1778	ArrayRef<Binding> bindings() const {
1779	return llvm::ArrayRef(Bindings, NumBindings);
1780	}
1781
1782	bool isSet() const { return LSquareLoc.isValid(); }
1783
1784	SourceLocation getLSquareLoc() const { return LSquareLoc; }
1785	SourceLocation getRSquareLoc() const { return RSquareLoc; }
1786	SourceRange getSourceRange() const {
1787	return SourceRange(LSquareLoc, RSquareLoc);
1788	}
1789	};
1790
1791	/// Described the kind of function definition (if any) provided for
1792	/// a function.
1793	enum class FunctionDefinitionKind {
1794	Declaration,
1795	Definition,
1796	Defaulted,
1797	Deleted
1798	};
1799
1800	enum class DeclaratorContext {
1801	File, // File scope declaration.
1802	Prototype, // Within a function prototype.
1803	ObjCResult, // An ObjC method result type.
1804	ObjCParameter, // An ObjC method parameter type.
1805	KNRTypeList, // K&R type definition list for formals.
1806	TypeName, // Abstract declarator for types.
1807	FunctionalCast, // Type in a C++ functional cast expression.
1808	Member, // Struct/Union field.
1809	Block, // Declaration within a block in a function.
1810	ForInit, // Declaration within first part of a for loop.
1811	SelectionInit, // Declaration within optional init stmt of if/switch.
1812	Condition, // Condition declaration in a C++ if/switch/while/for.
1813	TemplateParam, // Within a template parameter list.
1814	CXXNew, // C++ new-expression.
1815	CXXCatch, // C++ catch exception-declaration
1816	ObjCCatch, // Objective-C catch exception-declaration
1817	BlockLiteral, // Block literal declarator.
1818	LambdaExpr, // Lambda-expression declarator.
1819	LambdaExprParameter, // Lambda-expression parameter declarator.
1820	ConversionId, // C++ conversion-type-id.
1821	TrailingReturn, // C++11 trailing-type-specifier.
1822	TrailingReturnVar, // C++11 trailing-type-specifier for variable.
1823	TemplateArg, // Any template argument (in template argument list).
1824	TemplateTypeArg, // Template type argument (in default argument).
1825	AliasDecl, // C++11 alias-declaration.
1826	AliasTemplate, // C++11 alias-declaration template.
1827	RequiresExpr, // C++2a requires-expression.
1828	Association // C11 _Generic selection expression association.
1829	};
1830
1831	// Describes whether the current context is a context where an implicit
1832	// typename is allowed (C++2a [temp.res]p5]).
1833	enum class ImplicitTypenameContext {
1834	No,
1835	Yes,
1836	};
1837
1838	/// Information about one declarator, including the parsed type
1839	/// information and the identifier.
1840	///
1841	/// When the declarator is fully formed, this is turned into the appropriate
1842	/// Decl object.
1843	///
1844	/// Declarators come in two types: normal declarators and abstract declarators.
1845	/// Abstract declarators are used when parsing types, and don't have an
1846	/// identifier. Normal declarators do have ID's.
1847	///
1848	/// Instances of this class should be a transient object that lives on the
1849	/// stack, not objects that are allocated in large quantities on the heap.
1850	class Declarator {
1851
1852	private:
1853	const DeclSpec &DS;
1854	CXXScopeSpec SS;
1855	UnqualifiedId Name;
1856	SourceRange Range;
1857
1858	/// Where we are parsing this declarator.
1859	DeclaratorContext Context;
1860
1861	/// The C++17 structured binding, if any. This is an alternative to a Name.
1862	DecompositionDeclarator BindingGroup;
1863
1864	/// DeclTypeInfo - This holds each type that the declarator includes as it is
1865	/// parsed. This is pushed from the identifier out, which means that element
1866	/// #0 will be the most closely bound to the identifier, and
1867	/// DeclTypeInfo.back() will be the least closely bound.
1868	SmallVector<DeclaratorChunk, 8> DeclTypeInfo;
1869
1870	/// InvalidType - Set by Sema::GetTypeForDeclarator().
1871	unsigned InvalidType : 1;
1872
1873	/// GroupingParens - Set by Parser::ParseParenDeclarator().
1874	unsigned GroupingParens : 1;
1875
1876	/// FunctionDefinition - Is this Declarator for a function or member
1877	/// definition and, if so, what kind?
1878	///
1879	/// Actually a FunctionDefinitionKind.
1880	unsigned FunctionDefinition : 2;
1881
1882	/// Is this Declarator a redeclaration?
1883	unsigned Redeclaration : 1;
1884
1885	/// true if the declaration is preceded by \c __extension__.
1886	unsigned Extension : 1;
1887
1888	/// Indicates whether this is an Objective-C instance variable.
1889	unsigned ObjCIvar : 1;
1890
1891	/// Indicates whether this is an Objective-C 'weak' property.
1892	unsigned ObjCWeakProperty : 1;
1893
1894	/// Indicates whether the InlineParams / InlineBindings storage has been used.
1895	unsigned InlineStorageUsed : 1;
1896
1897	/// Indicates whether this declarator has an initializer.
1898	unsigned HasInitializer : 1;
1899
1900	/// Attributes attached to the declarator.
1901	ParsedAttributes Attrs;
1902
1903	/// Attributes attached to the declaration. See also documentation for the
1904	/// corresponding constructor parameter.
1905	const ParsedAttributesView &DeclarationAttrs;
1906
1907	/// The asm label, if specified.
1908	Expr *AsmLabel;
1909
1910	/// \brief The constraint-expression specified by the trailing
1911	/// requires-clause, or null if no such clause was specified.
1912	Expr *TrailingRequiresClause;
1913
1914	/// If this declarator declares a template, its template parameter lists.
1915	ArrayRef<TemplateParameterList *> TemplateParameterLists;
1916
1917	/// If the declarator declares an abbreviated function template, the innermost
1918	/// template parameter list containing the invented and explicit template
1919	/// parameters (if any).
1920	TemplateParameterList *InventedTemplateParameterList;
1921
1922	#ifndef _MSC_VER
1923	union {
1924	#endif
1925	/// InlineParams - This is a local array used for the first function decl
1926	/// chunk to avoid going to the heap for the common case when we have one
1927	/// function chunk in the declarator.
1928	DeclaratorChunk::ParamInfo InlineParams[16];
1929	DecompositionDeclarator::Binding InlineBindings[16];
1930	#ifndef _MSC_VER
1931	};
1932	#endif
1933
1934	/// If this is the second or subsequent declarator in this declaration,
1935	/// the location of the comma before this declarator.
1936	SourceLocation CommaLoc;
1937
1938	/// If provided, the source location of the ellipsis used to describe
1939	/// this declarator as a parameter pack.
1940	SourceLocation EllipsisLoc;
1941
1942	friend struct DeclaratorChunk;
1943
1944	public:
1945	/// `DS` and `DeclarationAttrs` must outlive the `Declarator`. In particular,
1946	/// take care not to pass temporary objects for these parameters.
1947	///
1948	/// `DeclarationAttrs` contains [[]] attributes from the
1949	/// attribute-specifier-seq at the beginning of a declaration, which appertain
1950	/// to the declared entity itself. Attributes with other syntax (e.g. GNU)
1951	/// should not be placed in this attribute list; if they occur at the
1952	/// beginning of a declaration, they apply to the `DeclSpec` and should be
1953	/// attached to that instead.
1954	///
1955	/// Here is an example of an attribute associated with a declaration:
1956	///
1957	/// [[deprecated]] int x, y;
1958	///
1959	/// This attribute appertains to all of the entities declared in the
1960	/// declaration, i.e. `x` and `y` in this case.
1961	Declarator(const DeclSpec &DS, const ParsedAttributesView &DeclarationAttrs,
1962	DeclaratorContext C)
1963	: DS(DS), Range(DS.getSourceRange()), Context(C),
1964	InvalidType(DS.getTypeSpecType() == DeclSpec::TST_error),
1965	GroupingParens(false), FunctionDefinition(static_cast<unsigned>(
1966	FunctionDefinitionKind::Declaration)),
1967	Redeclaration(false), Extension(false), ObjCIvar(false),
1968	ObjCWeakProperty(false), InlineStorageUsed(false),
1969	HasInitializer(false), Attrs(DS.getAttributePool().getFactory()),
1970	DeclarationAttrs(DeclarationAttrs), AsmLabel(nullptr),
1971	TrailingRequiresClause(nullptr),
1972	InventedTemplateParameterList(nullptr) {
1973	assert(llvm::all_of(DeclarationAttrs,(static_cast <bool> (llvm::all_of(DeclarationAttrs, []( const ParsedAttr &AL) { return AL.isStandardAttributeSyntax (); }) && "DeclarationAttrs may only contain [[]] attributes" ) ? void (0) : __assert_fail ("llvm::all_of(DeclarationAttrs, [](const ParsedAttr &AL) { return AL.isStandardAttributeSyntax(); }) && \"DeclarationAttrs may only contain [[]] attributes\"" , "clang/include/clang/Sema/DeclSpec.h", 1977, __extension__ __PRETTY_FUNCTION__ ))
1974	[](const ParsedAttr &AL) {(static_cast <bool> (llvm::all_of(DeclarationAttrs, []( const ParsedAttr &AL) { return AL.isStandardAttributeSyntax (); }) && "DeclarationAttrs may only contain [[]] attributes" ) ? void (0) : __assert_fail ("llvm::all_of(DeclarationAttrs, [](const ParsedAttr &AL) { return AL.isStandardAttributeSyntax(); }) && \"DeclarationAttrs may only contain [[]] attributes\"" , "clang/include/clang/Sema/DeclSpec.h", 1977, __extension__ __PRETTY_FUNCTION__ ))
1975	return AL.isStandardAttributeSyntax();(static_cast <bool> (llvm::all_of(DeclarationAttrs, []( const ParsedAttr &AL) { return AL.isStandardAttributeSyntax (); }) && "DeclarationAttrs may only contain [[]] attributes" ) ? void (0) : __assert_fail ("llvm::all_of(DeclarationAttrs, [](const ParsedAttr &AL) { return AL.isStandardAttributeSyntax(); }) && \"DeclarationAttrs may only contain [[]] attributes\"" , "clang/include/clang/Sema/DeclSpec.h", 1977, __extension__ __PRETTY_FUNCTION__ ))
1976	}) &&(static_cast <bool> (llvm::all_of(DeclarationAttrs, []( const ParsedAttr &AL) { return AL.isStandardAttributeSyntax (); }) && "DeclarationAttrs may only contain [[]] attributes" ) ? void (0) : __assert_fail ("llvm::all_of(DeclarationAttrs, [](const ParsedAttr &AL) { return AL.isStandardAttributeSyntax(); }) && \"DeclarationAttrs may only contain [[]] attributes\"" , "clang/include/clang/Sema/DeclSpec.h", 1977, __extension__ __PRETTY_FUNCTION__ ))
1977	"DeclarationAttrs may only contain [[]] attributes")(static_cast <bool> (llvm::all_of(DeclarationAttrs, []( const ParsedAttr &AL) { return AL.isStandardAttributeSyntax (); }) && "DeclarationAttrs may only contain [[]] attributes" ) ? void (0) : __assert_fail ("llvm::all_of(DeclarationAttrs, [](const ParsedAttr &AL) { return AL.isStandardAttributeSyntax(); }) && \"DeclarationAttrs may only contain [[]] attributes\"" , "clang/include/clang/Sema/DeclSpec.h", 1977, __extension__ __PRETTY_FUNCTION__ ));
1978	}
1979
1980	~Declarator() {
1981	clear();
1982	}
1983	/// getDeclSpec - Return the declaration-specifier that this declarator was
1984	/// declared with.
1985	const DeclSpec &getDeclSpec() const { return DS; }
1986
1987	/// getMutableDeclSpec - Return a non-const version of the DeclSpec. This
1988	/// should be used with extreme care: declspecs can often be shared between
1989	/// multiple declarators, so mutating the DeclSpec affects all of the
1990	/// Declarators. This should only be done when the declspec is known to not
1991	/// be shared or when in error recovery etc.
1992	DeclSpec &getMutableDeclSpec() { return const_cast<DeclSpec &>(DS); }
1993
1994	AttributePool &getAttributePool() const {
1995	return Attrs.getPool();
1996	}
1997
1998	/// getCXXScopeSpec - Return the C++ scope specifier (global scope or
1999	/// nested-name-specifier) that is part of the declarator-id.
2000	const CXXScopeSpec &getCXXScopeSpec() const { return SS; }
2001	CXXScopeSpec &getCXXScopeSpec() { return SS; }
2002
2003	/// Retrieve the name specified by this declarator.
2004	UnqualifiedId &getName() { return Name; }
2005
2006	const DecompositionDeclarator &getDecompositionDeclarator() const {
2007	return BindingGroup;
2008	}
2009
2010	DeclaratorContext getContext() const { return Context; }
2011
2012	bool isPrototypeContext() const {
2013	return (Context == DeclaratorContext::Prototype \|\|
2014	Context == DeclaratorContext::ObjCParameter \|\|
2015	Context == DeclaratorContext::ObjCResult \|\|
2016	Context == DeclaratorContext::LambdaExprParameter);
2017	}
2018
2019	/// Get the source range that spans this declarator.
2020	SourceRange getSourceRange() const LLVM_READONLY__attribute__((__pure__)) { return Range; }
2021	SourceLocation getBeginLoc() const LLVM_READONLY__attribute__((__pure__)) { return Range.getBegin(); }
2022	SourceLocation getEndLoc() const LLVM_READONLY__attribute__((__pure__)) { return Range.getEnd(); }
2023
2024	void SetSourceRange(SourceRange R) { Range = R; }
2025	/// SetRangeBegin - Set the start of the source range to Loc, unless it's
2026	/// invalid.
2027	void SetRangeBegin(SourceLocation Loc) {
2028	if (!Loc.isInvalid())
2029	Range.setBegin(Loc);
2030	}
2031	/// SetRangeEnd - Set the end of the source range to Loc, unless it's invalid.
2032	void SetRangeEnd(SourceLocation Loc) {
2033	if (!Loc.isInvalid())
2034	Range.setEnd(Loc);
2035	}
2036	/// ExtendWithDeclSpec - Extend the declarator source range to include the
2037	/// given declspec, unless its location is invalid. Adopts the range start if
2038	/// the current range start is invalid.
2039	void ExtendWithDeclSpec(const DeclSpec &DS) {
2040	SourceRange SR = DS.getSourceRange();
2041	if (Range.getBegin().isInvalid())
2042	Range.setBegin(SR.getBegin());
2043	if (!SR.getEnd().isInvalid())
2044	Range.setEnd(SR.getEnd());
2045	}
2046
2047	/// Reset the contents of this Declarator.
2048	void clear() {
2049	SS.clear();
2050	Name.clear();
2051	Range = DS.getSourceRange();
2052	BindingGroup.clear();
2053
2054	for (unsigned i = 0, e = DeclTypeInfo.size(); i != e; ++i)
2055	DeclTypeInfo[i].destroy();
2056	DeclTypeInfo.clear();
2057	Attrs.clear();
2058	AsmLabel = nullptr;
2059	InlineStorageUsed = false;
2060	HasInitializer = false;
2061	ObjCIvar = false;
2062	ObjCWeakProperty = false;
2063	CommaLoc = SourceLocation();
2064	EllipsisLoc = SourceLocation();
2065	}
2066
2067	/// mayOmitIdentifier - Return true if the identifier is either optional or
2068	/// not allowed. This is true for typenames, prototypes, and template
2069	/// parameter lists.
2070	bool mayOmitIdentifier() const {
2071	switch (Context) {
2072	case DeclaratorContext::File:
2073	case DeclaratorContext::KNRTypeList:
2074	case DeclaratorContext::Member:
2075	case DeclaratorContext::Block:
2076	case DeclaratorContext::ForInit:
2077	case DeclaratorContext::SelectionInit:
2078	case DeclaratorContext::Condition:
2079	return false;
2080
2081	case DeclaratorContext::TypeName:
2082	case DeclaratorContext::FunctionalCast:
2083	case DeclaratorContext::AliasDecl:
2084	case DeclaratorContext::AliasTemplate:
2085	case DeclaratorContext::Prototype:
2086	case DeclaratorContext::LambdaExprParameter:
2087	case DeclaratorContext::ObjCParameter:
2088	case DeclaratorContext::ObjCResult:
2089	case DeclaratorContext::TemplateParam:
2090	case DeclaratorContext::CXXNew:
2091	case DeclaratorContext::CXXCatch:
2092	case DeclaratorContext::ObjCCatch:
2093	case DeclaratorContext::BlockLiteral:
2094	case DeclaratorContext::LambdaExpr:
2095	case DeclaratorContext::ConversionId:
2096	case DeclaratorContext::TemplateArg:
2097	case DeclaratorContext::TemplateTypeArg:
2098	case DeclaratorContext::TrailingReturn:
2099	case DeclaratorContext::TrailingReturnVar:
2100	case DeclaratorContext::RequiresExpr:
2101	case DeclaratorContext::Association:
2102	return true;
2103	}
2104	llvm_unreachable("unknown context kind!")::llvm::llvm_unreachable_internal("unknown context kind!", "clang/include/clang/Sema/DeclSpec.h" , 2104);
2105	}
2106
2107	/// mayHaveIdentifier - Return true if the identifier is either optional or
2108	/// required. This is true for normal declarators and prototypes, but not
2109	/// typenames.
2110	bool mayHaveIdentifier() const {
2111	switch (Context) {
2112	case DeclaratorContext::File:
2113	case DeclaratorContext::KNRTypeList:
2114	case DeclaratorContext::Member:
2115	case DeclaratorContext::Block:
2116	case DeclaratorContext::ForInit:
2117	case DeclaratorContext::SelectionInit:
2118	case DeclaratorContext::Condition:
2119	case DeclaratorContext::Prototype:
2120	case DeclaratorContext::LambdaExprParameter:
2121	case DeclaratorContext::TemplateParam:
2122	case DeclaratorContext::CXXCatch:
2123	case DeclaratorContext::ObjCCatch:
2124	case DeclaratorContext::RequiresExpr:
2125	return true;
2126
2127	case DeclaratorContext::TypeName:
2128	case DeclaratorContext::FunctionalCast:
2129	case DeclaratorContext::CXXNew:
2130	case DeclaratorContext::AliasDecl:
2131	case DeclaratorContext::AliasTemplate:
2132	case DeclaratorContext::ObjCParameter:
2133	case DeclaratorContext::ObjCResult:
2134	case DeclaratorContext::BlockLiteral:
2135	case DeclaratorContext::LambdaExpr:
2136	case DeclaratorContext::ConversionId:
2137	case DeclaratorContext::TemplateArg:
2138	case DeclaratorContext::TemplateTypeArg:
2139	case DeclaratorContext::TrailingReturn:
2140	case DeclaratorContext::TrailingReturnVar:
2141	case DeclaratorContext::Association:
2142	return false;
2143	}
2144	llvm_unreachable("unknown context kind!")::llvm::llvm_unreachable_internal("unknown context kind!", "clang/include/clang/Sema/DeclSpec.h" , 2144);
2145	}
2146
2147	/// Return true if the context permits a C++17 decomposition declarator.
2148	bool mayHaveDecompositionDeclarator() const {
2149	switch (Context) {
2150	case DeclaratorContext::File:
2151	// FIXME: It's not clear that the proposal meant to allow file-scope
2152	// structured bindings, but it does.
2153	case DeclaratorContext::Block:
2154	case DeclaratorContext::ForInit:
2155	case DeclaratorContext::SelectionInit:
2156	case DeclaratorContext::Condition:
2157	return true;
2158
2159	case DeclaratorContext::Member:
2160	case DeclaratorContext::Prototype:
2161	case DeclaratorContext::TemplateParam:
2162	case DeclaratorContext::RequiresExpr:
2163	// Maybe one day...
2164	return false;
2165
2166	// These contexts don't allow any kind of non-abstract declarator.
2167	case DeclaratorContext::KNRTypeList:
2168	case DeclaratorContext::TypeName:
2169	case DeclaratorContext::FunctionalCast:
2170	case DeclaratorContext::AliasDecl:
2171	case DeclaratorContext::AliasTemplate:
2172	case DeclaratorContext::LambdaExprParameter:
2173	case DeclaratorContext::ObjCParameter:
2174	case DeclaratorContext::ObjCResult:
2175	case DeclaratorContext::CXXNew:
2176	case DeclaratorContext::CXXCatch:
2177	case DeclaratorContext::ObjCCatch:
2178	case DeclaratorContext::BlockLiteral:
2179	case DeclaratorContext::LambdaExpr:
2180	case DeclaratorContext::ConversionId:
2181	case DeclaratorContext::TemplateArg:
2182	case DeclaratorContext::TemplateTypeArg:
2183	case DeclaratorContext::TrailingReturn:
2184	case DeclaratorContext::TrailingReturnVar:
2185	case DeclaratorContext::Association:
2186	return false;
2187	}
2188	llvm_unreachable("unknown context kind!")::llvm::llvm_unreachable_internal("unknown context kind!", "clang/include/clang/Sema/DeclSpec.h" , 2188);
2189	}
2190
2191	/// mayBeFollowedByCXXDirectInit - Return true if the declarator can be
2192	/// followed by a C++ direct initializer, e.g. "int x(1);".
2193	bool mayBeFollowedByCXXDirectInit() const {
2194	if (hasGroupingParens()) return false;
2195
2196	if (getDeclSpec().getStorageClassSpec() == DeclSpec::SCS_typedef)
2197	return false;
2198
2199	if (getDeclSpec().getStorageClassSpec() == DeclSpec::SCS_extern &&
2200	Context != DeclaratorContext::File)
2201	return false;
2202
2203	// Special names can't have direct initializers.
2204	if (Name.getKind() != UnqualifiedIdKind::IK_Identifier)
2205	return false;
2206
2207	switch (Context) {
2208	case DeclaratorContext::File:
2209	case DeclaratorContext::Block:
2210	case DeclaratorContext::ForInit:
2211	case DeclaratorContext::SelectionInit:
2212	case DeclaratorContext::TrailingReturnVar:
2213	return true;
2214
2215	case DeclaratorContext::Condition:
2216	// This may not be followed by a direct initializer, but it can't be a
2217	// function declaration either, and we'd prefer to perform a tentative
2218	// parse in order to produce the right diagnostic.
2219	return true;
2220
2221	case DeclaratorContext::KNRTypeList:
2222	case DeclaratorContext::Member:
2223	case DeclaratorContext::Prototype:
2224	case DeclaratorContext::LambdaExprParameter:
2225	case DeclaratorContext::ObjCParameter:
2226	case DeclaratorContext::ObjCResult:
2227	case DeclaratorContext::TemplateParam:
2228	case DeclaratorContext::CXXCatch:
2229	case DeclaratorContext::ObjCCatch:
2230	case DeclaratorContext::TypeName:
2231	case DeclaratorContext::FunctionalCast: // FIXME
2232	case DeclaratorContext::CXXNew:
2233	case DeclaratorContext::AliasDecl:
2234	case DeclaratorContext::AliasTemplate:
2235	case DeclaratorContext::BlockLiteral:
2236	case DeclaratorContext::LambdaExpr:
2237	case DeclaratorContext::ConversionId:
2238	case DeclaratorContext::TemplateArg:
2239	case DeclaratorContext::TemplateTypeArg:
2240	case DeclaratorContext::TrailingReturn:
2241	case DeclaratorContext::RequiresExpr:
2242	case DeclaratorContext::Association:
2243	return false;
2244	}
2245	llvm_unreachable("unknown context kind!")::llvm::llvm_unreachable_internal("unknown context kind!", "clang/include/clang/Sema/DeclSpec.h" , 2245);
2246	}
2247
2248	/// isPastIdentifier - Return true if we have parsed beyond the point where
2249	/// the name would appear. (This may happen even if we haven't actually parsed
2250	/// a name, perhaps because this context doesn't require one.)
2251	bool isPastIdentifier() const { return Name.isValid(); }
2252
2253	/// hasName - Whether this declarator has a name, which might be an
2254	/// identifier (accessible via getIdentifier()) or some kind of
2255	/// special C++ name (constructor, destructor, etc.), or a structured
2256	/// binding (which is not exactly a name, but occupies the same position).
2257	bool hasName() const {
2258	return Name.getKind() != UnqualifiedIdKind::IK_Identifier \|\|
2259	Name.Identifier \|\| isDecompositionDeclarator();
2260	}
2261
2262	/// Return whether this declarator is a decomposition declarator.
2263	bool isDecompositionDeclarator() const {
2264	return BindingGroup.isSet();
2265	}
2266
2267	IdentifierInfo *getIdentifier() const {
2268	if (Name.getKind() == UnqualifiedIdKind::IK_Identifier)
2269	return Name.Identifier;
2270
2271	return nullptr;
2272	}
2273	SourceLocation getIdentifierLoc() const { return Name.StartLocation; }
2274
2275	/// Set the name of this declarator to be the given identifier.
2276	void SetIdentifier(IdentifierInfo *Id, SourceLocation IdLoc) {
2277	Name.setIdentifier(Id, IdLoc);
2278	}
2279
2280	/// Set the decomposition bindings for this declarator.
2281	void
2282	setDecompositionBindings(SourceLocation LSquareLoc,
2283	ArrayRef<DecompositionDeclarator::Binding> Bindings,
2284	SourceLocation RSquareLoc);
2285
2286	/// AddTypeInfo - Add a chunk to this declarator. Also extend the range to
2287	/// EndLoc, which should be the last token of the chunk.
2288	/// This function takes attrs by R-Value reference because it takes ownership
2289	/// of those attributes from the parameter.
2290	void AddTypeInfo(const DeclaratorChunk &TI, ParsedAttributes &&attrs,
2291	SourceLocation EndLoc) {
2292	DeclTypeInfo.push_back(TI);
2293	DeclTypeInfo.back().getAttrs().addAll(attrs.begin(), attrs.end());
2294	getAttributePool().takeAllFrom(attrs.getPool());
2295
2296	if (!EndLoc.isInvalid())
2297	SetRangeEnd(EndLoc);
2298	}
2299
2300	/// AddTypeInfo - Add a chunk to this declarator. Also extend the range to
2301	/// EndLoc, which should be the last token of the chunk.
2302	void AddTypeInfo(const DeclaratorChunk &TI, SourceLocation EndLoc) {
2303	DeclTypeInfo.push_back(TI);
2304
2305	if (!EndLoc.isInvalid())
2306	SetRangeEnd(EndLoc);
2307	}
2308
2309	/// Add a new innermost chunk to this declarator.
2310	void AddInnermostTypeInfo(const DeclaratorChunk &TI) {
2311	DeclTypeInfo.insert(DeclTypeInfo.begin(), TI);
2312	}
2313
2314	/// Return the number of types applied to this declarator.
2315	unsigned getNumTypeObjects() const { return DeclTypeInfo.size(); }
2316
2317	/// Return the specified TypeInfo from this declarator. TypeInfo #0 is
2318	/// closest to the identifier.
2319	const DeclaratorChunk &getTypeObject(unsigned i) const {
2320	assert(i < DeclTypeInfo.size() && "Invalid type chunk")(static_cast <bool> (i < DeclTypeInfo.size() && "Invalid type chunk") ? void (0) : __assert_fail ("i < DeclTypeInfo.size() && \"Invalid type chunk\"" , "clang/include/clang/Sema/DeclSpec.h", 2320, __extension__ __PRETTY_FUNCTION__ ));
2321	return DeclTypeInfo[i];
2322	}
2323	DeclaratorChunk &getTypeObject(unsigned i) {
2324	assert(i < DeclTypeInfo.size() && "Invalid type chunk")(static_cast <bool> (i < DeclTypeInfo.size() && "Invalid type chunk") ? void (0) : __assert_fail ("i < DeclTypeInfo.size() && \"Invalid type chunk\"" , "clang/include/clang/Sema/DeclSpec.h", 2324, __extension__ __PRETTY_FUNCTION__ ));
2325	return DeclTypeInfo[i];
2326	}
2327
2328	typedef SmallVectorImpl<DeclaratorChunk>::const_iterator type_object_iterator;
2329	typedef llvm::iterator_range<type_object_iterator> type_object_range;
2330
2331	/// Returns the range of type objects, from the identifier outwards.
2332	type_object_range type_objects() const {
2333	return type_object_range(DeclTypeInfo.begin(), DeclTypeInfo.end());
2334	}
2335
2336	void DropFirstTypeObject() {
2337	assert(!DeclTypeInfo.empty() && "No type chunks to drop.")(static_cast <bool> (!DeclTypeInfo.empty() && "No type chunks to drop." ) ? void (0) : __assert_fail ("!DeclTypeInfo.empty() && \"No type chunks to drop.\"" , "clang/include/clang/Sema/DeclSpec.h", 2337, __extension__ __PRETTY_FUNCTION__ ));
2338	DeclTypeInfo.front().destroy();
2339	DeclTypeInfo.erase(DeclTypeInfo.begin());
2340	}
2341
2342	/// Return the innermost (closest to the declarator) chunk of this
2343	/// declarator that is not a parens chunk, or null if there are no
2344	/// non-parens chunks.
2345	const DeclaratorChunk *getInnermostNonParenChunk() const {
2346	for (unsigned i = 0, i_end = DeclTypeInfo.size(); i < i_end; ++i) {
2347	if (!DeclTypeInfo[i].isParen())
2348	return &DeclTypeInfo[i];
2349	}
2350	return nullptr;
2351	}
2352
2353	/// Return the outermost (furthest from the declarator) chunk of
2354	/// this declarator that is not a parens chunk, or null if there are
2355	/// no non-parens chunks.
2356	const DeclaratorChunk *getOutermostNonParenChunk() const {
2357	for (unsigned i = DeclTypeInfo.size(), i_end = 0; i != i_end; --i) {
2358	if (!DeclTypeInfo[i-1].isParen())
2359	return &DeclTypeInfo[i-1];
2360	}
2361	return nullptr;
2362	}
2363
2364	/// isArrayOfUnknownBound - This method returns true if the declarator
2365	/// is a declarator for an array of unknown bound (looking through
2366	/// parentheses).
2367	bool isArrayOfUnknownBound() const {
2368	const DeclaratorChunk *chunk = getInnermostNonParenChunk();
2369	return (chunk && chunk->Kind == DeclaratorChunk::Array &&
2370	!chunk->Arr.NumElts);
2371	}
2372
2373	/// isFunctionDeclarator - This method returns true if the declarator
2374	/// is a function declarator (looking through parentheses).
2375	/// If true is returned, then the reference type parameter idx is
2376	/// assigned with the index of the declaration chunk.
2377	bool isFunctionDeclarator(unsigned& idx) const {
2378	for (unsigned i = 0, i_end = DeclTypeInfo.size(); i < i_end; ++i) {
2379	switch (DeclTypeInfo[i].Kind) {
2380	case DeclaratorChunk::Function:
2381	idx = i;
2382	return true;
2383	case DeclaratorChunk::Paren:
2384	continue;
2385	case DeclaratorChunk::Pointer:
2386	case DeclaratorChunk::Reference:
2387	case DeclaratorChunk::Array:
2388	case DeclaratorChunk::BlockPointer:
2389	case DeclaratorChunk::MemberPointer:
2390	case DeclaratorChunk::Pipe:
2391	return false;
2392	}
2393	llvm_unreachable("Invalid type chunk")::llvm::llvm_unreachable_internal("Invalid type chunk", "clang/include/clang/Sema/DeclSpec.h" , 2393);
2394	}
2395	return false;
2396	}
2397
2398	/// isFunctionDeclarator - Once this declarator is fully parsed and formed,
2399	/// this method returns true if the identifier is a function declarator
2400	/// (looking through parentheses).
2401	bool isFunctionDeclarator() const {
2402	unsigned index;
2403	return isFunctionDeclarator(index);
2404	}
2405
2406	/// getFunctionTypeInfo - Retrieves the function type info object
2407	/// (looking through parentheses).
2408	DeclaratorChunk::FunctionTypeInfo &getFunctionTypeInfo() {
2409	assert(isFunctionDeclarator() && "Not a function declarator!")(static_cast <bool> (isFunctionDeclarator() && "Not a function declarator!" ) ? void (0) : __assert_fail ("isFunctionDeclarator() && \"Not a function declarator!\"" , "clang/include/clang/Sema/DeclSpec.h", 2409, __extension__ __PRETTY_FUNCTION__ ));
2410	unsigned index = 0;
2411	isFunctionDeclarator(index);
2412	return DeclTypeInfo[index].Fun;
2413	}
2414
2415	/// getFunctionTypeInfo - Retrieves the function type info object
2416	/// (looking through parentheses).
2417	const DeclaratorChunk::FunctionTypeInfo &getFunctionTypeInfo() const {
2418	return const_cast<Declarator*>(this)->getFunctionTypeInfo();
2419	}
2420
2421	/// Determine whether the declaration that will be produced from
2422	/// this declaration will be a function.
2423	///
2424	/// A declaration can declare a function even if the declarator itself
2425	/// isn't a function declarator, if the type specifier refers to a function
2426	/// type. This routine checks for both cases.
2427	bool isDeclarationOfFunction() const;
2428
2429	/// Return true if this declaration appears in a context where a
2430	/// function declarator would be a function declaration.
2431	bool isFunctionDeclarationContext() const {
2432	if (getDeclSpec().getStorageClassSpec() == DeclSpec::SCS_typedef)
2433	return false;
2434
2435	switch (Context) {
2436	case DeclaratorContext::File:
2437	case DeclaratorContext::Member:
2438	case DeclaratorContext::Block:
2439	case DeclaratorContext::ForInit:
2440	case DeclaratorContext::SelectionInit:
2441	return true;
2442
2443	case DeclaratorContext::Condition:
2444	case DeclaratorContext::KNRTypeList:
2445	case DeclaratorContext::TypeName:
2446	case DeclaratorContext::FunctionalCast:
2447	case DeclaratorContext::AliasDecl:
2448	case DeclaratorContext::AliasTemplate:
2449	case DeclaratorContext::Prototype:
2450	case DeclaratorContext::LambdaExprParameter:
2451	case DeclaratorContext::ObjCParameter:
2452	case DeclaratorContext::ObjCResult:
2453	case DeclaratorContext::TemplateParam:
2454	case DeclaratorContext::CXXNew:
2455	case DeclaratorContext::CXXCatch:
2456	case DeclaratorContext::ObjCCatch:
2457	case DeclaratorContext::BlockLiteral:
2458	case DeclaratorContext::LambdaExpr:
2459	case DeclaratorContext::ConversionId:
2460	case DeclaratorContext::TemplateArg:
2461	case DeclaratorContext::TemplateTypeArg:
2462	case DeclaratorContext::TrailingReturn:
2463	case DeclaratorContext::TrailingReturnVar:
2464	case DeclaratorContext::RequiresExpr:
2465	case DeclaratorContext::Association:
2466	return false;
2467	}
2468	llvm_unreachable("unknown context kind!")::llvm::llvm_unreachable_internal("unknown context kind!", "clang/include/clang/Sema/DeclSpec.h" , 2468);
2469	}
2470
2471	/// Determine whether this declaration appears in a context where an
2472	/// expression could appear.
2473	bool isExpressionContext() const {
2474	switch (Context) {
2475	case DeclaratorContext::File:
2476	case DeclaratorContext::KNRTypeList:
2477	case DeclaratorContext::Member:
2478
2479	// FIXME: sizeof(...) permits an expression.
2480	case DeclaratorContext::TypeName:
2481
2482	case DeclaratorContext::FunctionalCast:
2483	case DeclaratorContext::AliasDecl:
2484	case DeclaratorContext::AliasTemplate:
2485	case DeclaratorContext::Prototype:
2486	case DeclaratorContext::LambdaExprParameter:
2487	case DeclaratorContext::ObjCParameter:
2488	case DeclaratorContext::ObjCResult:
2489	case DeclaratorContext::TemplateParam:
2490	case DeclaratorContext::CXXNew:
2491	case DeclaratorContext::CXXCatch:
2492	case DeclaratorContext::ObjCCatch:
2493	case DeclaratorContext::BlockLiteral:
2494	case DeclaratorContext::LambdaExpr:
2495	case DeclaratorContext::ConversionId:
2496	case DeclaratorContext::TrailingReturn:
2497	case DeclaratorContext::TrailingReturnVar:
2498	case DeclaratorContext::TemplateTypeArg:
2499	case DeclaratorContext::RequiresExpr:
2500	case DeclaratorContext::Association:
2501	return false;
2502
2503	case DeclaratorContext::Block:
2504	case DeclaratorContext::ForInit:
2505	case DeclaratorContext::SelectionInit:
2506	case DeclaratorContext::Condition:
2507	case DeclaratorContext::TemplateArg:
2508	return true;
2509	}
2510
2511	llvm_unreachable("unknown context kind!")::llvm::llvm_unreachable_internal("unknown context kind!", "clang/include/clang/Sema/DeclSpec.h" , 2511);
2512	}
2513
2514	/// Return true if a function declarator at this position would be a
2515	/// function declaration.
2516	bool isFunctionDeclaratorAFunctionDeclaration() const {
2517	if (!isFunctionDeclarationContext())
2518	return false;
2519
2520	for (unsigned I = 0, N = getNumTypeObjects(); I != N; ++I)
2521	if (getTypeObject(I).Kind != DeclaratorChunk::Paren)
2522	return false;
2523
2524	return true;
2525	}
2526
2527	/// Determine whether a trailing return type was written (at any
2528	/// level) within this declarator.
2529	bool hasTrailingReturnType() const {
2530	for (const auto &Chunk : type_objects())
2531	if (Chunk.Kind == DeclaratorChunk::Function &&
2532	Chunk.Fun.hasTrailingReturnType())
2533	return true;
2534	return false;
2535	}
2536	/// Get the trailing return type appearing (at any level) within this
2537	/// declarator.
2538	ParsedType getTrailingReturnType() const {
2539	for (const auto &Chunk : type_objects())
2540	if (Chunk.Kind == DeclaratorChunk::Function &&
2541	Chunk.Fun.hasTrailingReturnType())
2542	return Chunk.Fun.getTrailingReturnType();
2543	return ParsedType();
2544	}
2545
2546	/// \brief Sets a trailing requires clause for this declarator.
2547	void setTrailingRequiresClause(Expr *TRC) {
2548	TrailingRequiresClause = TRC;
2549
2550	SetRangeEnd(TRC->getEndLoc());
2551	}
2552
2553	/// \brief Sets a trailing requires clause for this declarator.
2554	Expr *getTrailingRequiresClause() {
2555	return TrailingRequiresClause;
2556	}
2557
2558	/// \brief Determine whether a trailing requires clause was written in this
2559	/// declarator.
2560	bool hasTrailingRequiresClause() const {
2561	return TrailingRequiresClause != nullptr;
2562	}
2563
2564	/// Sets the template parameter lists that preceded the declarator.
2565	void setTemplateParameterLists(ArrayRef<TemplateParameterList *> TPLs) {
2566	TemplateParameterLists = TPLs;
2567	}
2568
2569	/// The template parameter lists that preceded the declarator.
2570	ArrayRef<TemplateParameterList *> getTemplateParameterLists() const {
2571	return TemplateParameterLists;
2572	}
2573
2574	/// Sets the template parameter list generated from the explicit template
2575	/// parameters along with any invented template parameters from
2576	/// placeholder-typed parameters.
2577	void setInventedTemplateParameterList(TemplateParameterList *Invented) {
2578	InventedTemplateParameterList = Invented;
2579	}
2580
2581	/// The template parameter list generated from the explicit template
2582	/// parameters along with any invented template parameters from
2583	/// placeholder-typed parameters, if there were any such parameters.
2584	TemplateParameterList * getInventedTemplateParameterList() const {
2585	return InventedTemplateParameterList;
2586	}
2587
2588	/// takeAttributes - Takes attributes from the given parsed-attributes
2589	/// set and add them to this declarator.
2590	///
2591	/// These examples both add 3 attributes to "var":
2592	/// short int var __attribute__((aligned(16),common,deprecated));
2593	/// short int x, __attribute__((aligned(16)) var
2594	/// __attribute__((common,deprecated));
2595	///
2596	/// Also extends the range of the declarator.
2597	void takeAttributes(ParsedAttributes &attrs) {
2598	Attrs.takeAllFrom(attrs);
2599
2600	if (attrs.Range.getEnd().isValid())
2601	SetRangeEnd(attrs.Range.getEnd());
2602	}
2603
2604	const ParsedAttributes &getAttributes() const { return Attrs; }
2605	ParsedAttributes &getAttributes() { return Attrs; }
2606
2607	const ParsedAttributesView &getDeclarationAttributes() const {
2608	return DeclarationAttrs;
2609	}
2610
2611	/// hasAttributes - do we contain any attributes?
2612	bool hasAttributes() const {
2613	if (!getAttributes().empty() \|\| !getDeclarationAttributes().empty() \|\|
2614	getDeclSpec().hasAttributes())
2615	return true;
2616	for (unsigned i = 0, e = getNumTypeObjects(); i != e; ++i)
2617	if (!getTypeObject(i).getAttrs().empty())
2618	return true;
2619	return false;
2620	}
2621
2622	/// Return a source range list of C++11 attributes associated
2623	/// with the declarator.
2624	void getCXX11AttributeRanges(SmallVectorImpl<SourceRange> &Ranges) {
2625	for (const ParsedAttr &AL : Attrs)
2626	if (AL.isCXX11Attribute())
2627	Ranges.push_back(AL.getRange());
2628	}
2629
2630	void setAsmLabel(Expr *E) { AsmLabel = E; }
2631	Expr *getAsmLabel() const { return AsmLabel; }
2632
2633	void setExtension(bool Val = true) { Extension = Val; }
2634	bool getExtension() const { return Extension; }
2635
2636	void setObjCIvar(bool Val = true) { ObjCIvar = Val; }
2637	bool isObjCIvar() const { return ObjCIvar; }
2638
2639	void setObjCWeakProperty(bool Val = true) { ObjCWeakProperty = Val; }
2640	bool isObjCWeakProperty() const { return ObjCWeakProperty; }
2641
2642	void setInvalidType(bool Val = true) { InvalidType = Val; }
2643	bool isInvalidType() const {
2644	return InvalidType \|\| DS.getTypeSpecType() == DeclSpec::TST_error;
2645	}
2646
2647	void setGroupingParens(bool flag) { GroupingParens = flag; }
2648	bool hasGroupingParens() const { return GroupingParens; }
2649
2650	bool isFirstDeclarator() const { return !CommaLoc.isValid(); }
2651	SourceLocation getCommaLoc() const { return CommaLoc; }
2652	void setCommaLoc(SourceLocation CL) { CommaLoc = CL; }
2653
2654	bool hasEllipsis() const { return EllipsisLoc.isValid(); }
2655	SourceLocation getEllipsisLoc() const { return EllipsisLoc; }
2656	void setEllipsisLoc(SourceLocation EL) { EllipsisLoc = EL; }
2657
2658	void setFunctionDefinitionKind(FunctionDefinitionKind Val) {
2659	FunctionDefinition = static_cast<unsigned>(Val);
2660	}
2661
2662	bool isFunctionDefinition() const {
2663	return getFunctionDefinitionKind() != FunctionDefinitionKind::Declaration;
2664	}
2665
2666	FunctionDefinitionKind getFunctionDefinitionKind() const {
2667	return (FunctionDefinitionKind)FunctionDefinition;
2668	}
2669
2670	void setHasInitializer(bool Val = true) { HasInitializer = Val; }
2671	bool hasInitializer() const { return HasInitializer; }
2672
2673	/// Returns true if this declares a real member and not a friend.
2674	bool isFirstDeclarationOfMember() {
2675	return getContext() == DeclaratorContext::Member &&
2676	!getDeclSpec().isFriendSpecified();
2677	}
2678
2679	/// Returns true if this declares a static member. This cannot be called on a
2680	/// declarator outside of a MemberContext because we won't know until
2681	/// redeclaration time if the decl is static.
2682	bool isStaticMember();
2683
2684	/// Returns true if this declares a constructor or a destructor.
2685	bool isCtorOrDtor();
2686
2687	void setRedeclaration(bool Val) { Redeclaration = Val; }
2688	bool isRedeclaration() const { return Redeclaration; }
2689	};
2690
2691	/// This little struct is used to capture information about
2692	/// structure field declarators, which is basically just a bitfield size.
2693	struct FieldDeclarator {
2694	Declarator D;
2695	Expr *BitfieldSize;
2696	explicit FieldDeclarator(const DeclSpec &DS,
2697	const ParsedAttributes &DeclarationAttrs)
2698	: D(DS, DeclarationAttrs, DeclaratorContext::Member),
2699	BitfieldSize(nullptr) {}
2700	};
2701
2702	/// Represents a C++11 virt-specifier-seq.
2703	class VirtSpecifiers {
2704	public:
2705	enum Specifier {
2706	VS_None = 0,
2707	VS_Override = 1,
2708	VS_Final = 2,
2709	VS_Sealed = 4,
2710	// Represents the __final keyword, which is legal for gcc in pre-C++11 mode.
2711	VS_GNU_Final = 8,
2712	VS_Abstract = 16
2713	};
2714
2715	VirtSpecifiers() : Specifiers(0), LastSpecifier(VS_None) { }
2716
2717	bool SetSpecifier(Specifier VS, SourceLocation Loc,
2718	const char *&PrevSpec);
2719
2720	bool isUnset() const { return Specifiers == 0; }
2721
2722	bool isOverrideSpecified() const { return Specifiers & VS_Override; }
2723	SourceLocation getOverrideLoc() const { return VS_overrideLoc; }
2724
2725	bool isFinalSpecified() const { return Specifiers & (VS_Final \| VS_Sealed \| VS_GNU_Final); }
2726	bool isFinalSpelledSealed() const { return Specifiers & VS_Sealed; }
2727	SourceLocation getFinalLoc() const { return VS_finalLoc; }
2728	SourceLocation getAbstractLoc() const { return VS_abstractLoc; }
2729
2730	void clear() { Specifiers = 0; }
2731
2732	static const char *getSpecifierName(Specifier VS);
2733
2734	SourceLocation getFirstLocation() const { return FirstLocation; }
2735	SourceLocation getLastLocation() const { return LastLocation; }
2736	Specifier getLastSpecifier() const { return LastSpecifier; }
2737
2738	private:
2739	unsigned Specifiers;
2740	Specifier LastSpecifier;
2741
2742	SourceLocation VS_overrideLoc, VS_finalLoc, VS_abstractLoc;
2743	SourceLocation FirstLocation;
2744	SourceLocation LastLocation;
2745	};
2746
2747	enum class LambdaCaptureInitKind {
2748	NoInit, //!< [a]
2749	CopyInit, //!< [a = b], [a = {b}]
2750	DirectInit, //!< [a(b)]
2751	ListInit //!< [a{b}]
2752	};
2753
2754	/// Represents a complete lambda introducer.
2755	struct LambdaIntroducer {
2756	/// An individual capture in a lambda introducer.
2757	struct LambdaCapture {
2758	LambdaCaptureKind Kind;
2759	SourceLocation Loc;
2760	IdentifierInfo *Id;
2761	SourceLocation EllipsisLoc;
2762	LambdaCaptureInitKind InitKind;
2763	ExprResult Init;
2764	ParsedType InitCaptureType;
2765	SourceRange ExplicitRange;
2766
2767	LambdaCapture(LambdaCaptureKind Kind, SourceLocation Loc,
2768	IdentifierInfo *Id, SourceLocation EllipsisLoc,
2769	LambdaCaptureInitKind InitKind, ExprResult Init,
2770	ParsedType InitCaptureType,
2771	SourceRange ExplicitRange)
2772	: Kind(Kind), Loc(Loc), Id(Id), EllipsisLoc(EllipsisLoc),
2773	InitKind(InitKind), Init(Init), InitCaptureType(InitCaptureType),
2774	ExplicitRange(ExplicitRange) {}
2775	};
2776
2777	SourceRange Range;
2778	SourceLocation DefaultLoc;
2779	LambdaCaptureDefault Default;
2780	SmallVector<LambdaCapture, 4> Captures;
2781
2782	LambdaIntroducer()
2783	: Default(LCD_None) {}
2784
2785	bool hasLambdaCapture() const {
2786	return Captures.size() > 0 \|\| Default != LCD_None;
2787	}
2788
2789	/// Append a capture in a lambda introducer.
2790	void addCapture(LambdaCaptureKind Kind,
2791	SourceLocation Loc,
2792	IdentifierInfo* Id,
2793	SourceLocation EllipsisLoc,
2794	LambdaCaptureInitKind InitKind,
2795	ExprResult Init,
2796	ParsedType InitCaptureType,
2797	SourceRange ExplicitRange) {
2798	Captures.push_back(LambdaCapture(Kind, Loc, Id, EllipsisLoc, InitKind, Init,
2799	InitCaptureType, ExplicitRange));
2800	}
2801	};
2802
2803	struct InventedTemplateParameterInfo {
2804	/// The number of parameters in the template parameter list that were
2805	/// explicitly specified by the user, as opposed to being invented by use
2806	/// of an auto parameter.
2807	unsigned NumExplicitTemplateParams = 0;
2808
2809	/// If this is a generic lambda or abbreviated function template, use this
2810	/// as the depth of each 'auto' parameter, during initial AST construction.
2811	unsigned AutoTemplateParameterDepth = 0;
2812
2813	/// Store the list of the template parameters for a generic lambda or an
2814	/// abbreviated function template.
2815	/// If this is a generic lambda or abbreviated function template, this holds
2816	/// the explicit template parameters followed by the auto parameters
2817	/// converted into TemplateTypeParmDecls.
2818	/// It can be used to construct the generic lambda or abbreviated template's
2819	/// template parameter list during initial AST construction.
2820	SmallVector<NamedDecl*, 4> TemplateParams;
2821	};
2822
2823	} // end namespace clang
2824
2825	#endif // LLVM_CLANG_SEMA_DECLSPEC_H

←

/build/source/clang/include/clang/AST/NestedNameSpecifier.h

1//===- NestedNameSpecifier.h - C++ nested name specifiers -------*- 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//  This file defines the NestedNameSpecifier class, which represents
10//  a C++ nested-name-specifier.
11//
12//===----------------------------------------------------------------------===//

14#ifndef LLVM_CLANG_AST_NESTEDNAMESPECIFIER_H
15#define LLVM_CLANG_AST_NESTEDNAMESPECIFIER_H

17#include "clang/AST/DependenceFlags.h"
18#include "clang/Basic/Diagnostic.h"
19#include "clang/Basic/SourceLocation.h"
20#include "llvm/ADT/DenseMapInfo.h"
21#include "llvm/ADT/FoldingSet.h"
22#include "llvm/ADT/PointerIntPair.h"
23#include "llvm/Support/Compiler.h"
24#include <cstdint>
25#include <cstdlib>
26#include <utility>

28namespace clang {

30class ASTContext;
31class CXXRecordDecl;
32class IdentifierInfo;
33class LangOptions;
34class NamespaceAliasDecl;
35class NamespaceDecl;
36struct PrintingPolicy;
37class Type;
38class TypeLoc;

40/// Represents a C++ nested name specifier, such as
41/// "\::std::vector<int>::".
42///
43/// C++ nested name specifiers are the prefixes to qualified
44/// names. For example, "foo::" in "foo::x" is a nested name
45/// specifier. Nested name specifiers are made up of a sequence of
46/// specifiers, each of which can be a namespace, type, identifier
47/// (for dependent names), decltype specifier, or the global specifier ('::').
48/// The last two specifiers can only appear at the start of a
49/// nested-namespace-specifier.
50class NestedNameSpecifier : public llvm::FoldingSetNode {
/// Enumeration describing
enum StoredSpecifierKind {
  StoredIdentifier = 0,
  StoredDecl = 1,
  StoredTypeSpec = 2,
  StoredTypeSpecWithTemplate = 3
};

/// The nested name specifier that precedes this nested name
/// specifier.
///
/// The pointer is the nested-name-specifier that precedes this
/// one. The integer stores one of the first four values of type
/// SpecifierKind.
llvm::PointerIntPair<NestedNameSpecifier *, 2, StoredSpecifierKind> Prefix;

/// The last component in the nested name specifier, which
/// can be an identifier, a declaration, or a type.
///
/// When the pointer is NULL, this specifier represents the global
/// specifier '::'. Otherwise, the pointer is one of
/// IdentifierInfo*, Namespace*, or Type*, depending on the kind of
/// specifier as encoded within the prefix.
void* Specifier = nullptr;

76public:
/// The kind of specifier that completes this nested name
/// specifier.
enum SpecifierKind {
  /// An identifier, stored as an IdentifierInfo*.
  Identifier,

  /// A namespace, stored as a NamespaceDecl*.
  Namespace,

  /// A namespace alias, stored as a NamespaceAliasDecl*.
  NamespaceAlias,

  /// A type, stored as a Type*.
  TypeSpec,

  /// A type that was preceded by the 'template' keyword,
  /// stored as a Type*.
  TypeSpecWithTemplate,

  /// The global specifier '::'. There is no stored value.
  Global,

  /// Microsoft's '__super' specifier, stored as a CXXRecordDecl* of
  /// the class it appeared in.
  Super
};

104private:
/// Builds the global specifier.
NestedNameSpecifier() : Prefix(nullptr, StoredIdentifier) {}

/// Copy constructor used internally to clone nested name
/// specifiers.
NestedNameSpecifier(const NestedNameSpecifier &Other) = default;

/// Either find or insert the given nested name specifier
/// mockup in the given context.
static NestedNameSpecifier *FindOrInsert(const ASTContext &Context,
                                         const NestedNameSpecifier &Mockup);

117public:
NestedNameSpecifier &operator=(const NestedNameSpecifier &) = delete;

/// Builds a specifier combining a prefix and an identifier.
///
/// The prefix must be dependent, since nested name specifiers
/// referencing an identifier are only permitted when the identifier
/// cannot be resolved.
static NestedNameSpecifier *Create(const ASTContext &Context,
                                   NestedNameSpecifier *Prefix,
                                   IdentifierInfo *II);

/// Builds a nested name specifier that names a namespace.
static NestedNameSpecifier *Create(const ASTContext &Context,
                                   NestedNameSpecifier *Prefix,
                                   const NamespaceDecl *NS);

/// Builds a nested name specifier that names a namespace alias.
static NestedNameSpecifier *Create(const ASTContext &Context,
                                   NestedNameSpecifier *Prefix,
                                   NamespaceAliasDecl *Alias);

/// Builds a nested name specifier that names a type.
static NestedNameSpecifier *Create(const ASTContext &Context,
                                   NestedNameSpecifier *Prefix,
                                   bool Template, const Type *T);

/// Builds a specifier that consists of just an identifier.
///
/// The nested-name-specifier is assumed to be dependent, but has no
/// prefix because the prefix is implied by something outside of the
/// nested name specifier, e.g., in "x->Base::f", the "x" has a dependent
/// type.
static NestedNameSpecifier *Create(const ASTContext &Context,
                                   IdentifierInfo *II);

/// Returns the nested name specifier representing the global
/// scope.
static NestedNameSpecifier *GlobalSpecifier(const ASTContext &Context);

/// Returns the nested name specifier representing the __super scope
/// for the given CXXRecordDecl.
static NestedNameSpecifier *SuperSpecifier(const ASTContext &Context,
                                           CXXRecordDecl *RD);

/// Return the prefix of this nested name specifier.
///
/// The prefix contains all of the parts of the nested name
/// specifier that precede this current specifier. For example, for a
/// nested name specifier that represents "foo::bar::", the current
/// specifier will contain "bar::" and the prefix will contain
/// "foo::".
NestedNameSpecifier *getPrefix() const { return Prefix.getPointer(); }

/// Determine what kind of nested name specifier is stored.
SpecifierKind getKind() const;

/// Retrieve the identifier stored in this nested name
/// specifier.
IdentifierInfo *getAsIdentifier() const {
  if (Prefix.getInt() == StoredIdentifier)
    return (IdentifierInfo *)Specifier;

  return nullptr;
}

/// Retrieve the namespace stored in this nested name
/// specifier.
NamespaceDecl *getAsNamespace() const;

/// Retrieve the namespace alias stored in this nested name
/// specifier.
NamespaceAliasDecl *getAsNamespaceAlias() const;

/// Retrieve the record declaration stored in this nested name
/// specifier.
CXXRecordDecl *getAsRecordDecl() const;

/// Retrieve the type stored in this nested name specifier.
const Type *getAsType() const {
  if (Prefix.getInt() == StoredTypeSpec ||
      Prefix.getInt() == StoredTypeSpecWithTemplate)
    return (const Type *)Specifier;

  return nullptr;
}

NestedNameSpecifierDependence getDependence() const;

/// Whether this nested name specifier refers to a dependent
/// type or not.
bool isDependent() const;

/// Whether this nested name specifier involves a template
/// parameter.
bool isInstantiationDependent() const;

/// Whether this nested-name-specifier contains an unexpanded
/// parameter pack (for C++11 variadic templates).
bool containsUnexpandedParameterPack() const;

/// Whether this nested name specifier contains an error.
bool containsErrors() const;

/// Print this nested name specifier to the given output stream. If
/// `ResolveTemplateArguments` is true, we'll print actual types, e.g.
/// `ns::SomeTemplate<int, MyClass>` instead of
/// `ns::SomeTemplate<Container::value_type, T>`.
void print(raw_ostream &OS, const PrintingPolicy &Policy,
           bool ResolveTemplateArguments = false) const;

void Profile(llvm::FoldingSetNodeID &ID) const {
  ID.AddPointer(Prefix.getOpaqueValue());
  ID.AddPointer(Specifier);
}

/// Dump the nested name specifier to standard output to aid
/// in debugging.
void dump(const LangOptions &LO) const;
void dump() const;
void dump(llvm::raw_ostream &OS) const;
void dump(llvm::raw_ostream &OS, const LangOptions &LO) const;
239};

241/// A C++ nested-name-specifier augmented with source location
242/// information.
243class NestedNameSpecifierLoc {
NestedNameSpecifier *Qualifier = nullptr;
void *Data = nullptr;

/// Determines the data length for the last component in the
/// given nested-name-specifier.
static unsigned getLocalDataLength(NestedNameSpecifier *Qualifier);

/// Determines the data length for the entire
/// nested-name-specifier.
static unsigned getDataLength(NestedNameSpecifier *Qualifier);

255public:
/// Construct an empty nested-name-specifier.
NestedNameSpecifierLoc() = default;

/// Construct a nested-name-specifier with source location information
/// from
NestedNameSpecifierLoc(NestedNameSpecifier *Qualifier, void *Data)
    : Qualifier(Qualifier), Data(Data) {}

/// Evaluates true when this nested-name-specifier location is
/// non-empty.
explicit operator bool() const { return Qualifier; }

/// Evaluates true when this nested-name-specifier location is
/// empty.
bool hasQualifier() const { return Qualifier; }

/// Retrieve the nested-name-specifier to which this instance
/// refers.
NestedNameSpecifier *getNestedNameSpecifier() const {
  return Qualifier;
}

/// Retrieve the opaque pointer that refers to source-location data.
void *getOpaqueData() const { return Data; }

/// Retrieve the source range covering the entirety of this
/// nested-name-specifier.
///
/// For example, if this instance refers to a nested-name-specifier
/// \c \::std::vector<int>::, the returned source range would cover
/// from the initial '::' to the last '::'.
SourceRange getSourceRange() const LLVM_READONLY__attribute__((__pure__));

/// Retrieve the source range covering just the last part of
/// this nested-name-specifier, not including the prefix.
///
/// For example, if this instance refers to a nested-name-specifier
/// \c \::std::vector<int>::, the returned source range would cover
/// from "vector" to the last '::'.
SourceRange getLocalSourceRange() const;

/// Retrieve the location of the beginning of this
/// nested-name-specifier.
SourceLocation getBeginLoc() const {
  return getSourceRange().getBegin();
}

/// Retrieve the location of the end of this
/// nested-name-specifier.
SourceLocation getEndLoc() const {
  return getSourceRange().getEnd();
}

/// Retrieve the location of the beginning of this
/// component of the nested-name-specifier.
SourceLocation getLocalBeginLoc() const {
  return getLocalSourceRange().getBegin();
}

/// Retrieve the location of the end of this component of the
/// nested-name-specifier.
SourceLocation getLocalEndLoc() const {
  return getLocalSourceRange().getEnd();
}

/// Return the prefix of this nested-name-specifier.
///
/// For example, if this instance refers to a nested-name-specifier
/// \c \::std::vector<int>::, the prefix is \c \::std::. Note that the
/// returned prefix may be empty, if this is the first component of
/// the nested-name-specifier.
NestedNameSpecifierLoc getPrefix() const {
  if (!Qualifier)
    return *this;

  return NestedNameSpecifierLoc(Qualifier->getPrefix(), Data);
}

/// For a nested-name-specifier that refers to a type,
/// retrieve the type with source-location information.
TypeLoc getTypeLoc() const;

/// Determines the data length for the entire
/// nested-name-specifier.
unsigned getDataLength() const { return getDataLength(Qualifier); }

friend bool operator==(NestedNameSpecifierLoc X,
                       NestedNameSpecifierLoc Y) {
  return X.Qualifier == Y.Qualifier && X.Data == Y.Data;
}

friend bool operator!=(NestedNameSpecifierLoc X,
                       NestedNameSpecifierLoc Y) {
  return !(X == Y);
}
351};

353/// Class that aids in the construction of nested-name-specifiers along
354/// with source-location information for all of the components of the
355/// nested-name-specifier.
356class NestedNameSpecifierLocBuilder {
/// The current representation of the nested-name-specifier we're
/// building.
NestedNameSpecifier *Representation = nullptr;

/// Buffer used to store source-location information for the
/// nested-name-specifier.
///
/// Note that we explicitly manage the buffer (rather than using a
/// SmallVector) because \c Declarator expects it to be possible to memcpy()
/// a \c CXXScopeSpec, and CXXScopeSpec uses a NestedNameSpecifierLocBuilder.
char *Buffer = nullptr;

/// The size of the buffer used to store source-location information
/// for the nested-name-specifier.
unsigned BufferSize = 0;

/// The capacity of the buffer used to store source-location
/// information for the nested-name-specifier.
unsigned BufferCapacity = 0;

377public:
NestedNameSpecifierLocBuilder() = default;
NestedNameSpecifierLocBuilder(const NestedNameSpecifierLocBuilder &Other);

NestedNameSpecifierLocBuilder &
operator=(const NestedNameSpecifierLocBuilder &Other);

~NestedNameSpecifierLocBuilder() {
  if (BufferCapacity22.1
Field 'BufferCapacity' is not equal to 0
1
Field 'BufferCapacity' is not equal to 0
1
Field 'BufferCapacity' is not equal to 0
1
Field 'BufferCapacity' is not equal to 0
1
Field 'BufferCapacity' is not equal to 0
)
11
←
Assuming field 'BufferCapacity' is not equal to 0→
12
←
Taking true branch→
23
←
Taking true branch→
    free(Buffer);
13
←
Memory is released→
24
←
Attempt to free released memory
}

/// Retrieve the representation of the nested-name-specifier.
NestedNameSpecifier *getRepresentation() const { return Representation; }

/// Extend the current nested-name-specifier by another
/// nested-name-specifier component of the form 'type::'.
///
/// \param Context The AST context in which this nested-name-specifier
/// resides.
///
/// \param TemplateKWLoc The location of the 'template' keyword, if present.
///
/// \param TL The TypeLoc that describes the type preceding the '::'.
///
/// \param ColonColonLoc The location of the trailing '::'.
void Extend(ASTContext &Context, SourceLocation TemplateKWLoc, TypeLoc TL,
            SourceLocation ColonColonLoc);

/// Extend the current nested-name-specifier by another
/// nested-name-specifier component of the form 'identifier::'.
///
/// \param Context The AST context in which this nested-name-specifier
/// resides.
///
/// \param Identifier The identifier.
///
/// \param IdentifierLoc The location of the identifier.
///
/// \param ColonColonLoc The location of the trailing '::'.
void Extend(ASTContext &Context, IdentifierInfo *Identifier,
            SourceLocation IdentifierLoc, SourceLocation ColonColonLoc);

/// Extend the current nested-name-specifier by another
/// nested-name-specifier component of the form 'namespace::'.
///
/// \param Context The AST context in which this nested-name-specifier
/// resides.
///
/// \param Namespace The namespace.
///
/// \param NamespaceLoc The location of the namespace name.
///
/// \param ColonColonLoc The location of the trailing '::'.
void Extend(ASTContext &Context, NamespaceDecl *Namespace,
            SourceLocation NamespaceLoc, SourceLocation ColonColonLoc);

/// Extend the current nested-name-specifier by another
/// nested-name-specifier component of the form 'namespace-alias::'.
///
/// \param Context The AST context in which this nested-name-specifier
/// resides.
///
/// \param Alias The namespace alias.
///
/// \param AliasLoc The location of the namespace alias
/// name.
///
/// \param ColonColonLoc The location of the trailing '::'.
void Extend(ASTContext &Context, NamespaceAliasDecl *Alias,
            SourceLocation AliasLoc, SourceLocation ColonColonLoc);

/// Turn this (empty) nested-name-specifier into the global
/// nested-name-specifier '::'.
void MakeGlobal(ASTContext &Context, SourceLocation ColonColonLoc);

/// Turns this (empty) nested-name-specifier into '__super'
/// nested-name-specifier.
///
/// \param Context The AST context in which this nested-name-specifier
/// resides.
///
/// \param RD The declaration of the class in which nested-name-specifier
/// appeared.
///
/// \param SuperLoc The location of the '__super' keyword.
/// name.
///
/// \param ColonColonLoc The location of the trailing '::'.
void MakeSuper(ASTContext &Context, CXXRecordDecl *RD,
               SourceLocation SuperLoc, SourceLocation ColonColonLoc);

/// Make a new nested-name-specifier from incomplete source-location
/// information.
///
/// This routine should be used very, very rarely, in cases where we
/// need to synthesize a nested-name-specifier. Most code should instead use
/// \c Adopt() with a proper \c NestedNameSpecifierLoc.
void MakeTrivial(ASTContext &Context, NestedNameSpecifier *Qualifier,
                 SourceRange R);

/// Adopt an existing nested-name-specifier (with source-range
/// information).
void Adopt(NestedNameSpecifierLoc Other);

/// Retrieve the source range covered by this nested-name-specifier.
SourceRange getSourceRange() const LLVM_READONLY__attribute__((__pure__)) {
  return NestedNameSpecifierLoc(Representation, Buffer).getSourceRange();
}

/// Retrieve a nested-name-specifier with location information,
/// copied into the given AST context.
///
/// \param Context The context into which this nested-name-specifier will be
/// copied.
NestedNameSpecifierLoc getWithLocInContext(ASTContext &Context) const;

/// Retrieve a nested-name-specifier with location
/// information based on the information in this builder.
///
/// This loc will contain references to the builder's internal data and may
/// be invalidated by any change to the builder.
NestedNameSpecifierLoc getTemporary() const {
  return NestedNameSpecifierLoc(Representation, Buffer);
}

/// Clear out this builder, and prepare it to build another
/// nested-name-specifier with source-location information.
void Clear() {
  Representation = nullptr;
  BufferSize = 0;
}

/// Retrieve the underlying buffer.
///
/// \returns A pair containing a pointer to the buffer of source-location
/// data and the size of the source-location data that resides in that
/// buffer.
std::pair<char *, unsigned> getBuffer() const {
  return std::make_pair(Buffer, BufferSize);
}
518};

520/// Insertion operator for diagnostics.  This allows sending
521/// NestedNameSpecifiers into a diagnostic with <<.
522inline const StreamingDiagnostic &operator<<(const StreamingDiagnostic &DB,
                                           NestedNameSpecifier *NNS) {
DB.AddTaggedVal(reinterpret_cast<uint64_t>(NNS),
                DiagnosticsEngine::ak_nestednamespec);
return DB;
527}

529} // namespace clang

531namespace llvm {

533template <> struct DenseMapInfo<clang::NestedNameSpecifierLoc> {
using FirstInfo = DenseMapInfo<clang::NestedNameSpecifier *>;
using SecondInfo = DenseMapInfo<void *>;

static clang::NestedNameSpecifierLoc getEmptyKey() {
  return clang::NestedNameSpecifierLoc(FirstInfo::getEmptyKey(),
                                       SecondInfo::getEmptyKey());
}

static clang::NestedNameSpecifierLoc getTombstoneKey() {
  return clang::NestedNameSpecifierLoc(FirstInfo::getTombstoneKey(),
                                       SecondInfo::getTombstoneKey());
}

static unsigned getHashValue(const clang::NestedNameSpecifierLoc &PairVal) {
  return hash_combine(
      FirstInfo::getHashValue(PairVal.getNestedNameSpecifier()),
      SecondInfo::getHashValue(PairVal.getOpaqueData()));
}

static bool isEqual(const clang::NestedNameSpecifierLoc &LHS,
                    const clang::NestedNameSpecifierLoc &RHS) {
  return LHS == RHS;
}
557};
558} // namespace llvm

560#endif // LLVM_CLANG_AST_NESTEDNAMESPECIFIER_H