1 //===--- TokenKinds.h - Enum values for C Token Kinds -----------*- 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 /// \file
11 /// \brief Defines the clang::TokenKind enum and support functions.
12 ///
13 //===----------------------------------------------------------------------===//
14 
15 #ifndef LLVM_CLANG_BASIC_TOKENKINDS_H
16 #define LLVM_CLANG_BASIC_TOKENKINDS_H
17 
18 #include "llvm/Support/Compiler.h"
19 
20 namespace clang {
21 
22 namespace tok {
23 
24 /// \brief Provides a simple uniform namespace for tokens from all C languages.
25 enum TokenKind : unsigned short {
26 #define TOK(X) X,
27 #include "clang/Basic/TokenKinds.def"
28   NUM_TOKENS
29 };
30 
31 /// \brief Provides a namespace for preprocessor keywords which start with a
32 /// '#' at the beginning of the line.
33 enum PPKeywordKind {
34 #define PPKEYWORD(X) pp_##X,
35 #include "clang/Basic/TokenKinds.def"
36   NUM_PP_KEYWORDS
37 };
38 
39 /// \brief Provides a namespace for Objective-C keywords which start with
40 /// an '@'.
41 enum ObjCKeywordKind {
42 #define OBJC1_AT_KEYWORD(X) objc_##X,
43 #define OBJC2_AT_KEYWORD(X) objc_##X,
44 #include "clang/Basic/TokenKinds.def"
45   NUM_OBJC_KEYWORDS
46 };
47 
48 /// \brief Defines the possible values of an on-off-switch (C99 6.10.6p2).
49 enum OnOffSwitch {
50   OOS_ON, OOS_OFF, OOS_DEFAULT
51 };
52 
53 /// \brief Determines the name of a token as used within the front end.
54 ///
55 /// The name of a token will be an internal name (such as "l_square")
56 /// and should not be used as part of diagnostic messages.
57 const char *getTokenName(TokenKind Kind) LLVM_READNONE;
58 
59 /// \brief Determines the spelling of simple punctuation tokens like
60 /// '!' or '%', and returns NULL for literal and annotation tokens.
61 ///
62 /// This routine only retrieves the "simple" spelling of the token,
63 /// and will not produce any alternative spellings (e.g., a
64 /// digraph). For the actual spelling of a given Token, use
65 /// Preprocessor::getSpelling().
66 const char *getPunctuatorSpelling(TokenKind Kind) LLVM_READNONE;
67 
68 /// \brief Determines the spelling of simple keyword and contextual keyword
69 /// tokens like 'int' and 'dynamic_cast'. Returns NULL for other token kinds.
70 const char *getKeywordSpelling(TokenKind Kind) LLVM_READNONE;
71 
72 /// \brief Return true if this is a raw identifier or an identifier kind.
isAnyIdentifier(TokenKind K)73 inline bool isAnyIdentifier(TokenKind K) {
74   return (K == tok::identifier) || (K == tok::raw_identifier);
75 }
76 
77 /// \brief Return true if this is a C or C++ string-literal (or
78 /// C++11 user-defined-string-literal) token.
isStringLiteral(TokenKind K)79 inline bool isStringLiteral(TokenKind K) {
80   return K == tok::string_literal || K == tok::wide_string_literal ||
81          K == tok::utf8_string_literal || K == tok::utf16_string_literal ||
82          K == tok::utf32_string_literal;
83 }
84 
85 /// \brief Return true if this is a "literal" kind, like a numeric
86 /// constant, string, etc.
isLiteral(TokenKind K)87 inline bool isLiteral(TokenKind K) {
88   return K == tok::numeric_constant || K == tok::char_constant ||
89          K == tok::wide_char_constant || K == tok::utf8_char_constant ||
90          K == tok::utf16_char_constant || K == tok::utf32_char_constant ||
91          isStringLiteral(K) || K == tok::angle_string_literal;
92 }
93 
94 /// \brief Return true if this is any of tok::annot_* kinds.
isAnnotation(TokenKind K)95 inline bool isAnnotation(TokenKind K) {
96 #define ANNOTATION(NAME) \
97   if (K == tok::annot_##NAME) \
98     return true;
99 #include "clang/Basic/TokenKinds.def"
100   return false;
101 }
102 
103 }  // end namespace tok
104 }  // end namespace clang
105 
106 #endif
107