127 lines
5.0 KiB
C
127 lines
5.0 KiB
C
/* Map logical line numbers to (source file, line number) pairs.
|
|
Copyright (C) 2001, 2003
|
|
Free Software Foundation, Inc.
|
|
|
|
This program is free software; you can redistribute it and/or modify it
|
|
under the terms of the GNU General Public License as published by the
|
|
Free Software Foundation; either version 2, or (at your option) any
|
|
later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
|
|
In other words, you are welcome to use, share and improve this program.
|
|
You are forbidden to forbid anyone else to use, share and improve
|
|
what you give them. Help stamp out software-hoarding! */
|
|
|
|
#ifndef GCC_LINE_MAP_H
|
|
#define GCC_LINE_MAP_H
|
|
|
|
/* Reason for adding a line change with add_line_map (). LC_ENTER is
|
|
when including a new file, e.g. a #include directive in C.
|
|
LC_LEAVE is when reaching a file's end. LC_RENAME is when a file
|
|
name or line number changes for neither of the above reasons
|
|
(e.g. a #line directive in C). */
|
|
enum lc_reason {LC_ENTER = 0, LC_LEAVE, LC_RENAME};
|
|
|
|
/* A logical line number, i,e, an "index" into a line_map. */
|
|
/* Long-term, we want to use this to replace struct location_s (in input.h),
|
|
and effectively typedef source_location location_t. */
|
|
typedef unsigned int source_location;
|
|
typedef source_location fileline; /* deprecated name */
|
|
|
|
/* The logical line FROM_LINE maps to physical source file TO_FILE at
|
|
line TO_LINE, and subsequently one-to-one until the next line_map
|
|
structure in the set. INCLUDED_FROM is an index into the set that
|
|
gives the line mapping at whose end the current one was included.
|
|
File(s) at the bottom of the include stack have this set to -1.
|
|
REASON is the reason for creation of this line map, SYSP is one for
|
|
a system header, two for a C system header file that therefore
|
|
needs to be extern "C" protected in C++, and zero otherwise. */
|
|
struct line_map
|
|
{
|
|
const char *to_file;
|
|
unsigned int to_line;
|
|
source_location from_line;
|
|
int included_from;
|
|
ENUM_BITFIELD (lc_reason) reason : CHAR_BIT;
|
|
unsigned char sysp;
|
|
};
|
|
|
|
/* A set of chronological line_map structures. */
|
|
struct line_maps
|
|
{
|
|
struct line_map *maps;
|
|
unsigned int allocated;
|
|
unsigned int used;
|
|
|
|
/* The most recently listed include stack, if any, starts with
|
|
LAST_LISTED as the topmost including file. -1 indicates nothing
|
|
has been listed yet. */
|
|
int last_listed;
|
|
|
|
/* Depth of the include stack, including the current file. */
|
|
unsigned int depth;
|
|
|
|
/* If true, prints an include trace a la -H. */
|
|
bool trace_includes;
|
|
};
|
|
|
|
/* Initialize a line map set. */
|
|
extern void linemap_init (struct line_maps *);
|
|
|
|
/* Free a line map set. */
|
|
extern void linemap_free (struct line_maps *);
|
|
|
|
/* Add a mapping of logical source line to physical source file and
|
|
line number.
|
|
|
|
The text pointed to by TO_FILE must have a lifetime
|
|
at least as long as the final call to lookup_line (). An empty
|
|
TO_FILE means standard input. If reason is LC_LEAVE, and
|
|
TO_FILE is NULL, then TO_FILE, TO_LINE and SYSP are given their
|
|
natural values considering the file we are returning to.
|
|
|
|
FROM_LINE should be monotonic increasing across calls to this
|
|
function. A call to this function can relocate the previous set of
|
|
maps, so any stored line_map pointers should not be used. */
|
|
extern const struct line_map *linemap_add
|
|
(struct line_maps *, enum lc_reason, unsigned int sysp,
|
|
source_location from_line, const char *to_file, unsigned int to_line);
|
|
|
|
/* Given a logical line, returns the map from which the corresponding
|
|
(source file, line) pair can be deduced. */
|
|
extern const struct line_map *linemap_lookup
|
|
(struct line_maps *, source_location);
|
|
|
|
/* Print the file names and line numbers of the #include commands
|
|
which led to the map MAP, if any, to stderr. Nothing is output if
|
|
the most recently listed stack is the same as the current one. */
|
|
extern void linemap_print_containing_files (struct line_maps *,
|
|
const struct line_map *);
|
|
|
|
/* Converts a map and logical line to source line. */
|
|
#define SOURCE_LINE(MAP, LINE) ((LINE) + (MAP)->to_line - (MAP)->from_line)
|
|
|
|
/* Returns the last source line within a map. This is the (last) line
|
|
of the #include, or other directive, that caused a map change. */
|
|
#define LAST_SOURCE_LINE(MAP) SOURCE_LINE ((MAP), (MAP)[1].from_line - 1)
|
|
|
|
/* Returns the map a given map was included from. */
|
|
#define INCLUDED_FROM(SET, MAP) (&(SET)->maps[(MAP)->included_from])
|
|
|
|
/* Nonzero if the map is at the bottom of the include stack. */
|
|
#define MAIN_FILE_P(MAP) ((MAP)->included_from < 0)
|
|
|
|
/* The current line map. Saves a call to lookup_line if the caller is
|
|
sure he is in the scope of the current map. */
|
|
#define CURRENT_LINE_MAP(MAPS) ((MAPS)->maps + (MAPS)->used - 1)
|
|
|
|
#endif /* !GCC_LINE_MAP_H */
|