annotate gcc/diagnostic-event-id.h @ 158:494b0b89df80 default tip

...
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Mon, 25 May 2020 18:13:55 +0900
parents 1830386684a0
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
145
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
1 /* A class for referring to events within a diagnostic_path.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
2 Copyright (C) 2019-2020 Free Software Foundation, Inc.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
3 Contributed by David Malcolm <dmalcolm@redhat.com>
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
4
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
5 This file is part of GCC.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
6
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
7 GCC is free software; you can redistribute it and/or modify it under
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
8 the terms of the GNU General Public License as published by the Free
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
9 Software Foundation; either version 3, or (at your option) any later
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
10 version.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
11
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
15 for more details.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
16
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
17 You should have received a copy of the GNU General Public License
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
18 along with GCC; see the file COPYING3. If not see
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
19 <http://www.gnu.org/licenses/>. */
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
20
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
21 #ifndef GCC_DIAGNOSTIC_EVENT_ID_H
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
22 #define GCC_DIAGNOSTIC_EVENT_ID_H
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
23
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
24 /* A class for referring to events within a diagnostic_path.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
25
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
26 They are stored as 0-based offsets into the events, but
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
27 printed (e.g. via %@) as 1-based numbers.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
28
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
29 For example, a 3-event path has event offsets 0, 1, and 2,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
30 which would be shown to the user as "(1)", "(2)" and "(3)".
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
31
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
32 This has its own header so that pretty-print.c can use this
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
33 to implement "%@" without bringing in all of diagnostic_path
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
34 (which e.g. refers to "tree"). */
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
35
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
36 class diagnostic_event_id_t
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
37 {
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
38 public:
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
39 diagnostic_event_id_t () : m_index (UNKNOWN_EVENT_IDX) {}
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
40 diagnostic_event_id_t (int zero_based_idx) : m_index (zero_based_idx) {}
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
41
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
42 bool known_p () const { return m_index != UNKNOWN_EVENT_IDX; }
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
43
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
44 int one_based () const
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
45 {
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
46 gcc_assert (known_p ());
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
47 return m_index + 1;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
48 }
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
49
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
50 private:
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
51 static const int UNKNOWN_EVENT_IDX = -1;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
52 int m_index; // zero-based
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
53 };
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
54
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
55 /* A pointer to a diagnostic_event_id_t, for use with the "%@" format
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
56 code, which will print a 1-based representation for it, with suitable
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
57 colorization, e.g. "(1)".
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
58 The %@ format code requires that known_p be true for the event ID. */
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
59 typedef diagnostic_event_id_t *diagnostic_event_id_ptr;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
60
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
61 #endif /* ! GCC_DIAGNOSTIC_EVENT_ID_H */