Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 1 | //===--- Preprocess.cpp - C Language Family Preprocessor Implementation ---===// |
| 2 | // |
| 3 | // The LLVM Compiler Infrastructure |
| 4 | // |
Chris Lattner | 0bc735f | 2007-12-29 19:59:25 +0000 | [diff] [blame] | 5 | // This file is distributed under the University of Illinois Open Source |
| 6 | // License. See LICENSE.TXT for details. |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 7 | // |
| 8 | //===----------------------------------------------------------------------===// |
| 9 | // |
| 10 | // This file implements the Preprocessor interface. |
| 11 | // |
| 12 | //===----------------------------------------------------------------------===// |
| 13 | // |
| 14 | // Options to support: |
| 15 | // -H - Print the name of each header file used. |
Chris Lattner | f73903a | 2009-02-06 06:45:26 +0000 | [diff] [blame] | 16 | // -d[DNI] - Dump various things. |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 17 | // -fworking-directory - #line's with preprocessor's working dir. |
| 18 | // -fpreprocessed |
| 19 | // -dependency-file,-M,-MM,-MF,-MG,-MP,-MT,-MQ,-MD,-MMD |
| 20 | // -W* |
| 21 | // -w |
| 22 | // |
| 23 | // Messages to emit: |
| 24 | // "Multiple include guards may be useful for:\n" |
| 25 | // |
| 26 | //===----------------------------------------------------------------------===// |
| 27 | |
| 28 | #include "clang/Lex/Preprocessor.h" |
| 29 | #include "clang/Lex/HeaderSearch.h" |
| 30 | #include "clang/Lex/MacroInfo.h" |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 31 | #include "clang/Lex/Pragma.h" |
| 32 | #include "clang/Lex/ScratchBuffer.h" |
Chris Lattner | 500d329 | 2009-01-29 05:15:15 +0000 | [diff] [blame] | 33 | #include "clang/Lex/LexDiagnostic.h" |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 34 | #include "clang/Basic/SourceManager.h" |
Ted Kremenek | 337edcd | 2009-02-12 03:26:59 +0000 | [diff] [blame] | 35 | #include "clang/Basic/FileManager.h" |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 36 | #include "clang/Basic/TargetInfo.h" |
Chris Lattner | 2db78dd | 2008-10-05 20:40:30 +0000 | [diff] [blame] | 37 | #include "llvm/ADT/APFloat.h" |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 38 | #include "llvm/ADT/SmallVector.h" |
Chris Lattner | 97ba77c | 2007-07-16 06:48:38 +0000 | [diff] [blame] | 39 | #include "llvm/Support/MemoryBuffer.h" |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 40 | #include "llvm/Support/raw_ostream.h" |
Chris Lattner | 3daed52 | 2009-03-02 22:20:04 +0000 | [diff] [blame] | 41 | #include <cstdio> |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 42 | using namespace clang; |
| 43 | |
| 44 | //===----------------------------------------------------------------------===// |
| 45 | |
| 46 | Preprocessor::Preprocessor(Diagnostic &diags, const LangOptions &opts, |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 47 | TargetInfo &target, SourceManager &SM, |
Ted Kremenek | 72b1b15 | 2009-01-15 18:47:46 +0000 | [diff] [blame] | 48 | HeaderSearch &Headers, |
| 49 | IdentifierInfoLookup* IILookup) |
Chris Lattner | 836040f | 2009-03-13 21:17:43 +0000 | [diff] [blame] | 50 | : Diags(&diags), Features(opts), Target(target),FileMgr(Headers.getFileMgr()), |
Ted Kremenek | 72b1b15 | 2009-01-15 18:47:46 +0000 | [diff] [blame] | 51 | SourceMgr(SM), HeaderInfo(Headers), Identifiers(opts, IILookup), |
Chris Lattner | 030e8fe | 2009-06-16 16:18:48 +0000 | [diff] [blame] | 52 | BuiltinInfo(Target), CurPPLexer(0), CurDirLookup(0), Callbacks(0) { |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 53 | ScratchBuf = new ScratchBuffer(SourceMgr); |
Chris Lattner | c1f9d82 | 2009-04-13 01:29:17 +0000 | [diff] [blame] | 54 | CounterValue = 0; // __COUNTER__ starts at 0. |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 55 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 56 | // Clear stats. |
| 57 | NumDirectives = NumDefined = NumUndefined = NumPragma = 0; |
| 58 | NumIf = NumElse = NumEndif = 0; |
| 59 | NumEnteredSourceFiles = 0; |
| 60 | NumMacroExpanded = NumFnMacroExpanded = NumBuiltinMacroExpanded = 0; |
| 61 | NumFastMacroExpanded = NumTokenPaste = NumFastTokenPaste = 0; |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 62 | MaxIncludeStackDepth = 0; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 63 | NumSkipped = 0; |
| 64 | |
| 65 | // Default to discarding comments. |
| 66 | KeepComments = false; |
| 67 | KeepMacroComments = false; |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 68 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 69 | // Macro expansion is enabled. |
| 70 | DisableMacroExpansion = false; |
| 71 | InMacroArgs = false; |
Chris Lattner | 6cfe759 | 2008-03-09 02:26:03 +0000 | [diff] [blame] | 72 | NumCachedTokenLexers = 0; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 73 | |
Argyrios Kyrtzidis | 03db1b3 | 2008-08-10 13:15:22 +0000 | [diff] [blame] | 74 | CachedLexPos = 0; |
| 75 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 76 | // "Poison" __VA_ARGS__, which can only appear in the expansion of a macro. |
| 77 | // This gets unpoisoned where it is allowed. |
| 78 | (Ident__VA_ARGS__ = getIdentifierInfo("__VA_ARGS__"))->setIsPoisoned(); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 79 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 80 | // Initialize the pragma handlers. |
| 81 | PragmaHandlers = new PragmaNamespace(0); |
| 82 | RegisterBuiltinPragmas(); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 83 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 84 | // Initialize builtin macros like __LINE__ and friends. |
| 85 | RegisterBuiltinMacros(); |
| 86 | } |
| 87 | |
| 88 | Preprocessor::~Preprocessor() { |
Argyrios Kyrtzidis | 2174a4f | 2008-08-23 12:12:06 +0000 | [diff] [blame] | 89 | assert(BacktrackPositions.empty() && "EnableBacktrack/Backtrack imbalance!"); |
| 90 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 91 | while (!IncludeMacroStack.empty()) { |
| 92 | delete IncludeMacroStack.back().TheLexer; |
Chris Lattner | 6cfe759 | 2008-03-09 02:26:03 +0000 | [diff] [blame] | 93 | delete IncludeMacroStack.back().TheTokenLexer; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 94 | IncludeMacroStack.pop_back(); |
| 95 | } |
Chris Lattner | cc1a875 | 2007-10-07 08:44:20 +0000 | [diff] [blame] | 96 | |
| 97 | // Free any macro definitions. |
| 98 | for (llvm::DenseMap<IdentifierInfo*, MacroInfo*>::iterator I = |
| 99 | Macros.begin(), E = Macros.end(); I != E; ++I) { |
Ted Kremenek | 0ea7672 | 2008-12-15 19:56:42 +0000 | [diff] [blame] | 100 | // We don't need to free the MacroInfo objects directly. These |
| 101 | // will be released when the BumpPtrAllocator 'BP' object gets |
Ted Kremenek | 9ee7d45 | 2009-01-19 07:45:44 +0000 | [diff] [blame] | 102 | // destroyed. We still need to run the dstor, however, to free |
| 103 | // memory alocated by MacroInfo. |
Chris Lattner | 685befe | 2009-02-20 22:46:43 +0000 | [diff] [blame] | 104 | I->second->Destroy(BP); |
Chris Lattner | cc1a875 | 2007-10-07 08:44:20 +0000 | [diff] [blame] | 105 | I->first->setHasMacroDefinition(false); |
| 106 | } |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 107 | |
Chris Lattner | 9594acf | 2007-07-15 00:25:26 +0000 | [diff] [blame] | 108 | // Free any cached macro expanders. |
Chris Lattner | 6cfe759 | 2008-03-09 02:26:03 +0000 | [diff] [blame] | 109 | for (unsigned i = 0, e = NumCachedTokenLexers; i != e; ++i) |
| 110 | delete TokenLexerCache[i]; |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 111 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 112 | // Release pragma information. |
| 113 | delete PragmaHandlers; |
| 114 | |
| 115 | // Delete the scratch buffer info. |
| 116 | delete ScratchBuf; |
Chris Lattner | eb50ed8 | 2008-03-14 06:07:05 +0000 | [diff] [blame] | 117 | |
| 118 | delete Callbacks; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 119 | } |
| 120 | |
Ted Kremenek | 337edcd | 2009-02-12 03:26:59 +0000 | [diff] [blame] | 121 | void Preprocessor::setPTHManager(PTHManager* pm) { |
| 122 | PTH.reset(pm); |
Douglas Gregor | 52e7108 | 2009-10-16 18:18:30 +0000 | [diff] [blame] | 123 | FileMgr.addStatCache(PTH->createStatCache()); |
Ted Kremenek | 337edcd | 2009-02-12 03:26:59 +0000 | [diff] [blame] | 124 | } |
| 125 | |
Chris Lattner | d217773 | 2007-07-20 16:59:19 +0000 | [diff] [blame] | 126 | void Preprocessor::DumpToken(const Token &Tok, bool DumpFlags) const { |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 127 | llvm::errs() << tok::getTokenName(Tok.getKind()) << " '" |
| 128 | << getSpelling(Tok) << "'"; |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 129 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 130 | if (!DumpFlags) return; |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 131 | |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 132 | llvm::errs() << "\t"; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 133 | if (Tok.isAtStartOfLine()) |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 134 | llvm::errs() << " [StartOfLine]"; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 135 | if (Tok.hasLeadingSpace()) |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 136 | llvm::errs() << " [LeadingSpace]"; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 137 | if (Tok.isExpandDisabled()) |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 138 | llvm::errs() << " [ExpandDisabled]"; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 139 | if (Tok.needsCleaning()) { |
| 140 | const char *Start = SourceMgr.getCharacterData(Tok.getLocation()); |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 141 | llvm::errs() << " [UnClean='" << std::string(Start, Start+Tok.getLength()) |
| 142 | << "']"; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 143 | } |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 144 | |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 145 | llvm::errs() << "\tLoc=<"; |
Chris Lattner | c3d8d57 | 2007-12-09 20:31:55 +0000 | [diff] [blame] | 146 | DumpLocation(Tok.getLocation()); |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 147 | llvm::errs() << ">"; |
Chris Lattner | c3d8d57 | 2007-12-09 20:31:55 +0000 | [diff] [blame] | 148 | } |
| 149 | |
| 150 | void Preprocessor::DumpLocation(SourceLocation Loc) const { |
Chris Lattner | b9c3f96 | 2009-01-27 07:57:44 +0000 | [diff] [blame] | 151 | Loc.dump(SourceMgr); |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 152 | } |
| 153 | |
| 154 | void Preprocessor::DumpMacro(const MacroInfo &MI) const { |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 155 | llvm::errs() << "MACRO: "; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 156 | for (unsigned i = 0, e = MI.getNumTokens(); i != e; ++i) { |
| 157 | DumpToken(MI.getReplacementToken(i)); |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 158 | llvm::errs() << " "; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 159 | } |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 160 | llvm::errs() << "\n"; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 161 | } |
| 162 | |
| 163 | void Preprocessor::PrintStats() { |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 164 | llvm::errs() << "\n*** Preprocessor Stats:\n"; |
| 165 | llvm::errs() << NumDirectives << " directives found:\n"; |
| 166 | llvm::errs() << " " << NumDefined << " #define.\n"; |
| 167 | llvm::errs() << " " << NumUndefined << " #undef.\n"; |
| 168 | llvm::errs() << " #include/#include_next/#import:\n"; |
| 169 | llvm::errs() << " " << NumEnteredSourceFiles << " source files entered.\n"; |
| 170 | llvm::errs() << " " << MaxIncludeStackDepth << " max include stack depth\n"; |
| 171 | llvm::errs() << " " << NumIf << " #if/#ifndef/#ifdef.\n"; |
| 172 | llvm::errs() << " " << NumElse << " #else/#elif.\n"; |
| 173 | llvm::errs() << " " << NumEndif << " #endif.\n"; |
| 174 | llvm::errs() << " " << NumPragma << " #pragma.\n"; |
| 175 | llvm::errs() << NumSkipped << " #if/#ifndef#ifdef regions skipped\n"; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 176 | |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 177 | llvm::errs() << NumMacroExpanded << "/" << NumFnMacroExpanded << "/" |
Ted Kremenek | bdd30c2 | 2008-01-14 16:44:48 +0000 | [diff] [blame] | 178 | << NumBuiltinMacroExpanded << " obj/fn/builtin macros expanded, " |
| 179 | << NumFastMacroExpanded << " on the fast path.\n"; |
Benjamin Kramer | 6cb7c1a | 2009-08-23 12:08:50 +0000 | [diff] [blame] | 180 | llvm::errs() << (NumFastTokenPaste+NumTokenPaste) |
Ted Kremenek | bdd30c2 | 2008-01-14 16:44:48 +0000 | [diff] [blame] | 181 | << " token paste (##) operations performed, " |
| 182 | << NumFastTokenPaste << " on the fast path.\n"; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 183 | } |
| 184 | |
| 185 | //===----------------------------------------------------------------------===// |
| 186 | // Token Spelling |
| 187 | //===----------------------------------------------------------------------===// |
| 188 | |
| 189 | |
| 190 | /// getSpelling() - Return the 'spelling' of this token. The spelling of a |
| 191 | /// token are the characters used to represent the token in the source file |
| 192 | /// after trigraph expansion and escaped-newline folding. In particular, this |
| 193 | /// wants to get the true, uncanonicalized, spelling of things like digraphs |
| 194 | /// UCNs, etc. |
Chris Lattner | d217773 | 2007-07-20 16:59:19 +0000 | [diff] [blame] | 195 | std::string Preprocessor::getSpelling(const Token &Tok) const { |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 196 | assert((int)Tok.getLength() >= 0 && "Token character range is bogus!"); |
Ted Kremenek | 277faca | 2009-01-27 00:01:05 +0000 | [diff] [blame] | 197 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 198 | // If this token contains nothing interesting, return it directly. |
Ted Kremenek | 277faca | 2009-01-27 00:01:05 +0000 | [diff] [blame] | 199 | const char* TokStart = SourceMgr.getCharacterData(Tok.getLocation()); |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 200 | if (!Tok.needsCleaning()) |
| 201 | return std::string(TokStart, TokStart+Tok.getLength()); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 202 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 203 | std::string Result; |
| 204 | Result.reserve(Tok.getLength()); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 205 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 206 | // Otherwise, hard case, relex the characters into the string. |
| 207 | for (const char *Ptr = TokStart, *End = TokStart+Tok.getLength(); |
| 208 | Ptr != End; ) { |
| 209 | unsigned CharSize; |
| 210 | Result.push_back(Lexer::getCharAndSizeNoWarn(Ptr, CharSize, Features)); |
| 211 | Ptr += CharSize; |
| 212 | } |
| 213 | assert(Result.size() != unsigned(Tok.getLength()) && |
| 214 | "NeedsCleaning flag set on something that didn't need cleaning!"); |
| 215 | return Result; |
| 216 | } |
| 217 | |
| 218 | /// getSpelling - This method is used to get the spelling of a token into a |
| 219 | /// preallocated buffer, instead of as an std::string. The caller is required |
| 220 | /// to allocate enough space for the token, which is guaranteed to be at least |
| 221 | /// Tok.getLength() bytes long. The actual length of the token is returned. |
| 222 | /// |
| 223 | /// Note that this method may do two possible things: it may either fill in |
| 224 | /// the buffer specified with characters, or it may *change the input pointer* |
| 225 | /// to point to a constant buffer with the data already in it (avoiding a |
| 226 | /// copy). The caller is not allowed to modify the returned buffer pointer |
| 227 | /// if an internal buffer is returned. |
Chris Lattner | d217773 | 2007-07-20 16:59:19 +0000 | [diff] [blame] | 228 | unsigned Preprocessor::getSpelling(const Token &Tok, |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 229 | const char *&Buffer) const { |
| 230 | assert((int)Tok.getLength() >= 0 && "Token character range is bogus!"); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 231 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 232 | // If this token is an identifier, just return the string from the identifier |
| 233 | // table, which is very quick. |
| 234 | if (const IdentifierInfo *II = Tok.getIdentifierInfo()) { |
Daniel Dunbar | e013d68 | 2009-10-18 20:26:12 +0000 | [diff] [blame] | 235 | Buffer = II->getNameStart(); |
Chris Lattner | e1dccae | 2009-01-05 19:44:41 +0000 | [diff] [blame] | 236 | return II->getLength(); |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 237 | } |
Ted Kremenek | b70e3da | 2009-01-08 02:47:16 +0000 | [diff] [blame] | 238 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 239 | // Otherwise, compute the start of the token in the input lexer buffer. |
Chris Lattner | 47246be | 2009-01-26 19:29:26 +0000 | [diff] [blame] | 240 | const char *TokStart = 0; |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 241 | |
Chris Lattner | 47246be | 2009-01-26 19:29:26 +0000 | [diff] [blame] | 242 | if (Tok.isLiteral()) |
| 243 | TokStart = Tok.getLiteralData(); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 244 | |
Chris Lattner | 47246be | 2009-01-26 19:29:26 +0000 | [diff] [blame] | 245 | if (TokStart == 0) |
| 246 | TokStart = SourceMgr.getCharacterData(Tok.getLocation()); |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 247 | |
| 248 | // If this token contains nothing interesting, return it directly. |
| 249 | if (!Tok.needsCleaning()) { |
| 250 | Buffer = TokStart; |
| 251 | return Tok.getLength(); |
| 252 | } |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 253 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 254 | // Otherwise, hard case, relex the characters into the string. |
| 255 | char *OutBuf = const_cast<char*>(Buffer); |
| 256 | for (const char *Ptr = TokStart, *End = TokStart+Tok.getLength(); |
| 257 | Ptr != End; ) { |
| 258 | unsigned CharSize; |
| 259 | *OutBuf++ = Lexer::getCharAndSizeNoWarn(Ptr, CharSize, Features); |
| 260 | Ptr += CharSize; |
| 261 | } |
| 262 | assert(unsigned(OutBuf-Buffer) != Tok.getLength() && |
| 263 | "NeedsCleaning flag set on something that didn't need cleaning!"); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 264 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 265 | return OutBuf-Buffer; |
| 266 | } |
| 267 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 268 | /// CreateString - Plop the specified string into a scratch buffer and return a |
| 269 | /// location for it. If specified, the source location provides a source |
| 270 | /// location for the token. |
Chris Lattner | 47246be | 2009-01-26 19:29:26 +0000 | [diff] [blame] | 271 | void Preprocessor::CreateString(const char *Buf, unsigned Len, Token &Tok, |
| 272 | SourceLocation InstantiationLoc) { |
| 273 | Tok.setLength(Len); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 274 | |
Chris Lattner | 47246be | 2009-01-26 19:29:26 +0000 | [diff] [blame] | 275 | const char *DestPtr; |
| 276 | SourceLocation Loc = ScratchBuf->getToken(Buf, Len, DestPtr); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 277 | |
Chris Lattner | 47246be | 2009-01-26 19:29:26 +0000 | [diff] [blame] | 278 | if (InstantiationLoc.isValid()) |
Chris Lattner | e7fb484 | 2009-02-15 20:52:18 +0000 | [diff] [blame] | 279 | Loc = SourceMgr.createInstantiationLoc(Loc, InstantiationLoc, |
| 280 | InstantiationLoc, Len); |
Chris Lattner | 47246be | 2009-01-26 19:29:26 +0000 | [diff] [blame] | 281 | Tok.setLocation(Loc); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 282 | |
Chris Lattner | 47246be | 2009-01-26 19:29:26 +0000 | [diff] [blame] | 283 | // If this is a literal token, set the pointer data. |
| 284 | if (Tok.isLiteral()) |
| 285 | Tok.setLiteralData(DestPtr); |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 286 | } |
| 287 | |
| 288 | |
Chris Lattner | 97ba77c | 2007-07-16 06:48:38 +0000 | [diff] [blame] | 289 | /// AdvanceToTokenCharacter - Given a location that specifies the start of a |
| 290 | /// token, return a new location that specifies a character within the token. |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 291 | SourceLocation Preprocessor::AdvanceToTokenCharacter(SourceLocation TokStart, |
Chris Lattner | 97ba77c | 2007-07-16 06:48:38 +0000 | [diff] [blame] | 292 | unsigned CharNo) { |
Chris Lattner | f7cf85b | 2009-01-16 07:36:28 +0000 | [diff] [blame] | 293 | // Figure out how many physical characters away the specified instantiation |
Chris Lattner | 97ba77c | 2007-07-16 06:48:38 +0000 | [diff] [blame] | 294 | // character is. This needs to take into consideration newlines and |
| 295 | // trigraphs. |
Chris Lattner | 9dc1f53 | 2007-07-20 16:37:10 +0000 | [diff] [blame] | 296 | const char *TokPtr = SourceMgr.getCharacterData(TokStart); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 297 | |
Chris Lattner | 88e2524 | 2009-04-18 22:28:58 +0000 | [diff] [blame] | 298 | // If they request the first char of the token, we're trivially done. |
| 299 | if (CharNo == 0 && Lexer::isObviouslySimpleCharacter(*TokPtr)) |
| 300 | return TokStart; |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 301 | |
Chris Lattner | 9dc1f53 | 2007-07-20 16:37:10 +0000 | [diff] [blame] | 302 | unsigned PhysOffset = 0; |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 303 | |
Chris Lattner | 97ba77c | 2007-07-16 06:48:38 +0000 | [diff] [blame] | 304 | // The usual case is that tokens don't contain anything interesting. Skip |
| 305 | // over the uninteresting characters. If a token only consists of simple |
| 306 | // chars, this method is extremely fast. |
Chris Lattner | 88e2524 | 2009-04-18 22:28:58 +0000 | [diff] [blame] | 307 | while (Lexer::isObviouslySimpleCharacter(*TokPtr)) { |
| 308 | if (CharNo == 0) |
| 309 | return TokStart.getFileLocWithOffset(PhysOffset); |
Chris Lattner | 9dc1f53 | 2007-07-20 16:37:10 +0000 | [diff] [blame] | 310 | ++TokPtr, --CharNo, ++PhysOffset; |
Chris Lattner | 88e2524 | 2009-04-18 22:28:58 +0000 | [diff] [blame] | 311 | } |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 312 | |
Chris Lattner | 28c90ad | 2009-01-17 07:57:25 +0000 | [diff] [blame] | 313 | // If we have a character that may be a trigraph or escaped newline, use a |
Chris Lattner | 97ba77c | 2007-07-16 06:48:38 +0000 | [diff] [blame] | 314 | // lexer to parse it correctly. |
Chris Lattner | 88e2524 | 2009-04-18 22:28:58 +0000 | [diff] [blame] | 315 | for (; CharNo; --CharNo) { |
| 316 | unsigned Size; |
| 317 | Lexer::getCharAndSizeNoWarn(TokPtr, Size, Features); |
| 318 | TokPtr += Size; |
| 319 | PhysOffset += Size; |
Chris Lattner | 97ba77c | 2007-07-16 06:48:38 +0000 | [diff] [blame] | 320 | } |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 321 | |
Chris Lattner | 88e2524 | 2009-04-18 22:28:58 +0000 | [diff] [blame] | 322 | // Final detail: if we end up on an escaped newline, we want to return the |
| 323 | // location of the actual byte of the token. For example foo\<newline>bar |
| 324 | // advanced by 3 should return the location of b, not of \\. One compounding |
| 325 | // detail of this is that the escape may be made by a trigraph. |
| 326 | if (!Lexer::isObviouslySimpleCharacter(*TokPtr)) |
| 327 | PhysOffset = Lexer::SkipEscapedNewLines(TokPtr)-TokPtr; |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 328 | |
Chris Lattner | 9dc1f53 | 2007-07-20 16:37:10 +0000 | [diff] [blame] | 329 | return TokStart.getFileLocWithOffset(PhysOffset); |
Chris Lattner | 97ba77c | 2007-07-16 06:48:38 +0000 | [diff] [blame] | 330 | } |
| 331 | |
Douglas Gregor | b2fb6de | 2009-02-27 17:53:17 +0000 | [diff] [blame] | 332 | /// \brief Computes the source location just past the end of the |
| 333 | /// token at this source location. |
| 334 | /// |
| 335 | /// This routine can be used to produce a source location that |
| 336 | /// points just past the end of the token referenced by \p Loc, and |
| 337 | /// is generally used when a diagnostic needs to point just after a |
| 338 | /// token where it expected something different that it received. If |
| 339 | /// the returned source location would not be meaningful (e.g., if |
| 340 | /// it points into a macro), this routine returns an invalid |
| 341 | /// source location. |
| 342 | SourceLocation Preprocessor::getLocForEndOfToken(SourceLocation Loc) { |
| 343 | if (Loc.isInvalid() || !Loc.isFileID()) |
| 344 | return SourceLocation(); |
| 345 | |
Chris Lattner | 2c78b87 | 2009-04-14 23:22:57 +0000 | [diff] [blame] | 346 | unsigned Len = Lexer::MeasureTokenLength(Loc, getSourceManager(), Features); |
Douglas Gregor | b2fb6de | 2009-02-27 17:53:17 +0000 | [diff] [blame] | 347 | return AdvanceToTokenCharacter(Loc, Len); |
| 348 | } |
| 349 | |
| 350 | |
Chris Lattner | 97ba77c | 2007-07-16 06:48:38 +0000 | [diff] [blame] | 351 | |
Chris Lattner | 53b0dab | 2007-10-09 22:10:18 +0000 | [diff] [blame] | 352 | //===----------------------------------------------------------------------===// |
| 353 | // Preprocessor Initialization Methods |
| 354 | //===----------------------------------------------------------------------===// |
| 355 | |
Chris Lattner | 53b0dab | 2007-10-09 22:10:18 +0000 | [diff] [blame] | 356 | |
| 357 | /// EnterMainSourceFile - Enter the specified FileID as the main source file, |
Nate Begeman | 6b61602 | 2008-01-07 04:01:26 +0000 | [diff] [blame] | 358 | /// which implicitly adds the builtin defines etc. |
Ted Kremenek | 95041a2 | 2007-12-19 22:51:13 +0000 | [diff] [blame] | 359 | void Preprocessor::EnterMainSourceFile() { |
Chris Lattner | 05db427 | 2009-02-13 19:33:24 +0000 | [diff] [blame] | 360 | // We do not allow the preprocessor to reenter the main file. Doing so will |
| 361 | // cause FileID's to accumulate information from both runs (e.g. #line |
| 362 | // information) and predefined macros aren't guaranteed to be set properly. |
| 363 | assert(NumEnteredSourceFiles == 0 && "Cannot reenter the main file!"); |
Chris Lattner | 2b2453a | 2009-01-17 06:22:33 +0000 | [diff] [blame] | 364 | FileID MainFileID = SourceMgr.getMainFileID(); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 365 | |
Chris Lattner | 53b0dab | 2007-10-09 22:10:18 +0000 | [diff] [blame] | 366 | // Enter the main file source buffer. |
| 367 | EnterSourceFile(MainFileID, 0); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 368 | |
Chris Lattner | b283298 | 2007-11-15 19:07:47 +0000 | [diff] [blame] | 369 | // Tell the header info that the main file was entered. If the file is later |
| 370 | // #imported, it won't be re-entered. |
Chris Lattner | 2b2453a | 2009-01-17 06:22:33 +0000 | [diff] [blame] | 371 | if (const FileEntry *FE = SourceMgr.getFileEntryForID(MainFileID)) |
Chris Lattner | b283298 | 2007-11-15 19:07:47 +0000 | [diff] [blame] | 372 | HeaderInfo.IncrementIncludeCount(FE); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 373 | |
Chris Lattner | 53b0dab | 2007-10-09 22:10:18 +0000 | [diff] [blame] | 374 | std::vector<char> PrologFile; |
| 375 | PrologFile.reserve(4080); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 376 | |
Chris Lattner | 6bf0f4c | 2009-04-10 21:58:23 +0000 | [diff] [blame] | 377 | // FIXME: Don't make a copy. |
Chris Lattner | aa39197 | 2008-04-19 23:09:31 +0000 | [diff] [blame] | 378 | PrologFile.insert(PrologFile.end(), Predefines.begin(), Predefines.end()); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 379 | |
Chris Lattner | 53b0dab | 2007-10-09 22:10:18 +0000 | [diff] [blame] | 380 | // Memory buffer must end with a null byte! |
| 381 | PrologFile.push_back(0); |
| 382 | |
| 383 | // Now that we have emitted the predefined macros, #includes, etc into |
| 384 | // PrologFile, preprocess it to populate the initial preprocessor state. |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 385 | llvm::MemoryBuffer *SB = |
Chris Lattner | 53b0dab | 2007-10-09 22:10:18 +0000 | [diff] [blame] | 386 | llvm::MemoryBuffer::getMemBufferCopy(&PrologFile.front(),&PrologFile.back(), |
Chris Lattner | f2e880a | 2009-03-20 20:16:10 +0000 | [diff] [blame] | 387 | "<built-in>"); |
Chris Lattner | 53b0dab | 2007-10-09 22:10:18 +0000 | [diff] [blame] | 388 | assert(SB && "Cannot fail to create predefined source buffer"); |
Chris Lattner | 2b2453a | 2009-01-17 06:22:33 +0000 | [diff] [blame] | 389 | FileID FID = SourceMgr.createFileIDForMemBuffer(SB); |
| 390 | assert(!FID.isInvalid() && "Could not create FileID for predefines?"); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 391 | |
Chris Lattner | 53b0dab | 2007-10-09 22:10:18 +0000 | [diff] [blame] | 392 | // Start parsing the predefines. |
Chris Lattner | 2b2453a | 2009-01-17 06:22:33 +0000 | [diff] [blame] | 393 | EnterSourceFile(FID, 0); |
Chris Lattner | 53b0dab | 2007-10-09 22:10:18 +0000 | [diff] [blame] | 394 | } |
Chris Lattner | 97ba77c | 2007-07-16 06:48:38 +0000 | [diff] [blame] | 395 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 396 | |
| 397 | //===----------------------------------------------------------------------===// |
| 398 | // Lexer Event Handling. |
| 399 | //===----------------------------------------------------------------------===// |
| 400 | |
| 401 | /// LookUpIdentifierInfo - Given a tok::identifier token, look up the |
| 402 | /// identifier information for the token and install it into the token. |
Chris Lattner | d217773 | 2007-07-20 16:59:19 +0000 | [diff] [blame] | 403 | IdentifierInfo *Preprocessor::LookUpIdentifierInfo(Token &Identifier, |
Daniel Dunbar | c322209 | 2009-11-05 01:53:52 +0000 | [diff] [blame] | 404 | const char *BufPtr) const { |
Chris Lattner | 22f6bbc | 2007-10-09 18:02:16 +0000 | [diff] [blame] | 405 | assert(Identifier.is(tok::identifier) && "Not an identifier!"); |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 406 | assert(Identifier.getIdentifierInfo() == 0 && "Identinfo already exists!"); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 407 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 408 | // Look up this token, see if it is a macro, or if it is a language keyword. |
| 409 | IdentifierInfo *II; |
| 410 | if (BufPtr && !Identifier.needsCleaning()) { |
| 411 | // No cleaning needed, just use the characters from the lexed buffer. |
Daniel Dunbar | 3da736c | 2009-11-05 01:53:39 +0000 | [diff] [blame] | 412 | II = getIdentifierInfo(llvm::StringRef(BufPtr, Identifier.getLength())); |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 413 | } else { |
| 414 | // Cleaning needed, alloca a buffer, clean into it, then use the buffer. |
Chris Lattner | c35717a | 2007-07-13 17:10:38 +0000 | [diff] [blame] | 415 | llvm::SmallVector<char, 64> IdentifierBuffer; |
| 416 | IdentifierBuffer.resize(Identifier.getLength()); |
| 417 | const char *TmpBuf = &IdentifierBuffer[0]; |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 418 | unsigned Size = getSpelling(Identifier, TmpBuf); |
Daniel Dunbar | 3da736c | 2009-11-05 01:53:39 +0000 | [diff] [blame] | 419 | II = getIdentifierInfo(llvm::StringRef(TmpBuf, Size)); |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 420 | } |
| 421 | Identifier.setIdentifierInfo(II); |
| 422 | return II; |
| 423 | } |
| 424 | |
| 425 | |
| 426 | /// HandleIdentifier - This callback is invoked when the lexer reads an |
| 427 | /// identifier. This callback looks up the identifier in the map and/or |
| 428 | /// potentially macro expands it or turns it into a named token (like 'for'). |
Chris Lattner | 6a170eb | 2009-01-21 07:43:11 +0000 | [diff] [blame] | 429 | /// |
| 430 | /// Note that callers of this method are guarded by checking the |
| 431 | /// IdentifierInfo's 'isHandleIdentifierCase' bit. If this method changes, the |
| 432 | /// IdentifierInfo methods that compute these properties will need to change to |
| 433 | /// match. |
Chris Lattner | d217773 | 2007-07-20 16:59:19 +0000 | [diff] [blame] | 434 | void Preprocessor::HandleIdentifier(Token &Identifier) { |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 435 | assert(Identifier.getIdentifierInfo() && |
| 436 | "Can't handle identifiers without identifier info!"); |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 437 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 438 | IdentifierInfo &II = *Identifier.getIdentifierInfo(); |
| 439 | |
| 440 | // If this identifier was poisoned, and if it was not produced from a macro |
| 441 | // expansion, emit an error. |
Ted Kremenek | 1a53157 | 2008-11-19 22:43:49 +0000 | [diff] [blame] | 442 | if (II.isPoisoned() && CurPPLexer) { |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 443 | if (&II != Ident__VA_ARGS__) // We warn about __VA_ARGS__ with poisoning. |
| 444 | Diag(Identifier, diag::err_pp_used_poisoned_id); |
| 445 | else |
| 446 | Diag(Identifier, diag::ext_pp_bad_vaargs_use); |
| 447 | } |
Mike Stump | 1eb4433 | 2009-09-09 15:08:12 +0000 | [diff] [blame] | 448 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 449 | // If this is a macro to be expanded, do it. |
Chris Lattner | cc1a875 | 2007-10-07 08:44:20 +0000 | [diff] [blame] | 450 | if (MacroInfo *MI = getMacroInfo(&II)) { |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 451 | if (!DisableMacroExpansion && !Identifier.isExpandDisabled()) { |
| 452 | if (MI->isEnabled()) { |
| 453 | if (!HandleMacroExpandedIdentifier(Identifier, MI)) |
| 454 | return; |
| 455 | } else { |
| 456 | // C99 6.10.3.4p2 says that a disabled macro may never again be |
| 457 | // expanded, even if it's in a context where it could be expanded in the |
| 458 | // future. |
Chris Lattner | d217773 | 2007-07-20 16:59:19 +0000 | [diff] [blame] | 459 | Identifier.setFlag(Token::DisableExpand); |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 460 | } |
| 461 | } |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 462 | } |
| 463 | |
| 464 | // C++ 2.11p2: If this is an alternative representation of a C++ operator, |
| 465 | // then we act as if it is the actual operator and not the textual |
| 466 | // representation of it. |
| 467 | if (II.isCPlusPlusOperatorKeyword()) |
| 468 | Identifier.setIdentifierInfo(0); |
| 469 | |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 470 | // If this is an extension token, diagnose its use. |
Steve Naroff | b4eaf9c | 2008-09-02 18:50:17 +0000 | [diff] [blame] | 471 | // We avoid diagnosing tokens that originate from macro definitions. |
Eli Friedman | 2962f4d | 2009-04-28 03:59:15 +0000 | [diff] [blame] | 472 | // FIXME: This warning is disabled in cases where it shouldn't be, |
| 473 | // like "#define TY typeof", "TY(1) x". |
| 474 | if (II.isExtensionToken() && !DisableMacroExpansion) |
Reid Spencer | 5f016e2 | 2007-07-11 17:01:13 +0000 | [diff] [blame] | 475 | Diag(Identifier, diag::ext_token_used); |
| 476 | } |
Douglas Gregor | 2e22253 | 2009-07-02 17:08:52 +0000 | [diff] [blame] | 477 | |
| 478 | void Preprocessor::AddCommentHandler(CommentHandler *Handler) { |
| 479 | assert(Handler && "NULL comment handler"); |
| 480 | assert(std::find(CommentHandlers.begin(), CommentHandlers.end(), Handler) == |
| 481 | CommentHandlers.end() && "Comment handler already registered"); |
| 482 | CommentHandlers.push_back(Handler); |
| 483 | } |
| 484 | |
| 485 | void Preprocessor::RemoveCommentHandler(CommentHandler *Handler) { |
| 486 | std::vector<CommentHandler *>::iterator Pos |
| 487 | = std::find(CommentHandlers.begin(), CommentHandlers.end(), Handler); |
| 488 | assert(Pos != CommentHandlers.end() && "Comment handler not registered"); |
| 489 | CommentHandlers.erase(Pos); |
| 490 | } |
| 491 | |
| 492 | void Preprocessor::HandleComment(SourceRange Comment) { |
| 493 | for (std::vector<CommentHandler *>::iterator H = CommentHandlers.begin(), |
| 494 | HEnd = CommentHandlers.end(); |
| 495 | H != HEnd; ++H) |
| 496 | (*H)->HandleComment(*this, Comment); |
| 497 | } |
| 498 | |
| 499 | CommentHandler::~CommentHandler() { } |