1 /*****************************************************************************/
5 /* Token list for the ca65 macroassembler */
9 /* (C) 2000-2011, Ullrich von Bassewitz */
10 /* Roemerstrasse 52 */
11 /* D-70794 Filderstadt */
12 /* EMail: uz@cc65.org */
15 /* This software is provided 'as-is', without any expressed or implied */
16 /* warranty. In no event will the authors be held liable for any damages */
17 /* arising from the use of this software. */
19 /* Permission is granted to anyone to use this software for any purpose, */
20 /* including commercial applications, and to alter it and redistribute it */
21 /* freely, subject to the following restrictions: */
23 /* 1. The origin of this software must not be misrepresented; you must not */
24 /* claim that you wrote the original software. If you use this software */
25 /* in a product, an acknowledgment in the product documentation would be */
26 /* appreciated but is not required. */
27 /* 2. Altered source versions must be plainly marked as such, and must not */
28 /* be misrepresented as being the original software. */
29 /* 3. This notice may not be removed or altered from any source */
32 /*****************************************************************************/
49 /*****************************************************************************/
51 /*****************************************************************************/
55 /* Struct holding a token */
56 typedef struct TokNode TokNode;
58 TokNode* Next; /* For single linked list */
59 Token T; /* Token value */
62 /* Struct holding a token list */
63 typedef struct TokList TokList;
65 TokList* Next; /* Single linked list (for replay) */
66 TokNode* Root; /* First node in list */
67 TokNode* Last; /* Last node in list or replay */
68 unsigned RepCount; /* Repeat counter (used for replay) */
69 unsigned RepMax; /* Maximum repeat count for replay */
70 unsigned Count; /* Token count */
71 void (*Check)(TokList*); /* Token check function */
72 void* Data; /* Additional data for check */
77 /* Return codes for TokCmp - higher numeric code means better match */
79 tcDifferent, /* Different tokents */
80 tcSameToken, /* Same token, different attribute */
81 tcIdentical /* Identical (token + attribute) */
86 /*****************************************************************************/
88 /*****************************************************************************/
92 TokNode* NewTokNode (void);
93 /* Create and return a token node with the current token value */
95 void FreeTokNode (TokNode* N);
96 /* Free the given token node */
98 void TokSet (TokNode* N, unsigned LineInfoSlot);
99 /* Set the scanner token from the given token node. The given line info slot
100 * is used to store the position of the token fed into the scanner.
103 enum TC TokCmp (const TokNode* N);
104 /* Compare the token given as parameter against the current token */
106 void InitTokList (TokList* T);
107 /* Initialize a token list structure for later use */
109 TokList* NewTokList (void);
110 /* Create a new, empty token list */
112 void FreeTokList (TokList* T);
113 /* Delete the token list including all token nodes */
115 token_t GetTokListTerm (token_t Term);
116 /* Determine if the following token list is enclosed in curly braces. This is
117 * the case if the next token is the opening brace. If so, skip it and return
118 * a closing brace, otherwise return Term.
121 void AddCurTok (TokList* T);
122 /* Add the current token to the token list */
124 void PushTokList (TokList* List, const char* Desc);
125 /* Push a token list to be used as input for InputFromStack. This includes
126 * several initializations needed in the token list structure, so don't use
127 * PushInput directly.
132 /* End of toklist.h */