]>
Commit | Line | Data |
---|---|---|
1 | /* Keeping a unique copy of strings. | |
2 | ||
3 | Copyright (C) 2002-2003, 2008-2015 Free Software Foundation, Inc. | |
4 | ||
5 | This file is part of Bison, the GNU Compiler Compiler. | |
6 | ||
7 | This program is free software: you can redistribute it and/or modify | |
8 | it under the terms of the GNU General Public License as published by | |
9 | the Free Software Foundation, either version 3 of the License, or | |
10 | (at your option) any later version. | |
11 | ||
12 | This program is distributed in the hope that it will be useful, | |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ | |
19 | ||
20 | #ifndef UNIQSTR_H_ | |
21 | # define UNIQSTR_H_ | |
22 | ||
23 | # include <stdio.h> | |
24 | ||
25 | /*-----------------------------------------. | |
26 | | Pointers to unique copies of C strings. | | |
27 | `-----------------------------------------*/ | |
28 | ||
29 | typedef char const *uniqstr; | |
30 | ||
31 | /* Return the uniqstr for STR. */ | |
32 | uniqstr uniqstr_new (char const *str); | |
33 | ||
34 | /* Return a uniqstr built by vsprintf. In order to simply concatenate | |
35 | strings, use UNIQSTR_CONCAT, which is a convenient wrapper around | |
36 | this function. */ | |
37 | uniqstr uniqstr_vsprintf (char const *format, ...) | |
38 | _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2); | |
39 | ||
40 | /* Two uniqstr values have the same value iff they are the same. */ | |
41 | # define UNIQSTR_EQ(Ustr1, Ustr2) (!!((Ustr1) == (Ustr2))) | |
42 | ||
43 | /* Compare two uniqstr a la strcmp: negative for <, nul for =, and | |
44 | positive for >. Undefined order, relies on addresses. */ | |
45 | int uniqstr_cmp (uniqstr u1, uniqstr u2); | |
46 | ||
47 | /* Die if STR is not a uniqstr. */ | |
48 | void uniqstr_assert (char const *str); | |
49 | ||
50 | /*----------------. | |
51 | | Concatenation. | | |
52 | `----------------*/ | |
53 | ||
54 | /* Concatenate at most 20 strings and return a uniqstr. The goal of | |
55 | this macro is to make the caller's code a little more succinct | |
56 | without a trivial uniqstr_vsprintf format string to maintain | |
57 | (for example, "%s%s%s") while still benefitting from gcc's type | |
58 | checking. Unfortunately, because of the missing format string in the | |
59 | macro invocation, the argument number reported by gcc for a bad | |
60 | argument type is 1 too large. */ | |
61 | # define UNIQSTR_CONCAT(...) \ | |
62 | uniqstr_vsprintf (UNIQSTR_GEN_FORMAT (__VA_ARGS__, \ | |
63 | "%s", "%s", "%s", "%s", "%s", \ | |
64 | "%s", "%s", "%s", "%s", "%s", \ | |
65 | "%s", "%s", "%s", "%s", "%s", \ | |
66 | "%s", "%s", "%s", "%s", "%s"), \ | |
67 | __VA_ARGS__) | |
68 | ||
69 | # define UNIQSTR_GEN_FORMAT(F1, F2, F3, F4, F5, \ | |
70 | F6, F7, F8, F9, F10, \ | |
71 | F11, F12, F13, F14, F15, \ | |
72 | F16, F17, F18, F19, F20, \ | |
73 | ...) \ | |
74 | UNIQSTR_GEN_FORMAT_ (__VA_ARGS__, \ | |
75 | "", "", "", "", "", \ | |
76 | "", "", "", "", "", \ | |
77 | "", "", "", "", "", \ | |
78 | "", "", "", "", "") | |
79 | ||
80 | # define UNIQSTR_GEN_FORMAT_(F1, F2, F3, F4, F5, \ | |
81 | F6, F7, F8, F9, F10, \ | |
82 | F11, F12, F13, F14, F15, \ | |
83 | F16, F17, F18, F19, F20, ...) \ | |
84 | F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 \ | |
85 | F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 | |
86 | ||
87 | /*--------------------. | |
88 | | Table of uniqstrs. | | |
89 | `--------------------*/ | |
90 | ||
91 | /* Create the string table. */ | |
92 | void uniqstrs_new (void); | |
93 | ||
94 | /* Free all the memory allocated for symbols. */ | |
95 | void uniqstrs_free (void); | |
96 | ||
97 | /* Report them all. */ | |
98 | void uniqstrs_print (void); | |
99 | ||
100 | #endif /* ! defined UNIQSTR_H_ */ |