1 /* Part of CPP library. (Macro and #define handling.)
2 Copyright (C) 1986, 1987, 1989, 1992, 1993, 1994, 1995, 1996, 1998,
3 1999, 2000, 2001 Free Software Foundation, Inc.
4 Written by Per Bothner, 1994.
5 Based on CCCP program by Paul Rubin, June 1986
6 Adapted to ANSI C, Richard Stallman, Jan 1987
8 This program is free software; you can redistribute it and/or modify it
9 under the terms of the GNU General Public License as published by the
10 Free Software Foundation; either version 2, or (at your option) any
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
22 In other words, you are welcome to use, share and improve this program.
23 You are forbidden to forbid anyone else to use, share and improve
24 what you give them. Help stamp out software-hoarding! */
28 #include "intl.h" /* for _("<command line>") below. */
34 cpp_hashnode **params; /* Parameters, if any. */
35 cpp_token *expansion; /* First token of replacement list. */
36 unsigned int line; /* Starting line number. */
37 unsigned int count; /* Number of tokens in expansion. */
38 unsigned short paramc; /* Number of parameters. */
39 unsigned int fun_like : 1; /* If a function-like macro. */
40 unsigned int variadic : 1; /* If a variadic macro. */
41 unsigned int disabled : 1; /* If macro is disabled. */
42 unsigned int syshdr : 1; /* If macro defined in system header. */
45 typedef struct macro_arg macro_arg;
48 cpp_token *first; /* First token in unexpanded argument. */
49 cpp_token *expanded; /* Macro-expanded argument. */
50 cpp_token *stringified; /* Stringified argument. */
51 unsigned int count; /* # of tokens in argument. */
52 unsigned int expanded_count; /* # of tokens in expanded argument. */
55 /* Macro expansion. */
57 static void lock_pools PARAMS ((cpp_reader *));
58 static void unlock_pools PARAMS ((cpp_reader *));
59 static int enter_macro_context PARAMS ((cpp_reader *, cpp_hashnode *));
60 static void builtin_macro PARAMS ((cpp_reader *, cpp_token *));
61 static cpp_context *push_arg_context PARAMS ((cpp_reader *, macro_arg *));
62 static enum cpp_ttype parse_arg PARAMS ((cpp_reader *, macro_arg *, int));
63 static macro_arg *parse_args PARAMS ((cpp_reader *, const cpp_hashnode *));
64 static cpp_context *next_context PARAMS ((cpp_reader *));
65 static void expand_arg PARAMS ((cpp_reader *, macro_arg *));
66 static unsigned char *quote_string PARAMS ((unsigned char *,
67 const unsigned char *,
69 static void make_string_token PARAMS ((cpp_pool *, cpp_token *,
70 const U_CHAR *, unsigned int));
71 static void make_number_token PARAMS ((cpp_reader *, cpp_token *, int));
72 static void stringify_arg PARAMS ((cpp_reader *, macro_arg *));
73 static void paste_all_tokens PARAMS ((cpp_reader *, cpp_token *));
74 static int paste_tokens PARAMS ((cpp_reader *, cpp_token *, cpp_token *));
75 static int funlike_invocation_p PARAMS ((cpp_reader *, const cpp_hashnode *,
77 static void replace_args PARAMS ((cpp_reader *, cpp_macro *, macro_arg *,
82 static void save_lookahead_token PARAMS ((cpp_reader *, const cpp_token *));
83 static void take_lookahead_token PARAMS ((cpp_reader *, cpp_token *));
84 static cpp_lookahead *alloc_lookahead PARAMS ((cpp_reader *));
85 static void free_lookahead PARAMS ((cpp_lookahead *));
87 /* #define directive parsing and handling. */
89 static cpp_token *lex_expansion_token PARAMS ((cpp_reader *, cpp_macro *));
90 static int warn_of_redefinition PARAMS ((cpp_reader *, const cpp_hashnode *,
92 static int save_parameter PARAMS ((cpp_reader *, cpp_macro *, cpp_hashnode *));
93 static int parse_params PARAMS ((cpp_reader *, cpp_macro *));
94 static void check_trad_stringification PARAMS ((cpp_reader *,
98 /* Allocates a buffer to hold a token's TEXT, and converts TOKEN to a
99 CPP_STRING token containing TEXT in quoted form. */
101 make_string_token (pool, token, text, len)
107 U_CHAR *buf = _cpp_pool_alloc (pool, len * 4 + 1);
109 token->type = CPP_STRING;
110 token->val.str.text = buf;
111 token->val.str.len = quote_string (buf, text, len) - buf;
112 buf[token->val.str.len] = '\0';
116 /* Allocates and converts a temporary token to a CPP_NUMBER token,
117 evaluating to NUMBER. */
119 make_number_token (pfile, token, number)
124 unsigned char *buf = _cpp_pool_alloc (&pfile->ident_pool, 20);
126 sprintf ((char *) buf, "%d", number);
127 token->type = CPP_NUMBER;
128 token->val.str.text = buf;
129 token->val.str.len = ustrlen (buf);
133 static const char * const monthnames[] =
135 "Jan", "Feb", "Mar", "Apr", "May", "Jun",
136 "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
139 /* Handle builtin macros like __FILE__. */
141 builtin_macro (pfile, token)
145 unsigned char flags = ((token->flags & PREV_WHITE) | AVOID_LPASTE);
146 cpp_hashnode *node = token->val.node;
148 switch (node->value.builtin)
154 const struct line_map *map = pfile->map;
156 if (node->value.builtin == BT_BASE_FILE)
157 while (! MAIN_FILE_P (map))
158 map = INCLUDED_FROM (&pfile->line_maps, map);
161 make_string_token (&pfile->ident_pool, token,
162 (const unsigned char *) name, strlen (name));
166 case BT_INCLUDE_LEVEL:
167 /* pfile->include_depth counts the primary source as level 1,
168 but historically __INCLUDE_DEPTH__ has called the primary
170 make_number_token (pfile, token, pfile->include_depth - 1);
174 /* If __LINE__ is embedded in a macro, it must expand to the
175 line of the macro's invocation, not its definition.
176 Otherwise things like assert() will not work properly. */
177 make_number_token (pfile, token,
178 SOURCE_LINE (pfile->map, cpp_get_line (pfile)->line));
183 int stdc = (!CPP_IN_SYSTEM_HEADER (pfile)
184 || pfile->spec_nodes.n__STRICT_ANSI__->type != NT_VOID);
185 make_number_token (pfile, token, stdc);
191 if (pfile->date.type == CPP_EOF)
193 /* Allocate __DATE__ and __TIME__ from permanent storage,
194 and save them in pfile so we don't have to do this again.
195 We don't generate these strings at init time because
196 time() and localtime() are very slow on some systems. */
197 time_t tt = time (NULL);
198 struct tm *tb = localtime (&tt);
200 make_string_token (&pfile->ident_pool, &pfile->date,
202 make_string_token (&pfile->ident_pool, &pfile->time,
205 sprintf ((char *) pfile->date.val.str.text, "%s %2d %4d",
206 monthnames[tb->tm_mon], tb->tm_mday, tb->tm_year + 1900);
207 sprintf ((char *) pfile->time.val.str.text, "%02d:%02d:%02d",
208 tb->tm_hour, tb->tm_min, tb->tm_sec);
210 *token = node->value.builtin == BT_DATE ? pfile->date: pfile->time;
214 cpp_ice (pfile, "invalid builtin macro \"%s\"", NODE_NAME (node));
218 token->flags = flags;
221 /* Used by cpperror.c to obtain the correct line and column to report
223 const cpp_lexer_pos *
227 return &pfile->lexer_pos;
234 _cpp_lock_pool (&pfile->argument_pool);
241 _cpp_unlock_pool (&pfile->argument_pool);
244 /* Adds backslashes before all backslashes and double quotes appearing
245 in strings. Non-printable characters are converted to octal. */
247 quote_string (dest, src, len)
256 if (c == '\\' || c == '"')
267 sprintf ((char *) dest, "\\%03o", c);
276 /* Convert a token sequence to a single string token according to the
277 rules of the ISO C #-operator. */
279 stringify_arg (pfile, arg)
283 cpp_pool *pool = &pfile->ident_pool;
284 unsigned char *start = POOL_FRONT (pool);
285 unsigned int i, escape_it, total_len = 0, backslash_count = 0;
287 /* Loop, reading in the argument's tokens. */
288 for (i = 0; i < arg->count; i++)
291 const cpp_token *token = &arg->first[i];
292 unsigned int len = cpp_token_len (token);
294 escape_it = (token->type == CPP_STRING || token->type == CPP_WSTRING
295 || token->type == CPP_CHAR || token->type == CPP_WCHAR);
298 /* Worst case is each char is octal. */
300 len += 2; /* Room for initial space and final NUL. */
302 dest = &start[total_len];
303 if (dest + len > POOL_LIMIT (pool))
305 _cpp_next_chunk (pool, len, (unsigned char **) &start);
306 dest = &start[total_len];
309 /* No leading white space. */
310 if (token->flags & PREV_WHITE && total_len > 0)
315 unsigned char *buf = (unsigned char *) xmalloc (len);
317 len = cpp_spell_token (pfile, token, buf) - buf;
318 dest = quote_string (dest, buf, len);
322 dest = cpp_spell_token (pfile, token, dest);
323 total_len = dest - start;
325 if (token->type == CPP_OTHER && token->val.c == '\\')
331 /* Ignore the final \ of invalid string literals. */
332 if (backslash_count & 1)
334 cpp_warning (pfile, "invalid string literal, ignoring final '\\'");
338 /* Null terminate, and commit the memory. */
339 start[total_len] = '\0';
340 POOL_COMMIT (pool, total_len + 1);
342 arg->stringified = xnew (cpp_token);
343 arg->stringified->flags = 0;
344 arg->stringified->type = CPP_STRING;
345 arg->stringified->val.str.text = start;
346 arg->stringified->val.str.len = total_len;
349 /* Try to paste two tokens. On success, the LHS becomes the pasted
350 token, and 0 is returned. For failure, we update the flags of the
351 RHS appropriately and return non-zero. */
353 paste_tokens (pfile, lhs, rhs)
355 cpp_token *lhs, *rhs;
361 type = cpp_can_paste (pfile, lhs, rhs, &digraph);
365 /* Mandatory warning for all apart from assembler. */
366 if (CPP_OPTION (pfile, lang) != CLK_ASM)
368 "pasting \"%s\" and \"%s\" does not give a valid preprocessing token",
369 cpp_token_as_text (pfile, lhs),
370 cpp_token_as_text (pfile, rhs));
372 /* The standard states that behaviour is undefined. By the
373 principle of least surpise, we step back before the RHS, and
374 mark it to prevent macro expansion. Tests in the testsuite
375 rely on clearing PREV_WHITE here, though you could argue we
376 should actually set it. Assembler can have '.' in labels and
377 so requires that we don't insert spaces there. Maybe we should
378 change this to put out a space unless it's assembler. */
379 rhs->flags &= ~PREV_WHITE;
380 rhs->flags |= NO_EXPAND;
384 flags = lhs->flags & ~DIGRAPH;
388 /* Identifiers and numbers need spellings to be pasted. */
389 if (type == CPP_NAME || type == CPP_NUMBER)
391 unsigned int total_len = cpp_token_len (lhs) + cpp_token_len (rhs);
392 unsigned char *result, *end;
394 result = _cpp_pool_alloc (&pfile->ident_pool, total_len + 1);
396 /* Paste the spellings and null terminate. */
397 end = cpp_spell_token (pfile, rhs, cpp_spell_token (pfile, lhs, result));
399 total_len = end - result;
401 if (type == CPP_NAME)
403 lhs->val.node = cpp_lookup (pfile, result, total_len);
404 if (lhs->val.node->flags & NODE_OPERATOR)
407 lhs->type = lhs->val.node->value.operator;
412 lhs->val.str.text = result;
413 lhs->val.str.len = total_len;
416 else if (type == CPP_WCHAR || type == CPP_WSTRING)
417 lhs->val.str = rhs->val.str;
419 /* Set type and flags after pasting spellings. */
426 /* Handles an arbitrarily long sequence of ## operators. This
427 implementation is left-associative, non-recursive, and finishes a
428 paste before handling succeeding ones. If the paste fails, we back
429 up a token to just after the ## operator, with the effect that it
430 appears in the output stream normally. */
432 paste_all_tokens (pfile, lhs)
437 unsigned char orig_flags = lhs->flags;
441 /* Take the token directly from the current context. We can do
442 this, because we are in the replacement list of either an
443 object-like macro, or a function-like macro with arguments
444 inserted. In either case, the constraints to #define
445 guarantee we have at least one more token. */
446 rhs = pfile->context->list.first++;
447 if (paste_tokens (pfile, lhs, rhs))
449 /* We failed. Step back so we read the RHS in next. */
450 pfile->context->list.first--;
454 while (rhs->flags & PASTE_LEFT);
456 /* The pasted token has the PREV_WHITE flag of the LHS, is no longer
457 PASTE_LEFT, and is subject to macro expansion. */
458 lhs->flags &= ~(PREV_WHITE | PASTE_LEFT | NO_EXPAND);
459 lhs->flags |= orig_flags & (PREV_WHITE | AVOID_LPASTE);
462 /* Reads the unexpanded tokens of a macro argument into ARG. VAR_ARGS
463 is non-zero if this is a variadic macro. Returns the type of the
464 token that caused reading to finish. */
465 static enum cpp_ttype
466 parse_arg (pfile, arg, variadic)
468 struct macro_arg *arg;
471 enum cpp_ttype result;
472 unsigned int paren = 0;
475 arg->first = (cpp_token *) POOL_FRONT (&pfile->argument_pool);
476 for (;; arg->count++)
478 cpp_token *token = &arg->first[arg->count];
479 if ((unsigned char *) (token + 1) >= POOL_LIMIT (&pfile->argument_pool))
481 _cpp_next_chunk (&pfile->argument_pool, sizeof (cpp_token),
482 (unsigned char **) &arg->first);
483 token = &arg->first[arg->count];
486 /* Newlines in arguments are white space (6.10.3.10). */
488 cpp_get_token (pfile, token);
489 if (line != pfile->line)
490 token->flags |= PREV_WHITE;
492 result = token->type;
493 if (result == CPP_OPEN_PAREN)
495 else if (result == CPP_CLOSE_PAREN && paren-- == 0)
497 /* Commas are not terminators within parantheses or variadic. */
498 else if (result == CPP_COMMA && paren == 0 && !variadic)
500 else if (result == CPP_EOF)
501 break; /* Error reported by caller. */
504 /* Commit the memory used to store the arguments. */
505 POOL_COMMIT (&pfile->argument_pool, arg->count * sizeof (cpp_token));
510 /* Parse the arguments making up a macro invocation. */
512 parse_args (pfile, node)
514 const cpp_hashnode *node;
516 cpp_macro *macro = node->value.macro;
517 macro_arg *args, *cur;
521 /* Allocate room for at least one argument, and zero it out. */
522 argc = macro->paramc ? macro->paramc: 1;
523 args = xcnewvec (macro_arg, argc);
525 for (cur = args, argc = 0; ;)
529 type = parse_arg (pfile, cur, argc == macro->paramc && macro->variadic);
530 if (type == CPP_CLOSE_PAREN || type == CPP_EOF)
533 /* Re-use the last argument for excess arguments. */
534 if (argc < macro->paramc)
540 cpp_error (pfile, "unterminated argument list invoking macro \"%s\"",
544 else if (argc < macro->paramc)
546 /* As an extension, a rest argument is allowed to not appear in
547 the invocation at all.
548 e.g. #define debug(format, args...) something
551 This is exactly the same as if there had been an empty rest
552 argument - debug("string", ). */
554 if (argc + 1 == macro->paramc && macro->variadic)
556 if (CPP_PEDANTIC (pfile) && ! macro->syshdr)
557 cpp_pedwarn (pfile, "ISO C99 requires rest arguments to be used");
562 "macro \"%s\" requires %u arguments, but only %u given",
563 NODE_NAME (node), macro->paramc, argc);
567 else if (argc > macro->paramc)
569 /* Empty argument to a macro taking no arguments is OK. */
570 if (argc != 1 || cur->count)
573 "macro \"%s\" passed %u arguments, but takes just %u",
574 NODE_NAME (node), argc, macro->paramc);
589 funlike_invocation_p (pfile, node, list)
591 const cpp_hashnode *node;
592 struct toklist *list;
595 cpp_token maybe_paren;
597 cpp_lexer_pos macro_pos;
599 macro_pos = pfile->lexer_pos;
600 pfile->state.parsing_args = 1;
601 pfile->state.prevent_expansion++;
602 orig = pfile->context;
604 cpp_start_lookahead (pfile);
605 cpp_get_token (pfile, &maybe_paren);
606 cpp_stop_lookahead (pfile, maybe_paren.type == CPP_OPEN_PAREN);
607 pfile->state.parsing_args = 2;
609 if (maybe_paren.type == CPP_OPEN_PAREN)
610 args = parse_args (pfile, node);
611 else if (CPP_WTRADITIONAL (pfile) && ! node->value.macro->syshdr)
613 "function-like macro \"%s\" must be used with arguments in traditional C",
616 /* Restore original context. */
617 pfile->context = orig;
618 pfile->state.prevent_expansion--;
619 pfile->state.parsing_args = 0;
621 /* Reset the position in case of failure. If success, the macro's
622 expansion appears where the name would have. */
623 pfile->lexer_pos = macro_pos;
627 if (node->value.macro->paramc > 0)
629 /* Don't save tokens during pre-expansion. */
630 struct cpp_lookahead *la_saved = pfile->la_write;
632 replace_args (pfile, node->value.macro, args, list);
633 pfile->la_write = la_saved;
641 /* Push the context of a macro onto the context stack. TOKEN is the
642 macro name. If we can successfully start expanding the macro,
643 TOKEN is replaced with the first token of the expansion, and we
646 enter_macro_context (pfile, node)
650 cpp_context *context;
651 cpp_macro *macro = node->value.macro;
654 /* Save the position of the outermost macro invocation. */
655 if (!pfile->context->prev)
658 if (macro->fun_like && !funlike_invocation_p (pfile, node, &list))
660 if (!pfile->context->prev)
661 unlock_pools (pfile);
665 if (macro->paramc == 0)
667 list.first = macro->expansion;
668 list.limit = macro->expansion + macro->count;
671 context = next_context (pfile);
672 context->list = list;
673 context->macro = macro;
675 /* Disable the macro within its expansion. */
681 /* Move to the next context. Create one if there is none. */
686 cpp_context *prev = pfile->context;
687 cpp_context *result = prev->next;
691 result = xnew (cpp_context);
697 pfile->context = result;
702 replace_args (pfile, macro, args, list)
706 struct toklist *list;
708 unsigned char flags = 0;
709 unsigned int i, total;
710 const cpp_token *src, *limit;
714 src = macro->expansion;
715 limit = src + macro->count;
717 /* First, fully macro-expand arguments, calculating the number of
718 tokens in the final expansion as we go. This ensures that the
719 possible recursive use of argument_pool is fine. */
721 for (; src < limit; src++)
722 if (src->type == CPP_MACRO_ARG)
724 /* We have an argument. If it is not being stringified or
725 pasted it is macro-replaced before insertion. */
726 arg = &args[src->val.arg_no - 1];
728 if (src->flags & STRINGIFY_ARG)
730 if (!arg->stringified)
731 stringify_arg (pfile, arg);
733 else if ((src->flags & PASTE_LEFT)
734 || (src > macro->expansion && (src[-1].flags & PASTE_LEFT)))
735 total += arg->count - 1;
740 arg->expanded_count = 0;
742 expand_arg (pfile, arg);
744 total += arg->expanded_count - 1;
748 dest = (cpp_token *) _cpp_pool_alloc (&pfile->argument_pool,
749 total * sizeof (cpp_token));
752 for (src = macro->expansion; src < limit; src++)
753 if (src->type == CPP_MACRO_ARG)
756 const cpp_token *from;
758 arg = &args[src->val.arg_no - 1];
759 if (src->flags & STRINGIFY_ARG)
761 from = arg->stringified, count = 1;
762 /* Ugh. Maintain position of original argument. */
763 arg->stringified->line = src->line;
764 arg->stringified->col = src->col;
766 else if (src->flags & PASTE_LEFT)
767 count = arg->count, from = arg->first;
768 else if (src > macro->expansion && (src[-1].flags & PASTE_LEFT))
770 count = arg->count, from = arg->first;
771 if (dest != list->first)
773 /* GCC has special semantics for , ## b where b is a
774 varargs parameter: the comma disappears if b was
775 given no actual arguments (not merely if b is an
776 empty argument); otherwise pasting is turned off. */
777 if (dest[-1].type == CPP_COMMA
779 && src->val.arg_no == macro->paramc)
784 dest[-1].flags &= ~PASTE_LEFT;
786 /* Count == 0 is the RHS a placemarker case. */
788 dest[-1].flags &= ~PASTE_LEFT;
792 count = arg->expanded_count, from = arg->expanded;
794 /* Count == 0 is the LHS a placemarker case. */
797 memcpy (dest, from, count * sizeof (cpp_token));
799 /* The first token gets PREV_WHITE of the CPP_MACRO_ARG. */
800 dest->flags &= ~PREV_WHITE;
801 dest->flags |= src->flags & PREV_WHITE;
802 dest->flags |= AVOID_LPASTE;
804 /* The last token gets the PASTE_LEFT of the CPP_MACRO_ARG. */
805 dest[count - 1].flags |= src->flags & PASTE_LEFT;
810 /* The token after the argument must avoid an accidental paste. */
811 flags = AVOID_LPASTE;
816 dest->flags |= flags;
823 /* Free the expanded arguments. */
824 for (i = 0; i < macro->paramc; i++)
826 if (args[i].expanded)
827 free (args[i].expanded);
828 if (args[i].stringified)
829 free (args[i].stringified);
833 /* Subroutine of expand_arg to put the unexpanded tokens on the
836 push_arg_context (pfile, arg)
840 cpp_context *context = next_context (pfile);
842 context->list.first = arg->first;
843 context->list.limit = arg->first + arg->count;
849 expand_arg (pfile, arg)
854 unsigned int capacity = 256;
856 /* Loop, reading in the arguments. */
857 arg->expanded = (cpp_token *) xmalloc (capacity * sizeof (cpp_token));
859 push_arg_context (pfile, arg);
862 if (arg->expanded_count >= capacity)
865 arg->expanded = (cpp_token *)
866 xrealloc (arg->expanded, capacity * sizeof (cpp_token));
868 token = &arg->expanded[arg->expanded_count++];
869 cpp_get_token (pfile, token);
871 while (token->type != CPP_EOF);
873 arg->expanded_count--;
875 /* Pop the context we pushed. */
876 pfile->context = pfile->context->prev;
880 _cpp_pop_context (pfile)
883 cpp_context *context = pfile->context;
885 pfile->context = context->prev;
886 if (!pfile->context->prev && !pfile->state.parsing_args)
887 unlock_pools (pfile);
889 /* Re-enable a macro, temporarily if parsing_args, when leaving its
891 context->macro->disabled = 0;
894 /* Eternal routine to get a token. Also used nearly everywhere
895 internally, except for places where we know we can safely call
896 the lexer directly, such as lexing a directive name.
898 Macro expansions and directives are transparently handled,
899 including entering included files. Thus tokens are post-macro
900 expansion, and after any intervening directives. External callers
901 see CPP_EOF only at EOF. Internal callers also see it when meeting
902 a directive inside a macro call, when at the end of a directive and
903 state.in_directive is still 1, and at the end of argument
906 cpp_get_token (pfile, token)
912 cpp_context *context = pfile->context;
915 take_lookahead_token (pfile, token);
916 /* Context->prev == 0 <=> base context. */
917 else if (!context->prev)
918 _cpp_lex_token (pfile, token);
919 else if (context->list.first != context->list.limit)
921 *token = *context->list.first++;
922 token->flags |= pfile->buffer->saved_flags;
923 pfile->buffer->saved_flags = 0;
924 /* PASTE_LEFT tokens can only appear in macro expansions. */
925 if (token->flags & PASTE_LEFT)
927 /* Maintains position of original token. */
928 paste_all_tokens (pfile, token);
929 pfile->buffer->saved_flags = AVOID_LPASTE;
936 /* Avoid accidental paste at the end of a macro. */
937 pfile->buffer->saved_flags |= AVOID_LPASTE;
938 _cpp_pop_context (pfile);
941 /* End of argument pre-expansion. */
942 token->type = CPP_EOF;
947 if (token->type != CPP_NAME)
950 /* Handle macros and the _Pragma operator. */
951 if (token->val.node->type == NT_MACRO
952 && !pfile->state.prevent_expansion
953 && !(token->flags & NO_EXPAND))
955 cpp_hashnode *node = token->val.node;
957 /* Macros invalidate controlling macros. */
958 pfile->mi_valid = false;
960 if (node->flags & NODE_BUILTIN)
962 /* Maintains position of original token. */
963 builtin_macro (pfile, token);
964 pfile->buffer->saved_flags = AVOID_LPASTE;
968 if (node->value.macro->disabled)
969 token->flags |= NO_EXPAND;
970 else if (enter_macro_context (pfile, node))
972 /* Pass AVOID_LPASTE and our PREV_WHITE to next token. */
973 pfile->buffer->saved_flags = ((token->flags & PREV_WHITE)
979 /* Don't interpret _Pragma within directives. The standard is
980 not clear on this, but to me this makes most sense. */
981 if (token->val.node != pfile->spec_nodes.n__Pragma
982 || pfile->state.in_directive)
985 /* Handle it, and loop back for another token. MI is cleared
986 since this token came from either the lexer or a macro. */
987 _cpp_do__Pragma (pfile);
991 save_lookahead_token (pfile, token);
994 /* Returns true if we're expanding an object-like macro that was
995 defined in a system header. Just checks the macro at the top of
996 the stack. Used for diagnostic suppression. */
998 cpp_sys_macro_p (pfile)
1001 cpp_macro *macro = pfile->context->macro;
1003 return macro && macro->syshdr;
1006 /* Read each token in, until EOF. Directives are transparently
1009 cpp_scan_nooutput (pfile)
1015 cpp_get_token (pfile, &token);
1016 while (token.type != CPP_EOF);
1019 /* Lookahead handling. */
1022 save_lookahead_token (pfile, token)
1024 const cpp_token *token;
1026 cpp_lookahead *la = pfile->la_write;
1027 cpp_token_with_pos *twp;
1029 if (la->count == la->cap)
1031 la->cap += la->cap + 8;
1032 la->tokens = (cpp_token_with_pos *)
1033 xrealloc (la->tokens, la->cap * sizeof (cpp_token_with_pos));
1036 twp = &la->tokens[la->count++];
1037 twp->token = *token;
1038 twp->pos = *cpp_get_line (pfile);
1042 take_lookahead_token (pfile, token)
1046 cpp_lookahead *la = pfile->la_read;
1047 cpp_token_with_pos *twp = &la->tokens[la->cur];
1049 *token = twp->token;
1050 pfile->lexer_pos = twp->pos;
1052 if (++la->cur == la->count)
1053 _cpp_release_lookahead (pfile);
1056 /* Moves the lookahead at the front of the read list to the free store. */
1058 _cpp_release_lookahead (pfile)
1061 cpp_lookahead *la = pfile->la_read;
1063 pfile->la_read = la->next;
1064 la->next = pfile->la_unused;
1065 pfile->la_unused = la;
1066 unlock_pools (pfile);
1069 /* Take a new lookahead from the free store, or allocate one if none. */
1070 static cpp_lookahead *
1071 alloc_lookahead (pfile)
1074 cpp_lookahead *la = pfile->la_unused;
1077 pfile->la_unused = la->next;
1080 la = xnew (cpp_lookahead);
1085 la->cur = la->count = 0;
1089 /* Free memory associated with a lookahead list. */
1095 free ((PTR) la->tokens);
1099 /* Free all the lookaheads of a cpp_reader. */
1101 _cpp_free_lookaheads (pfile)
1104 cpp_lookahead *la, *lan;
1107 free_lookahead (pfile->la_read);
1108 if (pfile->la_write)
1109 free_lookahead (pfile->la_write);
1111 for (la = pfile->la_unused; la; la = lan)
1114 free_lookahead (la);
1118 /* Allocate a lookahead and move it to the front of the write list. */
1120 cpp_start_lookahead (pfile)
1123 cpp_lookahead *la = alloc_lookahead (pfile);
1125 la->next = pfile->la_write;
1126 pfile->la_write = la;
1128 la->pos = *cpp_get_line (pfile);
1130 /* Don't allow memory pools to be re-used whilst we're reading ahead. */
1134 /* Stop reading ahead - either step back, or drop the read ahead. */
1136 cpp_stop_lookahead (pfile, drop)
1140 cpp_lookahead *la = pfile->la_write;
1142 pfile->la_write = la->next;
1143 la->next = pfile->la_read;
1144 pfile->la_read = la;
1146 if (drop || la->count == 0)
1147 _cpp_release_lookahead (pfile);
1149 pfile->lexer_pos = la->pos;
1152 /* Push a single token back to the front of the queue. Only to be
1153 used by cpplib, and only then when necessary. POS is the position
1154 to report for the preceding token. */
1156 _cpp_push_token (pfile, token, pos)
1158 const cpp_token *token;
1159 const cpp_lexer_pos *pos;
1161 cpp_start_lookahead (pfile);
1162 save_lookahead_token (pfile, token);
1163 cpp_stop_lookahead (pfile, 0);
1164 pfile->lexer_pos = *pos;
1167 /* #define directive parsing and handling. */
1169 /* Returns non-zero if a macro redefinition warning is required. */
1171 warn_of_redefinition (pfile, node, macro2)
1173 const cpp_hashnode *node;
1174 const cpp_macro *macro2;
1176 const cpp_macro *macro1;
1179 /* Some redefinitions need to be warned about regardless. */
1180 if (node->flags & NODE_WARN)
1183 if (! CPP_PEDANTIC (pfile))
1186 /* Redefinition of a macro is allowed if and only if the old and new
1187 definitions are the same. (6.10.3 paragraph 2). */
1188 macro1 = node->value.macro;
1190 /* The quick failures. */
1191 if (macro1->count != macro2->count
1192 || macro1->paramc != macro2->paramc
1193 || macro1->fun_like != macro2->fun_like
1194 || macro1->variadic != macro2->variadic)
1197 /* Check each token. */
1198 for (i = 0; i < macro1->count; i++)
1199 if (! _cpp_equiv_tokens (¯o1->expansion[i], ¯o2->expansion[i]))
1202 /* Check parameter spellings. */
1203 for (i = 0; i < macro1->paramc; i++)
1204 if (macro1->params[i] != macro2->params[i])
1210 /* Free the definition of hashnode H. */
1213 _cpp_free_definition (h)
1216 /* Macros and assertions no longer have anything to free. */
1218 /* Clear builtin flag in case of redefinition. */
1219 h->flags &= ~NODE_BUILTIN;
1223 save_parameter (pfile, macro, node)
1228 cpp_hashnode **dest;
1230 /* Constraint 6.10.3.6 - duplicate parameter names. */
1231 if (node->arg_index)
1233 cpp_error (pfile, "duplicate macro parameter \"%s\"", NODE_NAME (node));
1237 dest = ¯o->params[macro->paramc];
1239 /* Check we have room for the parameters. */
1240 if ((unsigned char *) (dest + 1) >= POOL_LIMIT (&pfile->macro_pool))
1242 _cpp_next_chunk (&pfile->macro_pool, sizeof (cpp_hashnode *),
1243 (unsigned char **) ¯o->params);
1244 dest = ¯o->params[macro->paramc];
1248 node->arg_index = ++macro->paramc;
1253 parse_params (pfile, macro)
1258 unsigned int prev_ident = 0;
1260 macro->params = (cpp_hashnode **) POOL_FRONT (&pfile->macro_pool);
1263 _cpp_lex_token (pfile, &token);
1268 cpp_error (pfile, "\"%s\" may not appear in macro parameter list",
1269 cpp_token_as_text (pfile, &token));
1275 cpp_error (pfile, "macro parameters must be comma-separated");
1280 if (save_parameter (pfile, macro, token.val.node))
1284 case CPP_CLOSE_PAREN:
1285 if (prev_ident || macro->paramc == 0)
1288 /* Fall through to pick up the error. */
1292 cpp_error (pfile, "parameter name missing");
1299 macro->variadic = 1;
1302 save_parameter (pfile, macro, pfile->spec_nodes.n__VA_ARGS__);
1303 pfile->state.va_args_ok = 1;
1304 if (! CPP_OPTION (pfile, c99) && CPP_OPTION (pfile, pedantic))
1306 "anonymous variadic macros were introduced in C99");
1308 else if (CPP_OPTION (pfile, pedantic))
1309 cpp_pedwarn (pfile, "ISO C does not permit named variadic macros");
1311 /* We're at the end, and just expect a closing parenthesis. */
1312 _cpp_lex_token (pfile, &token);
1313 if (token.type == CPP_CLOSE_PAREN)
1318 cpp_error (pfile, "missing ')' in macro parameter list");
1322 /* Success. Commit the parameter array. */
1323 POOL_COMMIT (&pfile->macro_pool,
1324 macro->paramc * sizeof (cpp_hashnode *));
1329 /* Lex a token from a macro's replacement list. Translate it to a
1330 CPP_MACRO_ARG if appropriate. */
1332 lex_expansion_token (pfile, macro)
1336 cpp_token *token = ¯o->expansion[macro->count];
1338 /* Check we have room for the token. */
1339 if ((unsigned char *) (token + 1) >= POOL_LIMIT (&pfile->macro_pool))
1341 _cpp_next_chunk (&pfile->macro_pool, sizeof (cpp_token),
1342 (unsigned char **) ¯o->expansion);
1343 token = ¯o->expansion[macro->count];
1347 _cpp_lex_token (pfile, token);
1349 /* Is this an argument? */
1350 if (token->type == CPP_NAME && token->val.node->arg_index)
1352 token->type = CPP_MACRO_ARG;
1353 token->val.arg_no = token->val.node->arg_index;
1355 else if (CPP_WTRADITIONAL (pfile) && macro->paramc > 0
1356 && (token->type == CPP_STRING || token->type == CPP_CHAR))
1357 check_trad_stringification (pfile, macro, &token->val.str);
1362 /* Parse a macro and save its expansion. Returns non-zero on success. */
1364 _cpp_create_definition (pfile, node)
1370 unsigned int i, ok = 1;
1372 macro = (cpp_macro *) _cpp_pool_alloc (&pfile->macro_pool,
1373 sizeof (cpp_macro));
1374 macro->line = pfile->directive_pos.line;
1377 macro->fun_like = 0;
1378 macro->variadic = 0;
1380 macro->expansion = (cpp_token *) POOL_FRONT (&pfile->macro_pool);
1382 /* Get the first token of the expansion (or the '(' of a
1383 function-like macro). */
1384 token = lex_expansion_token (pfile, macro);
1385 if (token->type == CPP_OPEN_PAREN && !(token->flags & PREV_WHITE))
1387 if (!(ok = parse_params (pfile, macro)))
1390 macro->fun_like = 1;
1391 /* Some of the pool may have been used for the parameter store. */
1392 macro->expansion = (cpp_token *) POOL_FRONT (&pfile->macro_pool);
1393 token = lex_expansion_token (pfile, macro);
1395 else if (token->type != CPP_EOF && !(token->flags & PREV_WHITE))
1396 cpp_pedwarn (pfile, "ISO C requires whitespace after the macro name");
1398 /* Setting it here means we don't catch leading comments. */
1399 pfile->state.save_comments = ! CPP_OPTION (pfile, discard_comments);
1403 /* Check the stringifying # constraint 6.10.3.2.1 of
1404 function-like macros when lexing the subsequent token. */
1405 if (macro->count > 1 && token[-1].type == CPP_HASH && macro->fun_like)
1407 if (token->type == CPP_MACRO_ARG)
1409 token->flags &= ~PREV_WHITE;
1410 token->flags |= STRINGIFY_ARG;
1411 token->flags |= token[-1].flags & PREV_WHITE;
1412 token[-1] = token[0];
1415 /* Let assembler get away with murder. */
1416 else if (CPP_OPTION (pfile, lang) != CLK_ASM)
1419 cpp_error (pfile, "'#' is not followed by a macro parameter");
1424 if (token->type == CPP_EOF)
1427 /* Paste operator constraint 6.10.3.3.1. */
1428 if (token->type == CPP_PASTE)
1430 /* Token-paste ##, can appear in both object-like and
1431 function-like macros, but not at the ends. */
1432 if (--macro->count > 0)
1433 token = lex_expansion_token (pfile, macro);
1435 if (macro->count == 0 || token->type == CPP_EOF)
1439 "'##' cannot appear at either end of a macro expansion");
1443 token[-1].flags |= PASTE_LEFT;
1444 /* Give it a PREV_WHITE for -dM etc. */
1445 token->flags |= PREV_WHITE;
1448 token = lex_expansion_token (pfile, macro);
1451 /* Don't count the CPP_EOF. */
1454 /* Clear the whitespace flag from the leading token. */
1455 macro->expansion[0].flags &= ~PREV_WHITE;
1457 /* Implement the macro-defined-to-itself optimisation. */
1458 macro->disabled = (macro->count == 1 && !macro->fun_like
1459 && macro->expansion[0].type == CPP_NAME
1460 && macro->expansion[0].val.node == node);
1462 /* To suppress some diagnostics. */
1463 macro->syshdr = pfile->map->sysp != 0;
1465 /* Commit the memory. */
1466 POOL_COMMIT (&pfile->macro_pool, macro->count * sizeof (cpp_token));
1468 if (node->type != NT_VOID)
1470 if (warn_of_redefinition (pfile, node, macro))
1472 cpp_pedwarn_with_line (pfile, pfile->directive_pos.line,
1473 pfile->directive_pos.col,
1474 "\"%s\" redefined", NODE_NAME (node));
1476 if (node->type == NT_MACRO && !(node->flags & NODE_BUILTIN))
1477 cpp_pedwarn_with_line (pfile, node->value.macro->line, 1,
1478 "this is the location of the previous definition");
1480 _cpp_free_definition (node);
1483 /* Enter definition in hash table. */
1484 node->type = NT_MACRO;
1485 node->value.macro = macro;
1486 if (! ustrncmp (NODE_NAME (node), DSC ("__STDC_")))
1487 node->flags |= NODE_WARN;
1491 /* Stop the lexer accepting __VA_ARGS__. */
1492 pfile->state.va_args_ok = 0;
1494 /* Clear the fast argument lookup indices. */
1495 for (i = macro->paramc; i-- > 0; )
1496 macro->params[i]->arg_index = 0;
1501 /* Warn if a token in `string' matches one of the function macro
1502 arguments in `info'. This function assumes that the macro is a
1503 function macro and not an object macro. */
1505 check_trad_stringification (pfile, macro, string)
1507 const cpp_macro *macro;
1508 const cpp_string *string;
1510 unsigned int i, len;
1511 const U_CHAR *p, *q, *limit = string->text + string->len;
1513 /* Loop over the string. */
1514 for (p = string->text; p < limit; p = q)
1516 /* Find the start of an identifier. */
1517 while (p < limit && !is_idstart (*p))
1520 /* Find the end of the identifier. */
1522 while (q < limit && is_idchar (*q))
1527 /* Loop over the function macro arguments to see if the
1528 identifier inside the string matches one of them. */
1529 for (i = 0; i < macro->paramc; i++)
1531 const cpp_hashnode *node = macro->params[i];
1533 if (NODE_LEN (node) == len
1534 && !memcmp (p, NODE_NAME (node), len))
1537 "macro argument \"%s\" would be stringified with -traditional.",
1545 /* Returns the name, arguments and expansion of a macro, in a format
1546 suitable to be read back in again, and therefore also for DWARF 2
1547 debugging info. e.g. "PASTE(X, Y) X ## Y", or "MACNAME EXPANSION".
1548 Caller is expected to generate the "#define" bit if needed. The
1549 returned text is temporary, and automatically freed later. */
1551 const unsigned char *
1552 cpp_macro_definition (pfile, node)
1554 const cpp_hashnode *node;
1556 unsigned int i, len;
1557 const cpp_macro *macro = node->value.macro;
1558 unsigned char *buffer;
1560 if (node->type != NT_MACRO || (node->flags & NODE_BUILTIN))
1562 cpp_ice (pfile, "invalid hash type %d in cpp_macro_definition", node->type);
1566 /* Calculate length. */
1567 len = NODE_LEN (node) + 1; /* ' ' */
1568 if (macro->fun_like)
1570 len += 3; /* "()" plus possible final "." of named
1571 varargs (we have + 2 below). */
1572 for (i = 0; i < macro->paramc; i++)
1573 len += NODE_LEN (macro->params[i]) + 2; /* ", " */
1576 for (i = 0; i < macro->count; i++)
1578 cpp_token *token = ¯o->expansion[i];
1580 if (token->type == CPP_MACRO_ARG)
1581 len += NODE_LEN (macro->params[token->val.arg_no - 1]);
1583 len += cpp_token_len (token); /* Includes room for ' '. */
1584 if (token->flags & STRINGIFY_ARG)
1586 if (token->flags & PASTE_LEFT)
1587 len += 3; /* " ##" */
1590 if (len > pfile->macro_buffer_len)
1592 pfile->macro_buffer = (U_CHAR *) xrealloc (pfile->macro_buffer, len);
1593 pfile->macro_buffer_len = len;
1596 /* Fill in the buffer. Start with the macro name. */
1597 buffer = pfile->macro_buffer;
1598 memcpy (buffer, NODE_NAME (node), NODE_LEN (node));
1599 buffer += NODE_LEN (node);
1601 /* Parameter names. */
1602 if (macro->fun_like)
1605 for (i = 0; i < macro->paramc; i++)
1607 cpp_hashnode *param = macro->params[i];
1609 if (param != pfile->spec_nodes.n__VA_ARGS__)
1611 memcpy (buffer, NODE_NAME (param), NODE_LEN (param));
1612 buffer += NODE_LEN (param);
1615 if (i + 1 < macro->paramc)
1616 *buffer++ = ',', *buffer++ = ' ';
1617 else if (macro->variadic)
1618 *buffer++ = '.', *buffer++ = '.', *buffer++ = '.';
1623 /* Expansion tokens. */
1627 for (i = 0; i < macro->count; i++)
1629 cpp_token *token = ¯o->expansion[i];
1631 if (token->flags & PREV_WHITE)
1633 if (token->flags & STRINGIFY_ARG)
1636 if (token->type == CPP_MACRO_ARG)
1638 len = NODE_LEN (macro->params[token->val.arg_no - 1]);
1640 NODE_NAME (macro->params[token->val.arg_no - 1]), len);
1644 buffer = cpp_spell_token (pfile, token, buffer);
1646 if (token->flags & PASTE_LEFT)
1651 /* Next has PREV_WHITE; see _cpp_create_definition. */
1657 return pfile->macro_buffer;