clang 20.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
15#include "clang/AST/Decl.h"
16#include "clang/AST/DeclBase.h"
17#include "clang/AST/DeclCXX.h"
20#include "clang/Basic/LLVM.h"
21#include "llvm/Support/Casting.h"
22#include <cassert>
23#include <cstddef>
24
25using namespace clang;
26
27void FriendDecl::anchor() {}
28
29FriendDecl *FriendDecl::getNextFriendSlowCase() {
30 return cast_or_null<FriendDecl>(
31 NextFriend.get(getASTContext().getExternalSource()));
32}
33
37 SourceLocation EllipsisLoc,
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)
60 FriendDecl(DC, L, Friend, FriendL, EllipsisLoc, 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
72FriendDecl *CXXRecordDecl::getFirstFriend() const {
74 Decl *First = data().FirstFriend.get(Source);
75 return First ? cast<FriendDecl>(First) : nullptr;
76}
Defines the clang::ASTContext interface.
const Decl * D
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.
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition: ASTContext.h:187
ExternalASTSource * getExternalSource() const
Retrieve a pointer to the external AST source associated with this AST context, if any.
Definition: ASTContext.h:1227
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:2119
Decl - This represents one declaration (or definition), e.g.
Definition: DeclBase.h:86
FriendObjectKind getFriendObjectKind() const
Determines whether this declaration is the object of a friend declaration and, if so,...
Definition: DeclBase.h:1216
ASTContext & getASTContext() const LLVM_READONLY
Definition: DeclBase.cpp:523
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
llvm::PointerUnion< NamedDecl *, TypeSourceInfo * > FriendUnion
Definition: DeclFriend.h:58
static FriendDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned FriendTypeNumTPLists)
Definition: DeclFriend.cpp:65
static FriendDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L, FriendUnion Friend_, SourceLocation FriendL, SourceLocation EllipsisLoc={}, ArrayRef< TemplateParameterList * > FriendTypeTPLists=std::nullopt)
Definition: DeclFriend.cpp:35
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.