1 /*****************************************************************************/
5 /* Configuration file scanner for the sim65 6502 simulator */
9 /* (C) 1998-2002 Ullrich von Bassewitz */
11 /* D-70597 Stuttgart */
12 /* EMail: uz@musoftware.de */
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 /*****************************************************************************/
41 /*****************************************************************************/
43 /*****************************************************************************/
47 /* Config file tokens */
62 /* Special identifiers */
70 /* Mapping table entry, special identifier --> token */
71 typedef struct IdentTok IdentTok;
73 const char* Ident; /* Identifier */
74 cfgtok_t Tok; /* Token for identifier */
76 #define ENTRY_COUNT(s) (sizeof (s) / sizeof (s [0]))
80 /* Current token and attributes */
81 #define CFG_MAX_IDENT_LEN 255
82 extern cfgtok_t CfgTok;
83 extern char CfgSVal [CFG_MAX_IDENT_LEN+1];
84 extern unsigned long CfgIVal;
87 extern unsigned CfgErrorLine;
88 extern unsigned CfgErrorCol;
92 /*****************************************************************************/
94 /*****************************************************************************/
98 void CfgWarning (const char* Format, ...) attribute((format(printf,1,2)));
99 /* Print a warning message adding file name and line number of the config file */
101 void CfgError (const char* Format, ...) attribute((format(printf,1,2)));
102 /* Print an error message adding file name and line number of the config file */
104 void CfgNextTok (void);
105 /* Read the next token from the input stream */
107 void CfgConsume (cfgtok_t T, const char* Msg);
108 /* Skip a token, print an error message if not found */
110 void CfgConsumeSemi (void);
111 /* Consume a semicolon */
113 void CfgConsumeColon (void);
114 /* Consume a colon */
116 void CfgOptionalComma (void);
117 /* Consume a comma if there is one */
119 void CfgOptionalAssign (void);
120 /* Consume an equal sign if there is one */
122 void CfgAssureInt (void);
123 /* Make sure the next token is an integer */
125 void CfgAssureStr (void);
126 /* Make sure the next token is a string constant */
128 void CfgAssureIdent (void);
129 /* Make sure the next token is an identifier */
131 void CfgRangeCheck (unsigned long Lo, unsigned long Hi);
132 /* Check the range of CfgIVal */
134 void CfgSpecialToken (const IdentTok* Table, unsigned Size, const char* Name);
135 /* Map an identifier to one of the special tokens in the table */
137 void CfgBoolToken (void);
138 /* Map an identifier or integer to a boolean token */
140 void CfgSetName (const char* Name);
141 /* Set a name for a config file */
143 const char* CfgGetName (void);
144 /* Get the name of the config file */
146 void CfgSetBuf (const char* Buf);
147 /* Set a memory buffer for the config */
150 /* Return true if we have a configuration available */
152 void CfgOpenInput (void);
153 /* Open the input file if we have one */
155 void CfgCloseInput (void);
156 /* Close the input file if we have one */
160 /* End of scanner.h */