]> git.saurik.com Git - bison.git/blame_incremental - src/symtab.c
Let symbols have a location.
[bison.git] / src / symtab.c
... / ...
CommitLineData
1/* Symbol table manager for Bison,
2 Copyright (C) 1984, 1989, 2000, 2001, 2002 Free Software Foundation, Inc.
3
4 This file is part of Bison, the GNU Compiler Compiler.
5
6 Bison is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
9 any later version.
10
11 Bison is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with Bison; see the file COPYING. If not, write to
18 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 Boston, MA 02111-1307, USA. */
20
21
22#include "system.h"
23#include "hash.h"
24#include "complain.h"
25#include "symtab.h"
26#include "gram.h"
27
28/*------------------------.
29| Distinguished symbols. |
30`------------------------*/
31
32symbol_t *errtoken = NULL;
33symbol_t *undeftoken = NULL;
34symbol_t *eoftoken = NULL;
35symbol_t *axiom = NULL;
36symbol_t *startsymbol = NULL;
37location_t startsymbol_location;
38
39/*---------------------------------.
40| Create a new symbol, named TAG. |
41`---------------------------------*/
42
43static symbol_t *
44symbol_new (const char *tag, location_t location)
45{
46 symbol_t *res = XMALLOC (symbol_t, 1);
47
48 res->tag = xstrdup (tag);
49 res->type_name = NULL;
50 res->location = location;
51 res->number = NUMBER_UNDEFINED;
52 res->prec = 0;
53 res->assoc = right_assoc;
54 res->user_token_number = USER_NUMBER_UNDEFINED;
55 res->alias = NULL;
56 res->class = unknown_sym;
57
58 nsyms++;
59 return res;
60}
61
62
63/*------------------------------------------------------------------.
64| Set the TYPE_NAME associated to SYMBOL. Does nothing if passed 0 |
65| as TYPE_NAME. |
66`------------------------------------------------------------------*/
67
68void
69symbol_type_set (symbol_t *symbol, char *type_name)
70{
71 if (type_name)
72 {
73 if (symbol->type_name)
74 complain (_("type redeclaration for %s"), symbol->tag);
75 symbol->type_name = type_name;
76 }
77}
78
79
80/*------------------------------------------------------------------.
81| Set the PRECEDENCE associated to SYMBOL. Does nothing if invoked |
82| with UNDEF_ASSOC as ASSOC. |
83`------------------------------------------------------------------*/
84
85void
86symbol_precedence_set (symbol_t *symbol,
87 int prec, associativity assoc)
88{
89 if (assoc != undef_assoc)
90 {
91 if (symbol->prec != 0)
92 complain (_("redefining precedence of %s"), symbol->tag);
93 symbol->prec = prec;
94 symbol->assoc = assoc;
95 }
96
97 /* Only terminals have a precedence. */
98 symbol_class_set (symbol, token_sym);
99}
100
101
102/*-------------------------------------.
103| Set the CLASS associated to SYMBOL. |
104`-------------------------------------*/
105
106void
107symbol_class_set (symbol_t *symbol, symbol_class class)
108{
109 if (symbol->class != unknown_sym && symbol->class != class)
110 complain (_("symbol %s redefined"), symbol->tag);
111
112 if (class == nterm_sym && symbol->class != nterm_sym)
113 symbol->number = nvars++;
114 else if (class == token_sym && symbol->number == NUMBER_UNDEFINED)
115 symbol->number = ntokens++;
116
117 symbol->class = class;
118}
119
120
121/*-------------------------------------------------.
122| Set the USER_TOKEN_NUMBER associated to SYMBOL. |
123`-------------------------------------------------*/
124
125void
126symbol_user_token_number_set (symbol_t *symbol, int user_token_number)
127{
128 assert (symbol->class == token_sym);
129
130 if (symbol->user_token_number != USER_NUMBER_UNDEFINED
131 && symbol->user_token_number != user_token_number)
132 complain (_("redefining user token number of %s"), symbol->tag);
133
134 symbol->user_token_number = user_token_number;
135 /* User defined EOF token? */
136 if (user_token_number == 0)
137 {
138 eoftoken = symbol;
139 eoftoken->number = 0;
140 /* It is always mapped to 0, so it was already counted in
141 NTOKENS. */
142 --ntokens;
143 }
144}
145
146
147/*------------.
148| Free THIS. |
149`------------*/
150
151static void
152symbol_free (symbol_t *this)
153{
154#if 0
155 /* This causes crashes because one string can appear more
156 than once. */
157 XFREE (this->type_name);
158#endif
159 XFREE (this->tag);
160 XFREE (this);
161}
162
163
164/*-----------------------------------------------------------.
165| If THIS is not defined, report an error, and consider it a |
166| nonterminal. |
167`-----------------------------------------------------------*/
168
169static bool
170symbol_check_defined (symbol_t *this)
171{
172 if (this->class == unknown_sym)
173 {
174 complain_at
175 (this->location,
176 _("symbol %s is used, but is not defined as a token and has no rules"),
177 this->tag);
178 this->class = nterm_sym;
179 this->number = nvars++;
180 }
181
182 return TRUE;
183}
184
185
186/*-------------------------------------------------------------------.
187| Declare the new SYMBOL. Make it an alias of SYMVAL, and type them |
188| with TYPENAME. |
189`-------------------------------------------------------------------*/
190
191void
192symbol_make_alias (symbol_t *symbol, symbol_t *symval)
193{
194 if (symval->alias)
195 warn (_("symbol `%s' used more than once as a literal string"),
196 symval->tag);
197 else if (symbol->alias)
198 warn (_("symbol `%s' given more than one literal string"),
199 symbol->tag);
200 else
201 {
202 symval->class = token_sym;
203 symval->user_token_number = symbol->user_token_number;
204 symbol->user_token_number = USER_NUMBER_ALIAS;
205 symval->alias = symbol;
206 symbol->alias = symval;
207 /* symbol and symval combined are only one symbol */
208 nsyms--;
209 ntokens--;
210 assert (ntokens == symbol->number || ntokens == symval->number);
211 symbol->number = symval->number =
212 (symval->number < symbol->number) ? symval->number : symbol->number;
213 }
214}
215
216
217/*---------------------------------------------------------.
218| Check that THIS, and its alias, have same precedence and |
219| associativity. |
220`---------------------------------------------------------*/
221
222static bool
223symbol_check_alias_consistence (symbol_t *this)
224{
225 /* Check only those who _are_ the aliases. */
226 if (this->alias && this->user_token_number == USER_NUMBER_ALIAS)
227 {
228 if (this->prec != this->alias->prec)
229 {
230 if (this->prec != 0 && this->alias->prec != 0)
231 complain (_("conflicting precedences for %s and %s"),
232 this->tag, this->alias->tag);
233 if (this->prec != 0)
234 this->alias->prec = this->prec;
235 else
236 this->prec = this->alias->prec;
237 }
238
239 if (this->assoc != this->alias->assoc)
240 {
241 /* FIXME: For some reason (probably the S/R => keep the S),
242 the right assoc is chosen has the ``not set''. This is
243 not nice, fix this! */
244 if (this->assoc != right_assoc
245 && this->alias->assoc != right_assoc)
246 complain (_("conflicting associativities for %s and %s"),
247 this->tag, this->alias->tag);
248 if (this->assoc != 0)
249 this->alias->assoc = this->assoc;
250 else
251 this->assoc = this->alias->assoc;
252 }
253 }
254 return TRUE;
255}
256
257
258/*-------------------------------------------------------------------.
259| Assign a symbol number, and write the definition of the token name |
260| into FDEFINES. Put in SYMBOLS. |
261`-------------------------------------------------------------------*/
262
263static bool
264symbol_pack (symbol_t *this)
265{
266 if (this->class == nterm_sym)
267 {
268 this->number += ntokens;
269 }
270 else if (this->alias)
271 {
272 /* This symbol and its alias are a single token defn.
273 Allocate a tokno, and assign to both check agreement of
274 prec and assoc fields and make both the same */
275 if (this->number == NUMBER_UNDEFINED)
276 {
277 if (this == eoftoken || this->alias == eoftoken)
278 this->number = this->alias->number = 0;
279 else
280 {
281 assert (this->alias->number != NUMBER_UNDEFINED);
282 this->number = this->alias->number;
283 }
284 }
285 /* Do not do processing below for USER_NUMBER_ALIASs. */
286 if (this->user_token_number == USER_NUMBER_ALIAS)
287 return TRUE;
288 }
289 else /* this->class == token_sym */
290 {
291 assert (this->number != NUMBER_UNDEFINED);
292 }
293
294 symbols[this->number] = this;
295 return TRUE;
296}
297
298
299
300
301/*--------------------------------------------------.
302| Put THIS in TOKEN_TRANSLATIONS if it is a token. |
303`--------------------------------------------------*/
304
305static bool
306symbol_translation (symbol_t *this)
307{
308 /* Non-terminal? */
309 if (this->class == token_sym
310 && this->user_token_number != USER_NUMBER_ALIAS)
311 {
312 /* A token which translation has already been set? */
313 if (token_translations[this->user_token_number] != undeftoken->number)
314 complain (_("tokens %s and %s both assigned number %d"),
315 symbols[token_translations[this->user_token_number]]->tag,
316 this->tag, this->user_token_number);
317
318 token_translations[this->user_token_number] = this->number;
319 }
320
321 return TRUE;
322}
323
324
325/*----------------------.
326| A symbol hash table. |
327`----------------------*/
328
329/* Initial capacity of symbols hash table. */
330#define HT_INITIAL_CAPACITY 257
331
332static struct hash_table *symbol_table = NULL;
333
334static bool
335hash_compare_symbol_t (const symbol_t *m1, const symbol_t *m2)
336{
337 return strcmp (m1->tag, m2->tag) ? FALSE : TRUE;
338}
339
340static unsigned int
341hash_symbol_t (const symbol_t *m, unsigned int tablesize)
342{
343 return hash_string (m->tag, tablesize);
344}
345
346
347/*-------------------------------.
348| Create the symbol hash table. |
349`-------------------------------*/
350
351void
352symbols_new (void)
353{
354 symbol_table = hash_initialize (HT_INITIAL_CAPACITY,
355 NULL,
356 (Hash_hasher) hash_symbol_t,
357 (Hash_comparator) hash_compare_symbol_t,
358 (Hash_data_freer) symbol_free);
359}
360
361
362/*----------------------------------------------------------------.
363| Find the symbol named KEY, and return it. If it does not exist |
364| yet, create it. |
365`----------------------------------------------------------------*/
366
367symbol_t *
368getsym (const char *key, location_t location)
369{
370 symbol_t probe;
371 symbol_t *entry;
372
373 (const char *) probe.tag = key;
374 entry = hash_lookup (symbol_table, &probe);
375
376 if (!entry)
377 {
378 /* First insertion in the hash. */
379 entry = symbol_new (key, location);
380 hash_insert (symbol_table, entry);
381 }
382 return entry;
383}
384
385
386/*-------------------.
387| Free the symbols. |
388`-------------------*/
389
390void
391symbols_free (void)
392{
393 hash_free (symbol_table);
394}
395
396
397/*---------------------------------------------------------------.
398| Look for undefined symbols, report an error, and consider them |
399| terminals. |
400`---------------------------------------------------------------*/
401
402void
403symbols_do (symbol_processor processor, void *processor_data)
404{
405 hash_do_for_each (symbol_table,
406 (Hash_processor) processor,
407 processor_data);
408}
409
410
411/*--------------------------------------------------------------.
412| Check that all the symbols are defined. Report any undefined |
413| symbols and consider them nonterminals. |
414`--------------------------------------------------------------*/
415
416void
417symbols_check_defined (void)
418{
419 symbols_do (symbol_check_defined, NULL);
420}
421
422/*------------------------------------------------------------------.
423| Set TOKEN_TRANSLATIONS. Check that no two symbols share the same |
424| number. |
425`------------------------------------------------------------------*/
426
427static void
428symbols_token_translations_init (void)
429{
430 int num_256_available_p = TRUE;
431 int i;
432
433 /* Find the highest user token number, and whether 256, the POSIX
434 preferred user token number for the error token, is used. */
435 max_user_token_number = 0;
436 for (i = 0; i < ntokens; ++i)
437 {
438 symbol_t *this = symbols[i];
439 if (this->user_token_number != USER_NUMBER_UNDEFINED)
440 {
441 if (this->user_token_number > max_user_token_number)
442 max_user_token_number = this->user_token_number;
443 if (this->user_token_number == 256)
444 num_256_available_p = FALSE;
445 }
446 }
447
448 /* If 256 is not used, assign it to error, to follow POSIX. */
449 if (num_256_available_p
450 && errtoken->user_token_number == USER_NUMBER_UNDEFINED)
451 errtoken->user_token_number = 256;
452
453 /* Set the missing user numbers. */
454 if (max_user_token_number < 256)
455 max_user_token_number = 256;
456
457 for (i = 0; i < ntokens; ++i)
458 {
459 symbol_t *this = symbols[i];
460 if (this->user_token_number == USER_NUMBER_UNDEFINED)
461 this->user_token_number = ++max_user_token_number;
462 if (this->user_token_number > max_user_token_number)
463 max_user_token_number = this->user_token_number;
464 }
465
466 token_translations = XCALLOC (symbol_number_t, max_user_token_number + 1);
467
468 /* Initialize all entries for literal tokens to 2, the internal
469 token number for $undefined., which represents all invalid
470 inputs. */
471 for (i = 0; i < max_user_token_number + 1; i++)
472 token_translations[i] = undeftoken->number;
473 symbols_do (symbol_translation, NULL);
474}
475
476
477/*----------------------------------------------------------------.
478| Assign symbol numbers, and write definition of token names into |
479| FDEFINES. Set up vectors SYMBOL_TABLE, TAGS of symbols. |
480`----------------------------------------------------------------*/
481
482void
483symbols_pack (void)
484{
485 symbols = XCALLOC (symbol_t *, nsyms);
486
487 symbols_do (symbol_check_alias_consistence, NULL);
488 symbols_do (symbol_pack, NULL);
489
490 symbols_token_translations_init ();
491
492 if (startsymbol->class == unknown_sym)
493 fatal_at (startsymbol_location,
494 _("the start symbol %s is undefined"), startsymbol->tag);
495 else if (startsymbol->class == token_sym)
496 fatal_at (startsymbol_location,
497 _("the start symbol %s is a token"), startsymbol->tag);
498}