1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
/*
* Copyright (c) 1998-2003, Darren Hiebert
*
* This source code is released for free distribution under the terms of the
* GNU General Public License version 2 or (at your option) any later version.
*
* Private definitions for parsing support.
*/
#ifndef CTAGS_MAIN_PARSE_H
#define CTAGS_MAIN_PARSE_H
/*
* INCLUDE FILES
*/
#include "general.h" /* must always come first */
#include "types.h"
#include "kind.h"
#include "lregex.h"
#include "lxpath.h"
/*
* MACROS
*/
#define LANG_AUTO (-1)
#define LANG_IGNORE (-2)
/*
* DATA DECLARATIONS
*/
typedef enum {
RESCAN_NONE, /* No rescan needed */
RESCAN_FAILED, /* Scan failed, clear out tags added, rescan */
RESCAN_APPEND /* Scan succeeded, rescan */
} rescanReason;
typedef void (*createRegexTag) (const vString* const name);
typedef void (*simpleParser) (void);
typedef rescanReason (*rescanParser) (const unsigned int passCount);
typedef void (*parserInitialize) (langType language);
/* Per language finalizer is called anytime when ctags exits.
(Exceptions are a kind of options are given when invoked. Here
options are: --version, --help, --list-*, and so on.)
The finalizer is called even when the initializer of the
same parser is called or not. However, the finalizer can know
whether the associated initializer is invoked or not with the
second parameter: INITIALIZED. If it is true, the initializer
is called. */
typedef void (*parserFinalize) (langType language, bool initialized);
typedef enum {
METHOD_NOT_CRAFTED = 1 << 0,
METHOD_REGEX = 1 << 1,
METHOD_XPATH = 1 << 2,
} parsingMethod;
typedef struct {
const char *name;
const int id;
} keywordTable;
struct sParserDefinition {
/* defined by parser */
char* name; /* name of language */
kindDefinition* kindTable; /* tag kinds handled by parser */
unsigned int kindCount; /* size of `kinds' list */
const char *const *extensions; /* list of default extensions */
const char *const *patterns; /* list of default file name patterns */
const char *const *aliases; /* list of default aliases (alternative names) */
parserInitialize initialize; /* initialization routine, if needed */
parserFinalize finalize; /* finalize routine, if needed */
simpleParser parser; /* simple parser (common case) */
rescanParser parser2; /* rescanning parser (unusual case) */
selectLanguage* selectLanguage; /* may be used to resolve conflicts */
unsigned int method; /* See METHOD_ definitions above */
bool useCork;
bool useMemoryStreamInput;
bool allowNullTag;
bool requestAutomaticFQTag;
tagRegexTable *tagRegexTable;
unsigned int tagRegexCount;
const keywordTable *keywordTable;
unsigned int keywordCount;
tagXpathTableTable *tagXpathTableTable;
unsigned int tagXpathTableCount;
bool invisible;
fieldDefinition *fieldTable;
unsigned int fieldCount;
xtagDefinition *xtagTable;
unsigned int xtagCount;
parserDependency * dependencies;
unsigned int dependencyCount;
parameterHandlerTable *parameterHandlerTable;
unsigned int parameterHandlerCount;
xpathFileSpec *xpathFileSpecs;
unsigned int xpathFileSpecCount;
/* used internally */
langType id; /* id assigned to language */
unsigned int enabled:1; /* currently enabled? */
unsigned int traced:1;
};
typedef parserDefinition* (parserDefinitionFunc) (void);
/*
* FUNCTION PROTOTYPES
*/
/* Language processing and parsing */
extern int makeSimpleTag (const vString* const name, const int kindIndex);
extern int makeSimpleRefTag (const vString* const name, const int kindIndex,
int roleIndex);
extern parserDefinition* parserNew (const char* name);
extern const char *getLanguageName (const langType language);
extern const char *getLanguageKindName (const langType language, const int kindIndex);
extern langType getNamedLanguage (const char *const name, size_t len);
extern langType getLanguageForFilenameAndContents (const char *const fileName);
extern langType getLanguageForCommand (const char *const command, langType startFrom);
extern langType getLanguageForFilename (const char *const filename, langType startFrom);
extern bool isLanguageEnabled (const langType language);
extern bool isLanguageKindEnabled (const langType language, int kindIndex);
extern bool isLanguageRoleEnabled (const langType language, int kindIndex, int roleIndex);
extern kindDefinition* getLanguageKindForLetter (const langType language, char kindLetter);
extern void initializeParser (langType language);
#ifdef HAVE_ICONV
extern const char *getLanguageEncoding (const langType language);
#endif
/* Regex interface */
extern void addLanguageCallbackRegex (const langType language, const char *const regex, const char *const flags,
const regexCallback callback, bool *disabled, void *userData);
extern void findRegexTagsMainloop (int (* driver)(void));
extern void findRegexTags (void);
/* Multiline Regex Interface */
extern void addLanguageRegexTable (const langType language, const char *name);
extern void addLanguageTagMultiTableRegex(const langType language,
const char* const table_name,
const char* const regex,
const char* const name, const char* const kinds, const char* const flags,
bool *disabled);
extern void anonGenerate (vString *buffer, const char *prefix, int kind);
extern void anonHashString (const char *filename, char buf[9]);
#endif /* CTAGS_MAIN_PARSE_H */
|
