1 /* Language-independent diagnostic subroutines for the GNU Compiler Collection
2 Copyright (C) 1999-2018 Free Software Foundation, Inc.
3 Contributed by Gabriel Dos Reis <gdr@codesourcery.com>
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify it under
8 the terms of the GNU General Public License as published by the Free
9 Software Foundation; either version 3, or (at your option) any later
12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING3. If not see
19 <http://www.gnu.org/licenses/>. */
22 /* This file implements the language independent aspect of diagnostic
27 #include "coretypes.h"
31 #include "backtrace.h"
32 #include "diagnostic.h"
33 #include "diagnostic-color.h"
34 #include "edit-context.h"
36 #include "selftest-diagnostic.h"
42 #ifdef GWINSZ_IN_SYS_IOCTL
43 # include <sys/ioctl.h>
46 #define pedantic_warning_kind(DC) \
47 ((DC)->pedantic_errors ? DK_ERROR : DK_WARNING)
48 #define permissive_error_kind(DC) ((DC)->permissive ? DK_WARNING : DK_ERROR)
49 #define permissive_error_option(DC) ((DC)->opt_permissive)
52 static bool diagnostic_impl (rich_location
*, int, const char *,
53 va_list *, diagnostic_t
) ATTRIBUTE_GCC_DIAG(3,0);
54 static bool diagnostic_n_impl (rich_location
*, int, unsigned HOST_WIDE_INT
,
55 const char *, const char *, va_list *,
56 diagnostic_t
) ATTRIBUTE_GCC_DIAG(5,0);
58 static void error_recursion (diagnostic_context
*) ATTRIBUTE_NORETURN
;
59 static void real_abort (void) ATTRIBUTE_NORETURN
;
61 /* Name of program invoked, sans directories. */
65 /* A diagnostic_context surrogate for stderr. */
66 static diagnostic_context global_diagnostic_context
;
67 diagnostic_context
*global_dc
= &global_diagnostic_context
;
69 /* Return a malloc'd string containing MSG formatted a la printf. The
70 caller is responsible for freeing the memory. */
72 build_message_string (const char *msg
, ...)
78 str
= xvasprintf (msg
, ap
);
84 /* Same as diagnostic_build_prefix, but only the source FILE is given. */
86 file_name_as_prefix (diagnostic_context
*context
, const char *f
)
89 = colorize_start (pp_show_color (context
->printer
), "locus");
90 const char *locus_ce
= colorize_stop (pp_show_color (context
->printer
));
91 return build_message_string ("%s%s:%s ", locus_cs
, f
, locus_ce
);
96 /* Return the value of the getenv("COLUMNS") as an integer. If the
97 value is not set to a positive integer, use ioctl to get the
98 terminal width. If it fails, return INT_MAX. */
100 get_terminal_width (void)
102 const char * s
= getenv ("COLUMNS");
112 if (ioctl (0, TIOCGWINSZ
, &w
) == 0 && w
.ws_col
> 0)
119 /* Set caret_max_width to value. */
121 diagnostic_set_caret_max_width (diagnostic_context
*context
, int value
)
123 /* One minus to account for the leading empty space. */
124 value
= value
? value
- 1
125 : (isatty (fileno (pp_buffer (context
->printer
)->stream
))
126 ? get_terminal_width () - 1: INT_MAX
);
131 context
->caret_max_width
= value
;
134 /* Initialize the diagnostic message outputting machinery. */
136 diagnostic_initialize (diagnostic_context
*context
, int n_opts
)
140 /* Allocate a basic pretty-printer. Clients will replace this a
141 much more elaborated pretty-printer if they wish. */
142 context
->printer
= XNEW (pretty_printer
);
143 new (context
->printer
) pretty_printer ();
145 memset (context
->diagnostic_count
, 0, sizeof context
->diagnostic_count
);
146 context
->warning_as_error_requested
= false;
147 context
->n_opts
= n_opts
;
148 context
->classify_diagnostic
= XNEWVEC (diagnostic_t
, n_opts
);
149 for (i
= 0; i
< n_opts
; i
++)
150 context
->classify_diagnostic
[i
] = DK_UNSPECIFIED
;
151 context
->show_caret
= false;
152 diagnostic_set_caret_max_width (context
, pp_line_cutoff (context
->printer
));
153 for (i
= 0; i
< rich_location::STATICALLY_ALLOCATED_RANGES
; i
++)
154 context
->caret_chars
[i
] = '^';
155 context
->show_option_requested
= false;
156 context
->abort_on_error
= false;
157 context
->show_column
= false;
158 context
->pedantic_errors
= false;
159 context
->permissive
= false;
160 context
->opt_permissive
= 0;
161 context
->fatal_errors
= false;
162 context
->dc_inhibit_warnings
= false;
163 context
->dc_warn_system_headers
= false;
164 context
->max_errors
= 0;
165 context
->internal_error
= NULL
;
166 diagnostic_starter (context
) = default_diagnostic_starter
;
167 context
->start_span
= default_diagnostic_start_span_fn
;
168 diagnostic_finalizer (context
) = default_diagnostic_finalizer
;
169 context
->option_enabled
= NULL
;
170 context
->option_state
= NULL
;
171 context
->option_name
= NULL
;
172 context
->last_location
= UNKNOWN_LOCATION
;
173 context
->last_module
= 0;
174 context
->x_data
= NULL
;
176 context
->inhibit_notes_p
= false;
177 context
->colorize_source_p
= false;
178 context
->show_labels_p
= false;
179 context
->show_line_numbers_p
= false;
180 context
->min_margin_width
= 0;
181 context
->show_ruler_p
= false;
182 context
->parseable_fixits_p
= false;
183 context
->edit_context_ptr
= NULL
;
184 context
->diagnostic_group_nesting_depth
= 0;
185 context
->diagnostic_group_emission_count
= 0;
186 context
->begin_group_cb
= NULL
;
187 context
->end_group_cb
= NULL
;
190 /* Maybe initialize the color support. We require clients to do this
191 explicitly, since most clients don't want color. When called
192 without a VALUE, it initializes with DIAGNOSTICS_COLOR_DEFAULT. */
195 diagnostic_color_init (diagnostic_context
*context
, int value
/*= -1 */)
197 /* value == -1 is the default value. */
200 /* If DIAGNOSTICS_COLOR_DEFAULT is -1, default to
201 -fdiagnostics-color=auto if GCC_COLORS is in the environment,
202 otherwise default to -fdiagnostics-color=never, for other
203 values default to that
204 -fdiagnostics-color={never,auto,always}. */
205 if (DIAGNOSTICS_COLOR_DEFAULT
== -1)
207 if (!getenv ("GCC_COLORS"))
209 value
= DIAGNOSTICS_COLOR_AUTO
;
212 value
= DIAGNOSTICS_COLOR_DEFAULT
;
214 pp_show_color (context
->printer
)
215 = colorize_init ((diagnostic_color_rule_t
) value
);
218 /* Do any cleaning up required after the last diagnostic is emitted. */
221 diagnostic_finish (diagnostic_context
*context
)
223 /* Some of the errors may actually have been warnings. */
224 if (diagnostic_kind_count (context
, DK_WERROR
))
226 /* -Werror was given. */
227 if (context
->warning_as_error_requested
)
228 pp_verbatim (context
->printer
,
229 _("%s: all warnings being treated as errors"),
231 /* At least one -Werror= was given. */
233 pp_verbatim (context
->printer
,
234 _("%s: some warnings being treated as errors"),
236 pp_newline_and_flush (context
->printer
);
239 diagnostic_file_cache_fini ();
241 XDELETEVEC (context
->classify_diagnostic
);
242 context
->classify_diagnostic
= NULL
;
244 /* diagnostic_initialize allocates context->printer using XNEW
245 and placement-new. */
246 context
->printer
->~pretty_printer ();
247 XDELETE (context
->printer
);
248 context
->printer
= NULL
;
250 if (context
->edit_context_ptr
)
252 delete context
->edit_context_ptr
;
253 context
->edit_context_ptr
= NULL
;
257 /* Initialize DIAGNOSTIC, where the message MSG has already been
260 diagnostic_set_info_translated (diagnostic_info
*diagnostic
, const char *msg
,
261 va_list *args
, rich_location
*richloc
,
264 gcc_assert (richloc
);
265 diagnostic
->message
.err_no
= errno
;
266 diagnostic
->message
.args_ptr
= args
;
267 diagnostic
->message
.format_spec
= msg
;
268 diagnostic
->message
.m_richloc
= richloc
;
269 diagnostic
->richloc
= richloc
;
270 diagnostic
->kind
= kind
;
271 diagnostic
->option_index
= 0;
274 /* Initialize DIAGNOSTIC, where the message GMSGID has not yet been
277 diagnostic_set_info (diagnostic_info
*diagnostic
, const char *gmsgid
,
278 va_list *args
, rich_location
*richloc
,
281 gcc_assert (richloc
);
282 diagnostic_set_info_translated (diagnostic
, _(gmsgid
), args
, richloc
, kind
);
285 static const char *const diagnostic_kind_color
[] = {
286 #define DEFINE_DIAGNOSTIC_KIND(K, T, C) (C),
287 #include "diagnostic.def"
288 #undef DEFINE_DIAGNOSTIC_KIND
292 /* Get a color name for diagnostics of type KIND
293 Result could be NULL. */
296 diagnostic_get_color_for_kind (diagnostic_t kind
)
298 return diagnostic_kind_color
[kind
];
301 /* Return a formatted line and column ':%line:%column'. Elided if
302 zero. The result is a statically allocated buffer. */
305 maybe_line_and_column (int line
, int col
)
307 static char result
[32];
311 size_t l
= snprintf (result
, sizeof (result
),
312 col
? ":%d:%d" : ":%d", line
, col
);
313 gcc_checking_assert (l
< sizeof (result
));
320 /* Return a malloc'd string describing a location e.g. "foo.c:42:10".
321 The caller is responsible for freeing the memory. */
324 diagnostic_get_location_text (diagnostic_context
*context
,
327 pretty_printer
*pp
= context
->printer
;
328 const char *locus_cs
= colorize_start (pp_show_color (pp
), "locus");
329 const char *locus_ce
= colorize_stop (pp_show_color (pp
));
330 const char *file
= s
.file
? s
.file
: progname
;
331 int line
= strcmp (file
, N_("<built-in>")) ? s
.line
: 0;
332 int col
= context
->show_column
? s
.column
: 0;
334 const char *line_col
= maybe_line_and_column (line
, col
);
335 return build_message_string ("%s%s%s:%s", locus_cs
, file
,
339 /* Return a malloc'd string describing a location and the severity of the
340 diagnostic, e.g. "foo.c:42:10: error: ". The caller is responsible for
341 freeing the memory. */
343 diagnostic_build_prefix (diagnostic_context
*context
,
344 const diagnostic_info
*diagnostic
)
346 static const char *const diagnostic_kind_text
[] = {
347 #define DEFINE_DIAGNOSTIC_KIND(K, T, C) (T),
348 #include "diagnostic.def"
349 #undef DEFINE_DIAGNOSTIC_KIND
352 gcc_assert (diagnostic
->kind
< DK_LAST_DIAGNOSTIC_KIND
);
354 const char *text
= _(diagnostic_kind_text
[diagnostic
->kind
]);
355 const char *text_cs
= "", *text_ce
= "";
356 pretty_printer
*pp
= context
->printer
;
358 if (diagnostic_kind_color
[diagnostic
->kind
])
360 text_cs
= colorize_start (pp_show_color (pp
),
361 diagnostic_kind_color
[diagnostic
->kind
]);
362 text_ce
= colorize_stop (pp_show_color (pp
));
365 expanded_location s
= diagnostic_expand_location (diagnostic
);
366 char *location_text
= diagnostic_get_location_text (context
, s
);
368 char *result
= build_message_string ("%s %s%s%s", location_text
,
369 text_cs
, text
, text_ce
);
370 free (location_text
);
374 /* Functions at which to stop the backtrace print. It's not
375 particularly helpful to print the callers of these functions. */
377 static const char * const bt_stop
[] =
385 /* A callback function passed to the backtrace_full function. */
388 bt_callback (void *data
, uintptr_t pc
, const char *filename
, int lineno
,
389 const char *function
)
391 int *pcount
= (int *) data
;
393 /* If we don't have any useful information, don't print
395 if (filename
== NULL
&& function
== NULL
)
398 /* Skip functions in diagnostic.c. */
401 && strcmp (lbasename (filename
), "diagnostic.c") == 0)
404 /* Print up to 20 functions. We could make this a --param, but
405 since this is only for debugging just use a constant for now. */
408 /* Returning a non-zero value stops the backtrace. */
414 if (function
!= NULL
)
416 char *str
= cplus_demangle_v3 (function
,
417 (DMGL_VERBOSE
| DMGL_ANSI
418 | DMGL_GNU_V3
| DMGL_PARAMS
));
425 for (size_t i
= 0; i
< ARRAY_SIZE (bt_stop
); ++i
)
427 size_t len
= strlen (bt_stop
[i
]);
428 if (strncmp (function
, bt_stop
[i
], len
) == 0
429 && (function
[len
] == '\0' || function
[len
] == '('))
433 /* Returning a non-zero value stops the backtrace. */
439 fprintf (stderr
, "0x%lx %s\n\t%s:%d\n",
441 function
== NULL
? "???" : function
,
442 filename
== NULL
? "???" : filename
,
451 /* A callback function passed to the backtrace_full function. This is
452 called if backtrace_full has an error. */
455 bt_err_callback (void *data ATTRIBUTE_UNUSED
, const char *msg
, int errnum
)
459 /* This means that no debug info was available. Just quietly
460 skip printing backtrace info. */
463 fprintf (stderr
, "%s%s%s\n", msg
, errnum
== 0 ? "" : ": ",
464 errnum
== 0 ? "" : xstrerror (errnum
));
467 /* Check if we've met the maximum error limit, and if so fatally exit
468 with a message. CONTEXT is the context to check, and FLUSH
469 indicates whether a diagnostic_finish call is needed. */
472 diagnostic_check_max_errors (diagnostic_context
*context
, bool flush
)
474 if (!context
->max_errors
)
477 int count
= (diagnostic_kind_count (context
, DK_ERROR
)
478 + diagnostic_kind_count (context
, DK_SORRY
)
479 + diagnostic_kind_count (context
, DK_WERROR
));
481 if (count
>= context
->max_errors
)
484 "compilation terminated due to -fmax-errors=%u.\n",
485 context
->max_errors
);
487 diagnostic_finish (context
);
488 exit (FATAL_EXIT_CODE
);
492 /* Take any action which is expected to happen after the diagnostic
493 is written out. This function does not always return. */
495 diagnostic_action_after_output (diagnostic_context
*context
,
496 diagnostic_t diag_kind
)
508 if (context
->abort_on_error
)
510 if (context
->fatal_errors
)
512 fnotice (stderr
, "compilation terminated due to -Wfatal-errors.\n");
513 diagnostic_finish (context
);
514 exit (FATAL_EXIT_CODE
);
521 struct backtrace_state
*state
= NULL
;
522 if (diag_kind
== DK_ICE
)
523 state
= backtrace_create_state (NULL
, 0, bt_err_callback
, NULL
);
526 backtrace_full (state
, 2, bt_callback
, bt_err_callback
,
529 if (context
->abort_on_error
)
532 fnotice (stderr
, "Please submit a full bug report,\n"
533 "with preprocessed source if appropriate.\n");
536 ("Please include the complete backtrace "
537 "with any bug report.\n"));
538 fnotice (stderr
, "See %s for instructions.\n", bug_report_url
);
540 exit (ICE_EXIT_CODE
);
544 if (context
->abort_on_error
)
546 diagnostic_finish (context
);
547 fnotice (stderr
, "compilation terminated.\n");
548 exit (FATAL_EXIT_CODE
);
555 /* True if the last module or file in which a diagnostic was reported is
556 different from the current one. */
559 last_module_changed_p (diagnostic_context
*context
,
560 const line_map_ordinary
*map
)
562 return context
->last_module
!= map
;
565 /* Remember the current module or file as being the last one in which we
566 report a diagnostic. */
569 set_last_module (diagnostic_context
*context
, const line_map_ordinary
*map
)
571 context
->last_module
= map
;
575 diagnostic_report_current_module (diagnostic_context
*context
, location_t where
)
577 const line_map_ordinary
*map
= NULL
;
579 if (pp_needs_newline (context
->printer
))
581 pp_newline (context
->printer
);
582 pp_needs_newline (context
->printer
) = false;
585 if (where
<= BUILTINS_LOCATION
)
588 linemap_resolve_location (line_table
, where
,
589 LRK_MACRO_DEFINITION_LOCATION
,
592 if (map
&& last_module_changed_p (context
, map
))
594 set_last_module (context
, map
);
595 if (! MAIN_FILE_P (map
))
600 where
= linemap_included_from (map
);
601 map
= linemap_included_from_linemap (line_table
, map
);
603 = maybe_line_and_column (SOURCE_LINE (map
, where
),
604 first
&& context
->show_column
605 ? SOURCE_COLUMN (map
, where
) : 0);
606 static const char *const msgs
[] =
608 N_("In file included from"),
611 unsigned index
= !first
;
612 pp_verbatim (context
->printer
, "%s%s %r%s%s%R",
613 first
? "" : ",\n", _(msgs
[index
]),
614 "locus", LINEMAP_FILE (map
), line_col
);
617 while (! MAIN_FILE_P (map
));
618 pp_verbatim (context
->printer
, ":");
619 pp_newline (context
->printer
);
625 default_diagnostic_starter (diagnostic_context
*context
,
626 diagnostic_info
*diagnostic
)
628 diagnostic_report_current_module (context
, diagnostic_location (diagnostic
));
629 pp_set_prefix (context
->printer
, diagnostic_build_prefix (context
,
634 default_diagnostic_start_span_fn (diagnostic_context
*context
,
635 expanded_location exploc
)
637 char *text
= diagnostic_get_location_text (context
, exploc
);
638 pp_string (context
->printer
, text
);
640 pp_newline (context
->printer
);
644 default_diagnostic_finalizer (diagnostic_context
*context
,
645 diagnostic_info
*diagnostic
)
647 diagnostic_show_locus (context
, diagnostic
->richloc
, diagnostic
->kind
);
648 pp_destroy_prefix (context
->printer
);
649 pp_flush (context
->printer
);
652 /* Interface to specify diagnostic kind overrides. Returns the
653 previous setting, or DK_UNSPECIFIED if the parameters are out of
654 range. If OPTION_INDEX is zero, the new setting is for all the
657 diagnostic_classify_diagnostic (diagnostic_context
*context
,
659 diagnostic_t new_kind
,
662 diagnostic_t old_kind
;
665 || option_index
>= context
->n_opts
666 || new_kind
>= DK_LAST_DIAGNOSTIC_KIND
)
667 return DK_UNSPECIFIED
;
669 old_kind
= context
->classify_diagnostic
[option_index
];
671 /* Handle pragmas separately, since we need to keep track of *where*
673 if (where
!= UNKNOWN_LOCATION
)
677 /* Record the command-line status, so we can reset it back on DK_POP. */
678 if (old_kind
== DK_UNSPECIFIED
)
680 old_kind
= !context
->option_enabled (option_index
,
681 context
->option_state
)
682 ? DK_IGNORED
: (context
->warning_as_error_requested
683 ? DK_ERROR
: DK_WARNING
);
684 context
->classify_diagnostic
[option_index
] = old_kind
;
687 for (i
= context
->n_classification_history
- 1; i
>= 0; i
--)
688 if (context
->classification_history
[i
].option
== option_index
)
690 old_kind
= context
->classification_history
[i
].kind
;
694 i
= context
->n_classification_history
;
695 context
->classification_history
=
696 (diagnostic_classification_change_t
*) xrealloc (context
->classification_history
, (i
+ 1)
697 * sizeof (diagnostic_classification_change_t
));
698 context
->classification_history
[i
].location
= where
;
699 context
->classification_history
[i
].option
= option_index
;
700 context
->classification_history
[i
].kind
= new_kind
;
701 context
->n_classification_history
++;
704 context
->classify_diagnostic
[option_index
] = new_kind
;
709 /* Save all diagnostic classifications in a stack. */
711 diagnostic_push_diagnostics (diagnostic_context
*context
, location_t where ATTRIBUTE_UNUSED
)
713 context
->push_list
= (int *) xrealloc (context
->push_list
, (context
->n_push
+ 1) * sizeof (int));
714 context
->push_list
[context
->n_push
++] = context
->n_classification_history
;
717 /* Restore the topmost classification set off the stack. If the stack
718 is empty, revert to the state based on command line parameters. */
720 diagnostic_pop_diagnostics (diagnostic_context
*context
, location_t where
)
726 jump_to
= context
->push_list
[-- context
->n_push
];
730 i
= context
->n_classification_history
;
731 context
->classification_history
=
732 (diagnostic_classification_change_t
*) xrealloc (context
->classification_history
, (i
+ 1)
733 * sizeof (diagnostic_classification_change_t
));
734 context
->classification_history
[i
].location
= where
;
735 context
->classification_history
[i
].option
= jump_to
;
736 context
->classification_history
[i
].kind
= DK_POP
;
737 context
->n_classification_history
++;
740 /* Helper function for print_parseable_fixits. Print TEXT to PP, obeying the
741 escaping rules for -fdiagnostics-parseable-fixits. */
744 print_escaped_string (pretty_printer
*pp
, const char *text
)
749 pp_character (pp
, '"');
750 for (const char *ch
= text
; *ch
; ch
++)
755 /* Escape backslash as two backslashes. */
756 pp_string (pp
, "\\\\");
759 /* Escape tab as "\t". */
760 pp_string (pp
, "\\t");
763 /* Escape newline as "\n". */
764 pp_string (pp
, "\\n");
767 /* Escape doublequotes as \". */
768 pp_string (pp
, "\\\"");
772 pp_character (pp
, *ch
);
774 /* Use octal for non-printable chars. */
776 unsigned char c
= (*ch
& 0xff);
777 pp_printf (pp
, "\\%o%o%o", (c
/ 64), (c
/ 8) & 007, c
& 007);
782 pp_character (pp
, '"');
785 /* Implementation of -fdiagnostics-parseable-fixits. Print a
786 machine-parseable version of all fixits in RICHLOC to PP. */
789 print_parseable_fixits (pretty_printer
*pp
, rich_location
*richloc
)
792 gcc_assert (richloc
);
794 for (unsigned i
= 0; i
< richloc
->get_num_fixit_hints (); i
++)
796 const fixit_hint
*hint
= richloc
->get_fixit_hint (i
);
797 source_location start_loc
= hint
->get_start_loc ();
798 expanded_location start_exploc
= expand_location (start_loc
);
799 pp_string (pp
, "fix-it:");
800 print_escaped_string (pp
, start_exploc
.file
);
801 /* For compatibility with clang, print as a half-open range. */
802 source_location next_loc
= hint
->get_next_loc ();
803 expanded_location next_exploc
= expand_location (next_loc
);
804 pp_printf (pp
, ":{%i:%i-%i:%i}:",
805 start_exploc
.line
, start_exploc
.column
,
806 next_exploc
.line
, next_exploc
.column
);
807 print_escaped_string (pp
, hint
->get_string ());
812 /* Update the diag_class of DIAGNOSTIC based on its location
814 #pragma GCC diagnostic
815 directives recorded within CONTEXT.
817 Return the new diag_class of DIAGNOSTIC if it was updated, or
818 DK_UNSPECIFIED otherwise. */
821 update_effective_level_from_pragmas (diagnostic_context
*context
,
822 diagnostic_info
*diagnostic
)
824 diagnostic_t diag_class
= DK_UNSPECIFIED
;
826 if (context
->n_classification_history
> 0)
828 location_t location
= diagnostic_location (diagnostic
);
830 /* FIXME: Stupid search. Optimize later. */
831 for (int i
= context
->n_classification_history
- 1; i
>= 0; i
--)
833 if (linemap_location_before_p
835 context
->classification_history
[i
].location
,
838 if (context
->classification_history
[i
].kind
== (int) DK_POP
)
840 i
= context
->classification_history
[i
].option
;
843 int option
= context
->classification_history
[i
].option
;
844 /* The option 0 is for all the diagnostics. */
845 if (option
== 0 || option
== diagnostic
->option_index
)
847 diag_class
= context
->classification_history
[i
].kind
;
848 if (diag_class
!= DK_UNSPECIFIED
)
849 diagnostic
->kind
= diag_class
;
859 /* Print any metadata about the option used to control DIAGNOSTIC to CONTEXT's
860 printer, e.g. " [-Werror=uninitialized]".
861 Subroutine of diagnostic_report_diagnostic. */
864 print_option_information (diagnostic_context
*context
,
865 const diagnostic_info
*diagnostic
,
866 diagnostic_t orig_diag_kind
)
870 option_text
= context
->option_name (context
, diagnostic
->option_index
,
871 orig_diag_kind
, diagnostic
->kind
);
875 pretty_printer
*pp
= context
->printer
;
876 pp_string (pp
, " [");
877 pp_string (pp
, colorize_start (pp_show_color (pp
),
878 diagnostic_kind_color
[diagnostic
->kind
]));
879 pp_string (pp
, option_text
);
880 pp_string (pp
, colorize_stop (pp_show_color (pp
)));
881 pp_character (pp
, ']');
886 /* Report a diagnostic message (an error or a warning) as specified by
887 DC. This function is *the* subroutine in terms of which front-ends
888 should implement their specific diagnostic handling modules. The
889 front-end independent format specifiers are exactly those described
890 in the documentation of output_format.
891 Return true if a diagnostic was printed, false otherwise. */
894 diagnostic_report_diagnostic (diagnostic_context
*context
,
895 diagnostic_info
*diagnostic
)
897 location_t location
= diagnostic_location (diagnostic
);
898 diagnostic_t orig_diag_kind
= diagnostic
->kind
;
900 /* Give preference to being able to inhibit warnings, before they
901 get reclassified to something else. */
902 if ((diagnostic
->kind
== DK_WARNING
|| diagnostic
->kind
== DK_PEDWARN
)
903 && !diagnostic_report_warnings_p (context
, location
))
906 if (diagnostic
->kind
== DK_PEDWARN
)
908 diagnostic
->kind
= pedantic_warning_kind (context
);
909 /* We do this to avoid giving the message for -pedantic-errors. */
910 orig_diag_kind
= diagnostic
->kind
;
913 if (diagnostic
->kind
== DK_NOTE
&& context
->inhibit_notes_p
)
916 if (context
->lock
> 0)
918 /* If we're reporting an ICE in the middle of some other error,
919 try to flush out the previous error, then let this one
920 through. Don't do this more than once. */
921 if ((diagnostic
->kind
== DK_ICE
|| diagnostic
->kind
== DK_ICE_NOBT
)
922 && context
->lock
== 1)
923 pp_newline_and_flush (context
->printer
);
925 error_recursion (context
);
928 /* If the user requested that warnings be treated as errors, so be
929 it. Note that we do this before the next block so that
930 individual warnings can be overridden back to warnings with
932 if (context
->warning_as_error_requested
933 && diagnostic
->kind
== DK_WARNING
)
934 diagnostic
->kind
= DK_ERROR
;
936 if (diagnostic
->option_index
937 && diagnostic
->option_index
!= permissive_error_option (context
))
939 /* This tests if the user provided the appropriate -Wfoo or
941 if (! context
->option_enabled (diagnostic
->option_index
,
942 context
->option_state
))
945 /* This tests for #pragma diagnostic changes. */
946 diagnostic_t diag_class
947 = update_effective_level_from_pragmas (context
, diagnostic
);
949 /* This tests if the user provided the appropriate -Werror=foo
951 if (diag_class
== DK_UNSPECIFIED
952 && (context
->classify_diagnostic
[diagnostic
->option_index
]
955 = context
->classify_diagnostic
[diagnostic
->option_index
];
957 /* This allows for future extensions, like temporarily disabling
958 warnings for ranges of source code. */
959 if (diagnostic
->kind
== DK_IGNORED
)
963 if (diagnostic
->kind
!= DK_NOTE
)
964 diagnostic_check_max_errors (context
);
968 if (diagnostic
->kind
== DK_ICE
|| diagnostic
->kind
== DK_ICE_NOBT
)
970 /* When not checking, ICEs are converted to fatal errors when an
971 error has already occurred. This is counteracted by
974 && (diagnostic_kind_count (context
, DK_ERROR
) > 0
975 || diagnostic_kind_count (context
, DK_SORRY
) > 0)
976 && !context
->abort_on_error
)
979 = expand_location (diagnostic_location (diagnostic
));
980 fnotice (stderr
, "%s:%d: confused by earlier errors, bailing out\n",
982 exit (ICE_EXIT_CODE
);
984 if (context
->internal_error
)
985 (*context
->internal_error
) (context
,
986 diagnostic
->message
.format_spec
,
987 diagnostic
->message
.args_ptr
);
989 if (diagnostic
->kind
== DK_ERROR
&& orig_diag_kind
== DK_WARNING
)
990 ++diagnostic_kind_count (context
, DK_WERROR
);
992 ++diagnostic_kind_count (context
, diagnostic
->kind
);
994 /* Is this the initial diagnostic within the stack of groups? */
995 if (context
->diagnostic_group_emission_count
== 0)
997 if (context
->begin_group_cb
)
998 context
->begin_group_cb (context
);
1000 context
->diagnostic_group_emission_count
++;
1002 diagnostic
->message
.x_data
= &diagnostic
->x_data
;
1003 diagnostic
->x_data
= NULL
;
1004 pp_format (context
->printer
, &diagnostic
->message
);
1005 (*diagnostic_starter (context
)) (context
, diagnostic
);
1006 pp_output_formatted_text (context
->printer
);
1007 if (context
->show_option_requested
)
1008 print_option_information (context
, diagnostic
, orig_diag_kind
);
1009 (*diagnostic_finalizer (context
)) (context
, diagnostic
);
1010 if (context
->parseable_fixits_p
)
1012 print_parseable_fixits (context
->printer
, diagnostic
->richloc
);
1013 pp_flush (context
->printer
);
1015 diagnostic_action_after_output (context
, diagnostic
->kind
);
1016 diagnostic
->x_data
= NULL
;
1018 if (context
->edit_context_ptr
)
1019 if (diagnostic
->richloc
->fixits_can_be_auto_applied_p ())
1020 context
->edit_context_ptr
->add_fixits (diagnostic
->richloc
);
1027 /* Given a partial pathname as input, return another pathname that
1028 shares no directory elements with the pathname of __FILE__. This
1029 is used by fancy_abort() to print `Internal compiler error in expr.c'
1030 instead of `Internal compiler error in ../../GCC/gcc/expr.c'. */
1033 trim_filename (const char *name
)
1035 static const char this_file
[] = __FILE__
;
1036 const char *p
= name
, *q
= this_file
;
1038 /* First skip any "../" in each filename. This allows us to give a proper
1039 reference to a file in a subdirectory. */
1040 while (p
[0] == '.' && p
[1] == '.' && IS_DIR_SEPARATOR (p
[2]))
1043 while (q
[0] == '.' && q
[1] == '.' && IS_DIR_SEPARATOR (q
[2]))
1046 /* Now skip any parts the two filenames have in common. */
1047 while (*p
== *q
&& *p
!= 0 && *q
!= 0)
1050 /* Now go backwards until the previous directory separator. */
1051 while (p
> name
&& !IS_DIR_SEPARATOR (p
[-1]))
1057 /* Standard error reporting routines in increasing order of severity.
1058 All of these take arguments like printf. */
1060 /* Text to be emitted verbatim to the error message stream; this
1061 produces no prefix and disables line-wrapping. Use rarely. */
1063 verbatim (const char *gmsgid
, ...)
1068 va_start (ap
, gmsgid
);
1069 text
.err_no
= errno
;
1070 text
.args_ptr
= &ap
;
1071 text
.format_spec
= _(gmsgid
);
1073 pp_format_verbatim (global_dc
->printer
, &text
);
1074 pp_newline_and_flush (global_dc
->printer
);
1078 /* Add a note with text GMSGID and with LOCATION to the diagnostic CONTEXT. */
1080 diagnostic_append_note (diagnostic_context
*context
,
1081 location_t location
,
1082 const char * gmsgid
, ...)
1084 diagnostic_info diagnostic
;
1086 rich_location
richloc (line_table
, location
);
1088 va_start (ap
, gmsgid
);
1089 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, &richloc
, DK_NOTE
);
1090 if (context
->inhibit_notes_p
)
1095 char *saved_prefix
= pp_take_prefix (context
->printer
);
1096 pp_set_prefix (context
->printer
,
1097 diagnostic_build_prefix (context
, &diagnostic
));
1098 pp_format (context
->printer
, &diagnostic
.message
);
1099 pp_output_formatted_text (context
->printer
);
1100 pp_destroy_prefix (context
->printer
);
1101 pp_set_prefix (context
->printer
, saved_prefix
);
1102 diagnostic_show_locus (context
, &richloc
, DK_NOTE
);
1106 /* Implement emit_diagnostic, inform, warning, warning_at, pedwarn,
1107 permerror, error, error_at, error_at, sorry, fatal_error, internal_error,
1108 and internal_error_no_backtrace, as documented and defined below. */
1110 diagnostic_impl (rich_location
*richloc
, int opt
,
1112 va_list *ap
, diagnostic_t kind
)
1114 diagnostic_info diagnostic
;
1115 if (kind
== DK_PERMERROR
)
1117 diagnostic_set_info (&diagnostic
, gmsgid
, ap
, richloc
,
1118 permissive_error_kind (global_dc
));
1119 diagnostic
.option_index
= permissive_error_option (global_dc
);
1123 diagnostic_set_info (&diagnostic
, gmsgid
, ap
, richloc
, kind
);
1124 if (kind
== DK_WARNING
|| kind
== DK_PEDWARN
)
1125 diagnostic
.option_index
= opt
;
1127 return diagnostic_report_diagnostic (global_dc
, &diagnostic
);
1130 /* Implement inform_n, warning_n, and error_n, as documented and
1133 diagnostic_n_impl (rich_location
*richloc
, int opt
, unsigned HOST_WIDE_INT n
,
1134 const char *singular_gmsgid
,
1135 const char *plural_gmsgid
,
1136 va_list *ap
, diagnostic_t kind
)
1138 diagnostic_info diagnostic
;
1141 if (sizeof n
<= sizeof gtn
)
1144 /* Use the largest number ngettext can handle, otherwise
1145 preserve the six least significant decimal digits for
1146 languages where the plural form depends on them. */
1147 gtn
= n
<= ULONG_MAX
? n
: n
% 1000000LU + 1000000LU;
1149 const char *text
= ngettext (singular_gmsgid
, plural_gmsgid
, gtn
);
1150 diagnostic_set_info_translated (&diagnostic
, text
, ap
, richloc
, kind
);
1151 if (kind
== DK_WARNING
)
1152 diagnostic
.option_index
= opt
;
1153 return diagnostic_report_diagnostic (global_dc
, &diagnostic
);
1156 /* Wrapper around diagnostic_impl taking a variable argument list. */
1159 emit_diagnostic (diagnostic_t kind
, location_t location
, int opt
,
1160 const char *gmsgid
, ...)
1162 auto_diagnostic_group d
;
1164 va_start (ap
, gmsgid
);
1165 rich_location
richloc (line_table
, location
);
1166 bool ret
= diagnostic_impl (&richloc
, opt
, gmsgid
, &ap
, kind
);
1171 /* Wrapper around diagnostic_impl taking a va_list parameter. */
1174 emit_diagnostic_valist (diagnostic_t kind
, location_t location
, int opt
,
1175 const char *gmsgid
, va_list *ap
)
1177 rich_location
richloc (line_table
, location
);
1178 return diagnostic_impl (&richloc
, opt
, gmsgid
, ap
, kind
);
1181 /* An informative note at LOCATION. Use this for additional details on an error
1184 inform (location_t location
, const char *gmsgid
, ...)
1186 auto_diagnostic_group d
;
1188 va_start (ap
, gmsgid
);
1189 rich_location
richloc (line_table
, location
);
1190 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_NOTE
);
1194 /* Same as "inform" above, but at RICHLOC. */
1196 inform (rich_location
*richloc
, const char *gmsgid
, ...)
1198 gcc_assert (richloc
);
1200 auto_diagnostic_group d
;
1202 va_start (ap
, gmsgid
);
1203 diagnostic_impl (richloc
, -1, gmsgid
, &ap
, DK_NOTE
);
1207 /* An informative note at LOCATION. Use this for additional details on an
1210 inform_n (location_t location
, unsigned HOST_WIDE_INT n
,
1211 const char *singular_gmsgid
, const char *plural_gmsgid
, ...)
1214 va_start (ap
, plural_gmsgid
);
1215 auto_diagnostic_group d
;
1216 rich_location
richloc (line_table
, location
);
1217 diagnostic_n_impl (&richloc
, -1, n
, singular_gmsgid
, plural_gmsgid
,
1222 /* A warning at INPUT_LOCATION. Use this for code which is correct according
1223 to the relevant language specification but is likely to be buggy anyway.
1224 Returns true if the warning was printed, false if it was inhibited. */
1226 warning (int opt
, const char *gmsgid
, ...)
1228 auto_diagnostic_group d
;
1230 va_start (ap
, gmsgid
);
1231 rich_location
richloc (line_table
, input_location
);
1232 bool ret
= diagnostic_impl (&richloc
, opt
, gmsgid
, &ap
, DK_WARNING
);
1237 /* A warning at LOCATION. Use this for code which is correct according to the
1238 relevant language specification but is likely to be buggy anyway.
1239 Returns true if the warning was printed, false if it was inhibited. */
1242 warning_at (location_t location
, int opt
, const char *gmsgid
, ...)
1244 auto_diagnostic_group d
;
1246 va_start (ap
, gmsgid
);
1247 rich_location
richloc (line_table
, location
);
1248 bool ret
= diagnostic_impl (&richloc
, opt
, gmsgid
, &ap
, DK_WARNING
);
1253 /* Same as "warning at" above, but using RICHLOC. */
1256 warning_at (rich_location
*richloc
, int opt
, const char *gmsgid
, ...)
1258 gcc_assert (richloc
);
1260 auto_diagnostic_group d
;
1262 va_start (ap
, gmsgid
);
1263 bool ret
= diagnostic_impl (richloc
, opt
, gmsgid
, &ap
, DK_WARNING
);
1268 /* Same as warning_n plural variant below, but using RICHLOC. */
1271 warning_n (rich_location
*richloc
, int opt
, unsigned HOST_WIDE_INT n
,
1272 const char *singular_gmsgid
, const char *plural_gmsgid
, ...)
1274 gcc_assert (richloc
);
1276 auto_diagnostic_group d
;
1278 va_start (ap
, plural_gmsgid
);
1279 bool ret
= diagnostic_n_impl (richloc
, opt
, n
,
1280 singular_gmsgid
, plural_gmsgid
,
1286 /* A warning at LOCATION. Use this for code which is correct according to the
1287 relevant language specification but is likely to be buggy anyway.
1288 Returns true if the warning was printed, false if it was inhibited. */
1291 warning_n (location_t location
, int opt
, unsigned HOST_WIDE_INT n
,
1292 const char *singular_gmsgid
, const char *plural_gmsgid
, ...)
1294 auto_diagnostic_group d
;
1296 va_start (ap
, plural_gmsgid
);
1297 rich_location
richloc (line_table
, location
);
1298 bool ret
= diagnostic_n_impl (&richloc
, opt
, n
,
1299 singular_gmsgid
, plural_gmsgid
,
1305 /* A "pedantic" warning at LOCATION: issues a warning unless
1306 -pedantic-errors was given on the command line, in which case it
1307 issues an error. Use this for diagnostics required by the relevant
1308 language standard, if you have chosen not to make them errors.
1310 Note that these diagnostics are issued independent of the setting
1311 of the -Wpedantic command-line switch. To get a warning enabled
1312 only with that switch, use either "if (pedantic) pedwarn
1313 (OPT_Wpedantic,...)" or just "pedwarn (OPT_Wpedantic,..)". To get a
1314 pedwarn independently of the -Wpedantic switch use "pedwarn (0,...)".
1316 Returns true if the warning was printed, false if it was inhibited. */
1319 pedwarn (location_t location
, int opt
, const char *gmsgid
, ...)
1321 auto_diagnostic_group d
;
1323 va_start (ap
, gmsgid
);
1324 rich_location
richloc (line_table
, location
);
1325 bool ret
= diagnostic_impl (&richloc
, opt
, gmsgid
, &ap
, DK_PEDWARN
);
1330 /* Same as pedwarn above, but using RICHLOC. */
1333 pedwarn (rich_location
*richloc
, int opt
, const char *gmsgid
, ...)
1335 gcc_assert (richloc
);
1337 auto_diagnostic_group d
;
1339 va_start (ap
, gmsgid
);
1340 bool ret
= diagnostic_impl (richloc
, opt
, gmsgid
, &ap
, DK_PEDWARN
);
1345 /* A "permissive" error at LOCATION: issues an error unless
1346 -fpermissive was given on the command line, in which case it issues
1347 a warning. Use this for things that really should be errors but we
1348 want to support legacy code.
1350 Returns true if the warning was printed, false if it was inhibited. */
1353 permerror (location_t location
, const char *gmsgid
, ...)
1355 auto_diagnostic_group d
;
1357 va_start (ap
, gmsgid
);
1358 rich_location
richloc (line_table
, location
);
1359 bool ret
= diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_PERMERROR
);
1364 /* Same as "permerror" above, but at RICHLOC. */
1367 permerror (rich_location
*richloc
, const char *gmsgid
, ...)
1369 gcc_assert (richloc
);
1371 auto_diagnostic_group d
;
1373 va_start (ap
, gmsgid
);
1374 bool ret
= diagnostic_impl (richloc
, -1, gmsgid
, &ap
, DK_PERMERROR
);
1379 /* A hard error: the code is definitely ill-formed, and an object file
1380 will not be produced. */
1382 error (const char *gmsgid
, ...)
1384 auto_diagnostic_group d
;
1386 va_start (ap
, gmsgid
);
1387 rich_location
richloc (line_table
, input_location
);
1388 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_ERROR
);
1392 /* A hard error: the code is definitely ill-formed, and an object file
1393 will not be produced. */
1395 error_n (location_t location
, unsigned HOST_WIDE_INT n
,
1396 const char *singular_gmsgid
, const char *plural_gmsgid
, ...)
1398 auto_diagnostic_group d
;
1400 va_start (ap
, plural_gmsgid
);
1401 rich_location
richloc (line_table
, location
);
1402 diagnostic_n_impl (&richloc
, -1, n
, singular_gmsgid
, plural_gmsgid
,
1407 /* Same as above, but use location LOC instead of input_location. */
1409 error_at (location_t loc
, const char *gmsgid
, ...)
1411 auto_diagnostic_group d
;
1413 va_start (ap
, gmsgid
);
1414 rich_location
richloc (line_table
, loc
);
1415 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_ERROR
);
1419 /* Same as above, but use RICH_LOC. */
1422 error_at (rich_location
*richloc
, const char *gmsgid
, ...)
1424 gcc_assert (richloc
);
1426 auto_diagnostic_group d
;
1428 va_start (ap
, gmsgid
);
1429 diagnostic_impl (richloc
, -1, gmsgid
, &ap
, DK_ERROR
);
1433 /* "Sorry, not implemented." Use for a language feature which is
1434 required by the relevant specification but not implemented by GCC.
1435 An object file will not be produced. */
1437 sorry (const char *gmsgid
, ...)
1439 auto_diagnostic_group d
;
1441 va_start (ap
, gmsgid
);
1442 rich_location
richloc (line_table
, input_location
);
1443 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_SORRY
);
1447 /* Same as above, but use location LOC instead of input_location. */
1449 sorry_at (location_t loc
, const char *gmsgid
, ...)
1451 auto_diagnostic_group d
;
1453 va_start (ap
, gmsgid
);
1454 rich_location
richloc (line_table
, loc
);
1455 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_SORRY
);
1459 /* Return true if an error or a "sorry" has been seen. Various
1460 processing is disabled after errors. */
1464 return errorcount
|| sorrycount
;
1467 /* An error which is severe enough that we make no attempt to
1468 continue. Do not use this for internal consistency checks; that's
1469 internal_error. Use of this function should be rare. */
1471 fatal_error (location_t loc
, const char *gmsgid
, ...)
1473 auto_diagnostic_group d
;
1475 va_start (ap
, gmsgid
);
1476 rich_location
richloc (line_table
, loc
);
1477 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_FATAL
);
1483 /* An internal consistency check has failed. We make no attempt to
1484 continue. Note that unless there is debugging value to be had from
1485 a more specific message, or some other good reason, you should use
1486 abort () instead of calling this function directly. */
1488 internal_error (const char *gmsgid
, ...)
1490 auto_diagnostic_group d
;
1492 va_start (ap
, gmsgid
);
1493 rich_location
richloc (line_table
, input_location
);
1494 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_ICE
);
1500 /* Like internal_error, but no backtrace will be printed. Used when
1501 the internal error does not happen at the current location, but happened
1504 internal_error_no_backtrace (const char *gmsgid
, ...)
1506 auto_diagnostic_group d
;
1508 va_start (ap
, gmsgid
);
1509 rich_location
richloc (line_table
, input_location
);
1510 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_ICE_NOBT
);
1516 /* Special case error functions. Most are implemented in terms of the
1517 above, or should be. */
1519 /* Print a diagnostic MSGID on FILE. This is just fprintf, except it
1520 runs its second argument through gettext. */
1522 fnotice (FILE *file
, const char *cmsgid
, ...)
1526 va_start (ap
, cmsgid
);
1527 vfprintf (file
, _(cmsgid
), ap
);
1531 /* Inform the user that an error occurred while trying to report some
1532 other error. This indicates catastrophic internal inconsistencies,
1533 so give up now. But do try to flush out the previous error.
1534 This mustn't use internal_error, that will cause infinite recursion. */
1537 error_recursion (diagnostic_context
*context
)
1539 if (context
->lock
< 3)
1540 pp_newline_and_flush (context
->printer
);
1543 "Internal compiler error: Error reporting routines re-entered.\n");
1545 /* Call diagnostic_action_after_output to get the "please submit a bug
1547 diagnostic_action_after_output (context
, DK_ICE
);
1549 /* Do not use gcc_unreachable here; that goes through internal_error
1550 and therefore would cause infinite recursion. */
1554 /* Report an internal compiler error in a friendly manner. This is
1555 the function that gets called upon use of abort() in the source
1556 code generally, thanks to a special macro. */
1559 fancy_abort (const char *file
, int line
, const char *function
)
1561 internal_error ("in %s, at %s:%d", function
, trim_filename (file
), line
);
1564 /* class auto_diagnostic_group. */
1566 /* Constructor: "push" this group into global_dc. */
1568 auto_diagnostic_group::auto_diagnostic_group ()
1570 global_dc
->diagnostic_group_nesting_depth
++;
1573 /* Destructor: "pop" this group from global_dc. */
1575 auto_diagnostic_group::~auto_diagnostic_group ()
1577 if (--global_dc
->diagnostic_group_nesting_depth
== 0)
1579 /* Handle the case where we've popped the final diagnostic group.
1580 If any diagnostics were emitted, give the context a chance
1582 if (global_dc
->diagnostic_group_emission_count
> 0)
1584 if (global_dc
->end_group_cb
)
1585 global_dc
->end_group_cb (global_dc
);
1587 global_dc
->diagnostic_group_emission_count
= 0;
1591 /* Really call the system 'abort'. This has to go right at the end of
1592 this file, so that there are no functions after it that call abort
1593 and get the system abort instead of our macro. */
1603 namespace selftest
{
1605 /* Helper function for test_print_escaped_string. */
1608 assert_print_escaped_string (const location
&loc
, const char *expected_output
,
1612 print_escaped_string (&pp
, input
);
1613 ASSERT_STREQ_AT (loc
, expected_output
, pp_formatted_text (&pp
));
1616 #define ASSERT_PRINT_ESCAPED_STRING_STREQ(EXPECTED_OUTPUT, INPUT) \
1617 assert_print_escaped_string (SELFTEST_LOCATION, EXPECTED_OUTPUT, INPUT)
1619 /* Tests of print_escaped_string. */
1622 test_print_escaped_string ()
1625 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"\"", "");
1627 /* Non-empty string. */
1628 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"hello world\"", "hello world");
1630 /* Various things that need to be escaped: */
1632 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\\\after\"",
1635 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\tafter\"",
1638 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\nafter\"",
1641 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\\"after\"",
1644 /* Non-printable characters: BEL: '\a': 0x07 */
1645 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\007after\"",
1647 /* Non-printable characters: vertical tab: '\v': 0x0b */
1648 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\013after\"",
1652 /* Tests of print_parseable_fixits. */
1654 /* Verify that print_parseable_fixits emits the empty string if there
1658 test_print_parseable_fixits_none ()
1661 rich_location
richloc (line_table
, UNKNOWN_LOCATION
);
1663 print_parseable_fixits (&pp
, &richloc
);
1664 ASSERT_STREQ ("", pp_formatted_text (&pp
));
1667 /* Verify that print_parseable_fixits does the right thing if there
1668 is an insertion fixit hint. */
1671 test_print_parseable_fixits_insert ()
1674 rich_location
richloc (line_table
, UNKNOWN_LOCATION
);
1676 linemap_add (line_table
, LC_ENTER
, false, "test.c", 0);
1677 linemap_line_start (line_table
, 5, 100);
1678 linemap_add (line_table
, LC_LEAVE
, false, NULL
, 0);
1679 location_t where
= linemap_position_for_column (line_table
, 10);
1680 richloc
.add_fixit_insert_before (where
, "added content");
1682 print_parseable_fixits (&pp
, &richloc
);
1683 ASSERT_STREQ ("fix-it:\"test.c\":{5:10-5:10}:\"added content\"\n",
1684 pp_formatted_text (&pp
));
1687 /* Verify that print_parseable_fixits does the right thing if there
1688 is an removal fixit hint. */
1691 test_print_parseable_fixits_remove ()
1694 rich_location
richloc (line_table
, UNKNOWN_LOCATION
);
1696 linemap_add (line_table
, LC_ENTER
, false, "test.c", 0);
1697 linemap_line_start (line_table
, 5, 100);
1698 linemap_add (line_table
, LC_LEAVE
, false, NULL
, 0);
1700 where
.m_start
= linemap_position_for_column (line_table
, 10);
1701 where
.m_finish
= linemap_position_for_column (line_table
, 20);
1702 richloc
.add_fixit_remove (where
);
1704 print_parseable_fixits (&pp
, &richloc
);
1705 ASSERT_STREQ ("fix-it:\"test.c\":{5:10-5:21}:\"\"\n",
1706 pp_formatted_text (&pp
));
1709 /* Verify that print_parseable_fixits does the right thing if there
1710 is an replacement fixit hint. */
1713 test_print_parseable_fixits_replace ()
1716 rich_location
richloc (line_table
, UNKNOWN_LOCATION
);
1718 linemap_add (line_table
, LC_ENTER
, false, "test.c", 0);
1719 linemap_line_start (line_table
, 5, 100);
1720 linemap_add (line_table
, LC_LEAVE
, false, NULL
, 0);
1722 where
.m_start
= linemap_position_for_column (line_table
, 10);
1723 where
.m_finish
= linemap_position_for_column (line_table
, 20);
1724 richloc
.add_fixit_replace (where
, "replacement");
1726 print_parseable_fixits (&pp
, &richloc
);
1727 ASSERT_STREQ ("fix-it:\"test.c\":{5:10-5:21}:\"replacement\"\n",
1728 pp_formatted_text (&pp
));
1732 diagnostic_get_location_text (..., SHOW_COLUMN)
1733 generates EXPECTED_LOC_TEXT, given FILENAME, LINE, COLUMN, with
1734 colorization disabled. */
1737 assert_location_text (const char *expected_loc_text
,
1738 const char *filename
, int line
, int column
,
1741 test_diagnostic_context dc
;
1742 dc
.show_column
= show_column
;
1744 expanded_location xloc
;
1745 xloc
.file
= filename
;
1747 xloc
.column
= column
;
1751 char *actual_loc_text
= diagnostic_get_location_text (&dc
, xloc
);
1752 ASSERT_STREQ (expected_loc_text
, actual_loc_text
);
1753 free (actual_loc_text
);
1756 /* Verify that diagnostic_get_location_text works as expected. */
1759 test_diagnostic_get_location_text ()
1761 const char *old_progname
= progname
;
1762 progname
= "PROGNAME";
1763 assert_location_text ("PROGNAME:", NULL
, 0, 0, true);
1764 assert_location_text ("<built-in>:", "<built-in>", 42, 10, true);
1765 assert_location_text ("foo.c:42:10:", "foo.c", 42, 10, true);
1766 assert_location_text ("foo.c:42:", "foo.c", 42, 0, true);
1767 assert_location_text ("foo.c:", "foo.c", 0, 10, true);
1768 assert_location_text ("foo.c:42:", "foo.c", 42, 10, false);
1769 assert_location_text ("foo.c:", "foo.c", 0, 10, false);
1771 maybe_line_and_column (INT_MAX
, INT_MAX
);
1772 maybe_line_and_column (INT_MIN
, INT_MIN
);
1774 progname
= old_progname
;
1777 /* Run all of the selftests within this file. */
1780 diagnostic_c_tests ()
1782 test_print_escaped_string ();
1783 test_print_parseable_fixits_none ();
1784 test_print_parseable_fixits_insert ();
1785 test_print_parseable_fixits_remove ();
1786 test_print_parseable_fixits_replace ();
1787 test_diagnostic_get_location_text ();
1790 } // namespace selftest
1792 #endif /* #if CHECKING_P */