1 //===--- MacroArgs.h - Formal argument info for Macros ----------*- C++ -*-===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file defines the MacroArgs interface.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #ifndef LLVM_CLANG_LEX_MACROARGS_H
15 #define LLVM_CLANG_LEX_MACROARGS_H
16 
17 #include "clang/Basic/LLVM.h"
18 #include "llvm/ADT/ArrayRef.h"
19 #include <vector>
20 
21 namespace clang {
22   class MacroInfo;
23   class Preprocessor;
24   class Token;
25   class SourceLocation;
26 
27 /// MacroArgs - An instance of this class captures information about
28 /// the formal arguments specified to a function-like macro invocation.
29 class MacroArgs {
30   /// NumUnexpArgTokens - The number of raw, unexpanded tokens for the
31   /// arguments.  All of the actual argument tokens are allocated immediately
32   /// after the MacroArgs object in memory.  This is all of the arguments
33   /// concatenated together, with 'EOF' markers at the end of each argument.
34   unsigned NumUnexpArgTokens;
35 
36   /// VarargsElided - True if this is a C99 style varargs macro invocation and
37   /// there was no argument specified for the "..." argument.  If the argument
38   /// was specified (even empty) or this isn't a C99 style varargs function, or
39   /// if in strict mode and the C99 varargs macro had only a ... argument, this
40   /// is false.
41   bool VarargsElided;
42 
43   /// PreExpArgTokens - Pre-expanded tokens for arguments that need them.  Empty
44   /// if not yet computed.  This includes the EOF marker at the end of the
45   /// stream.
46   std::vector<std::vector<Token> > PreExpArgTokens;
47 
48   /// StringifiedArgs - This contains arguments in 'stringified' form.  If the
49   /// stringified form of an argument has not yet been computed, this is empty.
50   std::vector<Token> StringifiedArgs;
51 
52   /// ArgCache - This is a linked list of MacroArgs objects that the
53   /// Preprocessor owns which we use to avoid thrashing malloc/free.
54   MacroArgs *ArgCache;
55 
MacroArgs(unsigned NumToks,bool varargsElided)56   MacroArgs(unsigned NumToks, bool varargsElided)
57     : NumUnexpArgTokens(NumToks), VarargsElided(varargsElided),
58       ArgCache(nullptr) {}
~MacroArgs()59   ~MacroArgs() {}
60 public:
61   /// MacroArgs ctor function - Create a new MacroArgs object with the specified
62   /// macro and argument info.
63   static MacroArgs *create(const MacroInfo *MI,
64                            ArrayRef<Token> UnexpArgTokens,
65                            bool VarargsElided, Preprocessor &PP);
66 
67   /// destroy - Destroy and deallocate the memory for this object.
68   ///
69   void destroy(Preprocessor &PP);
70 
71   /// ArgNeedsPreexpansion - If we can prove that the argument won't be affected
72   /// by pre-expansion, return false.  Otherwise, conservatively return true.
73   bool ArgNeedsPreexpansion(const Token *ArgTok, Preprocessor &PP) const;
74 
75   /// getUnexpArgument - Return a pointer to the first token of the unexpanded
76   /// token list for the specified formal.
77   ///
78   const Token *getUnexpArgument(unsigned Arg) const;
79 
80   /// getArgLength - Given a pointer to an expanded or unexpanded argument,
81   /// return the number of tokens, not counting the EOF, that make up the
82   /// argument.
83   static unsigned getArgLength(const Token *ArgPtr);
84 
85   /// getPreExpArgument - Return the pre-expanded form of the specified
86   /// argument.
87   const std::vector<Token> &
88     getPreExpArgument(unsigned Arg, const MacroInfo *MI, Preprocessor &PP);
89 
90   /// getStringifiedArgument - Compute, cache, and return the specified argument
91   /// that has been 'stringified' as required by the # operator.
92   const Token &getStringifiedArgument(unsigned ArgNo, Preprocessor &PP,
93                                       SourceLocation ExpansionLocStart,
94                                       SourceLocation ExpansionLocEnd);
95 
96   /// getNumArguments - Return the number of arguments passed into this macro
97   /// invocation.
getNumArguments()98   unsigned getNumArguments() const { return NumUnexpArgTokens; }
99 
100 
101   /// isVarargsElidedUse - Return true if this is a C99 style varargs macro
102   /// invocation and there was no argument specified for the "..." argument.  If
103   /// the argument was specified (even empty) or this isn't a C99 style varargs
104   /// function, or if in strict mode and the C99 varargs macro had only a ...
105   /// argument, this returns false.
isVarargsElidedUse()106   bool isVarargsElidedUse() const { return VarargsElided; }
107 
108   /// StringifyArgument - Implement C99 6.10.3.2p2, converting a sequence of
109   /// tokens into the literal string token that should be produced by the C #
110   /// preprocessor operator.  If Charify is true, then it should be turned into
111   /// a character literal for the Microsoft charize (#@) extension.
112   ///
113   static Token StringifyArgument(const Token *ArgToks,
114                                  Preprocessor &PP, bool Charify,
115                                  SourceLocation ExpansionLocStart,
116                                  SourceLocation ExpansionLocEnd);
117 
118 
119   /// deallocate - This should only be called by the Preprocessor when managing
120   /// its freelist.
121   MacroArgs *deallocate();
122 };
123 
124 }  // end namespace clang
125 
126 #endif
127