2 * Command line utility for making sense of C declarations.
3 * Copyright © 2011 Nick Bowler
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, either version 3 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
33 static const char *progname = "cdecl99";
34 static const char sopts[] = "qbif:e:VH";
36 { PN_("longopt", "quiet"), 0, NULL, 'q' }, \
37 { PN_("longopt", "batch"), 0, NULL, 'b' }, \
38 { PN_("longopt", "interactive"), 0, NULL, 'i' }, \
39 { PN_("longopt", "file"), 1, NULL, 'f' }, \
40 { PN_("longopt", "execute"), 1, NULL, 'e' }, \
41 { PN_("longopt", "version"), 0, NULL, 'V' }, \
42 { PN_("longopt", "help"), 0, NULL, 'H' }
45 * With NLS, we need a buffer big enough to store the translated options.
46 * The translations will be filled in at program startup.
48 enum { NOPTS = sizeof (struct option[]){RAW_LOPTS} / sizeof (struct option) };
49 static struct option lopts[NOPTS + !!ENABLE_NLS * NOPTS + 1] = { RAW_LOPTS };
51 static void print_version(void)
54 /* TRANSLATORS: (C) must *always* be translated as ©. */
55 printf("Copyright %s 2011 Nick Bowler.\n", gettext("(C)"));
56 puts("License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.");
57 puts("This is free software: you are free to change and redistribute it.");
58 puts("There is NO WARRANTY, to the extent permitted by law.");
61 static void print_usage(FILE *f)
63 fprintf(f, "Usage: %s [options]\n", progname);
66 static void print_help(void)
69 puts("Detailed help coming soon.");
73 * Format a declaration according to the given function and return a pointer
74 * to the formatted string. The returned pointer remains valid until the
75 * next call, after which it must not be re-used.
77 * Returns NULL on failure.
80 do_format(size_t func(char *, size_t, struct cdecl *), struct cdecl *decl)
88 rc = func(buf, bufsz, decl);
92 tmp = realloc(buf, rc + 1);
94 fprintf(stderr, "failed to allocate memory\n");
106 static int cmd_explain(const char *cmd, const char *arg)
108 const struct cdecl_error *err;
113 decl = cdecl_parse_decl(arg);
115 err = cdecl_get_error();
116 fprintf(stderr, "%s\n", err->str);
120 for (struct cdecl *i = decl; i; i = i->next) {
121 str = do_format(cdecl_explain, i);
134 static int cmd_simplify(const char *cmd, const char *arg)
136 const struct cdecl_error *err;
141 decl = cdecl_parse_decl(arg);
143 err = cdecl_get_error();
144 fprintf(stderr, "%s\n", err->str);
148 for (struct cdecl *i = decl; i; i = i->next) {
149 struct cdecl_declspec *s = i->specifiers;
152 i->specifiers = NULL;
156 str = do_format(cdecl_declare, i);
173 static int cmd_declare(const char *cmd, const char *arg)
175 const struct cdecl_error *err;
180 /* The name of the command is significant here. */
181 decl = cdecl_parse_english(cmd);
183 err = cdecl_get_error();
184 fprintf(stderr, "%s\n", err->str);
189 * English parses have at most one full declarator, so no loop is
192 str = do_format(cdecl_declare, decl);
203 static int cmd_quit(const char *cmd, const char *arg)
208 static int cmd_help(const char *cmd, const char *arg);
210 static const struct command {
212 int (*func)(const char *cmd, const char *arg);
215 { "explain", cmd_explain, "Explain a C declaration." },
216 { "simplify", cmd_simplify, "Simplify a C declaration." },
217 { "declare", cmd_declare, "Construct a C declaration." },
218 { "type", cmd_declare, "Construct a C type name." },
219 { "help", cmd_help, "Print this list of commands." },
220 { "quit", cmd_quit, "Quit the program." },
221 { "exit", cmd_quit, NULL }
223 static const size_t ncommands = sizeof commands / sizeof commands[0];
225 static int cmd_help(const char *cmd, const char *arg)
227 for (size_t i = 0; i < ncommands; i++) {
228 if (!commands[i].blurb)
231 printf("%s -- %s\n", commands[i].name, commands[i].blurb);
238 * Ensure that the first n characters of str equal the entire (null-terminated)
241 static int cmd_cmp(const char *str, const char *cmd, size_t n)
243 size_t cmdlen = strlen(cmd);
249 return memcmp(str, cmd, n);
252 static int run_command(const char *line)
254 const char *cmd = line + strspn(line, " \t");
255 const char *arg = cmd + strcspn(cmd, " \t");
260 for (size_t i = 0; i < ncommands; i++) {
261 if (cmd_cmp(cmd, commands[i].name, arg-cmd) != 0)
264 return commands[i].func(cmd, arg);
267 fprintf(stderr, "Undefined command: %.*s\n", (int)(arg-cmd), cmd);
271 static int repl(void)
275 for (; (line = readline("> ")); free(line)) {
276 if (!run_command(line))
284 static int repl_cmdline(int argc, char **argv)
286 int opt, rc, ret = 0;
289 while ((opt = getopt_long(argc, argv, sopts, lopts, NULL)) != -1) {
293 rc = run_command(optarg);
303 static int repl_noninteractive(void)
305 int rc, ret = 0, saved_errno;
309 while (getline(&line, &n, stdin) >= 0) {
310 char *c = strchr(line, '\n');
314 rc = run_command(line);
326 perror("read error");
333 /* Initialize gettext and setup translated long options. */
334 static void init_i18n(void)
336 setlocale(LC_ALL, "");
337 bindtextdomain(PACKAGE, LOCALEDIR);
343 for (int i = 0; i < NOPTS; i++) {
344 lopts[i+NOPTS] = lopts[i];
345 lopts[i+NOPTS].name = pgettext_expr("longopt", lopts[i].name);
349 int main(int argc, char **argv)
351 bool show_intro = true, interactive = true, execute = false;
352 const char *filename = NULL;
360 while ((opt = getopt_long(argc, argv, sopts, lopts, NULL)) != -1) {
389 /* --filename and --execute imply --batch. */
390 if (filename || execute)
393 /* --batch implies --quiet */
394 if (interactive && show_intro)
397 /* --execute supersedes --filename */
398 if (filename && !execute) {
399 if (!freopen(filename, "r", stdin)) {
408 rc = repl_cmdline(argc, argv);
410 rc = repl_noninteractive();