clang  19.0.0git
DeclFriend.cpp
Go to the documentation of this file.
1 //===- DeclFriend.cpp - C++ Friend Declaration AST Node Implementation ----===//
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 implements the AST classes related to C++ friend
10 // declarations.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "clang/AST/DeclFriend.h"
15 #include "clang/AST/Decl.h"
16 #include "clang/AST/DeclBase.h"
17 #include "clang/AST/DeclCXX.h"
18 #include "clang/AST/ASTContext.h"
19 #include "clang/AST/DeclTemplate.h"
20 #include "clang/Basic/LLVM.h"
21 #include "llvm/Support/Casting.h"
22 #include <cassert>
23 #include <cstddef>
24 
25 using namespace clang;
26 
27 void FriendDecl::anchor() {}
28 
29 FriendDecl *FriendDecl::getNextFriendSlowCase() {
30  return cast_or_null<FriendDecl>(
31  NextFriend.get(getASTContext().getExternalSource()));
32 }
33 
36  FriendUnion Friend,
37  SourceLocation FriendL,
38  ArrayRef<TemplateParameterList *> FriendTypeTPLists) {
39 #ifndef NDEBUG
40  if (Friend.is<NamedDecl *>()) {
41  const auto *D = Friend.get<NamedDecl*>();
42  assert(isa<FunctionDecl>(D) ||
43  isa<CXXRecordDecl>(D) ||
44  isa<FunctionTemplateDecl>(D) ||
45  isa<ClassTemplateDecl>(D));
46 
47  // As a temporary hack, we permit template instantiation to point
48  // to the original declaration when instantiating members.
49  assert(D->getFriendObjectKind() ||
50  (cast<CXXRecordDecl>(DC)->getTemplateSpecializationKind()));
51  // These template parameters are for friend types only.
52  assert(FriendTypeTPLists.empty());
53  }
54 #endif
55 
56  std::size_t Extra =
57  FriendDecl::additionalSizeToAlloc<TemplateParameterList *>(
58  FriendTypeTPLists.size());
59  auto *FD = new (C, DC, Extra) FriendDecl(DC, L, Friend, FriendL,
60  FriendTypeTPLists);
61  cast<CXXRecordDecl>(DC)->pushFriendDecl(FD);
62  return FD;
63 }
64 
66  unsigned FriendTypeNumTPLists) {
67  std::size_t Extra =
68  additionalSizeToAlloc<TemplateParameterList *>(FriendTypeNumTPLists);
69  return new (C, ID, Extra) FriendDecl(EmptyShell(), FriendTypeNumTPLists);
70 }
71 
72 FriendDecl *CXXRecordDecl::getFirstFriend() const {
74  Decl *First = data().FirstFriend.get(Source);
75  return First ? cast<FriendDecl>(First) : nullptr;
76 }
Defines the clang::ASTContext interface.
static char ID
Definition: Arena.cpp:183
Defines the C++ Decl subclasses, other than those for templates (found in DeclTemplate....
Defines the C++ template declaration subclasses.
Forward-declares and imports various common LLVM datatypes that clang wants to use unqualified.
__SIZE_TYPE__ size_t
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition: ASTContext.h:185
ExternalASTSource * getExternalSource() const
Retrieve a pointer to the external AST source associated with this AST context, if any.
Definition: ASTContext.h:1203
DeclContext - This is used only as base class of specific decl types that can act as declaration cont...
Definition: DeclBase.h:1436
ASTContext & getParentASTContext() const
Definition: DeclBase.h:2095
Decl - This represents one declaration (or definition), e.g.
Definition: DeclBase.h:86
ASTContext & getASTContext() const LLVM_READONLY
Definition: DeclBase.cpp:501
Abstract interface for external sources of AST nodes.
FriendDecl - Represents the declaration of a friend entity, which can be a function,...
Definition: DeclFriend.h:54
static FriendDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L, FriendUnion Friend_, SourceLocation FriendL, ArrayRef< TemplateParameterList * > FriendTypeTPLists=std::nullopt)
Definition: DeclFriend.cpp:34
llvm::PointerUnion< NamedDecl *, TypeSourceInfo * > FriendUnion
Definition: DeclFriend.h:58
static FriendDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned FriendTypeNumTPLists)
Definition: DeclFriend.cpp:65
This represents a decl that may have a name.
Definition: Decl.h:249
Encodes a location in the source.
The JSON file list parser is used to communicate input to InstallAPI.
A placeholder type used to construct an empty shell of a decl-derived type that will be filled in lat...
Definition: DeclBase.h:102
T * get(ExternalASTSource *Source) const
Retrieve the pointer to the AST node that this lazy pointer points to.