gcc/input.h

   1 /* Declarations for variables relating to reading the source file.
   2    Used by parsers, lexical analyzers, and error message routines.
   3    Copyright (C) 1993-2016 Free Software Foundation, Inc.
   4
   5 This file is part of GCC.
   6
   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
  10 version.
  11
  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
  15 for more details.
  16
  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/>.  */
  20
  21 #ifndef GCC_INPUT_H
  22 #define GCC_INPUT_H
  23
  24 #include "line-map.h"
  25
  26 extern GTY(()) struct line_maps *line_table;
  27 extern GTY(()) struct line_maps *saved_line_table;
  28
  29 /* A value which will never be used to represent a real location.  */
  30 #define UNKNOWN_LOCATION ((source_location) 0)
  31
  32 /* The location for declarations in "<built-in>" */
  33 #define BUILTINS_LOCATION ((source_location) 1)
  34
  35 /* line-map.c reserves RESERVED_LOCATION_COUNT to the user.  Ensure
  36    both UNKNOWN_LOCATION and BUILTINS_LOCATION fit into that.  */
  37 extern char builtins_location_check[(BUILTINS_LOCATION
  38                                      < RESERVED_LOCATION_COUNT) ? 1 : -1];
  39
  40 extern bool is_location_from_builtin_token (source_location);
  41 extern expanded_location expand_location (source_location);
  42 extern const char *location_get_source_line (const char *file_path, int line,
  43                                              int *line_size);
  44 extern bool location_missing_trailing_newline (const char *file_path);
  45 extern expanded_location expand_location_to_spelling_point (source_location);
  46 extern source_location expansion_point_location_if_in_system_header (source_location);
  47 extern source_location expansion_point_location (source_location);
  48
  49 /* Historically GCC used location_t, while cpp used source_location.
  50    This could be removed but it hardly seems worth the effort.  */
  51 typedef source_location location_t;
  52
  53 extern location_t input_location;
  54
  55 #define LOCATION_FILE(LOC) ((expand_location (LOC)).file)
  56 #define LOCATION_LINE(LOC) ((expand_location (LOC)).line)
  57 #define LOCATION_COLUMN(LOC)((expand_location (LOC)).column)
  58 #define LOCATION_LOCUS(LOC) \
  59   ((IS_ADHOC_LOC (LOC)) ? get_location_from_adhoc_loc (line_table, LOC) \
  60    : (LOC))
  61 #define LOCATION_BLOCK(LOC) \
  62   ((tree) ((IS_ADHOC_LOC (LOC)) ? get_data_from_adhoc_loc (line_table, (LOC)) \
  63    : NULL))
  64
  65 /* Return a positive value if LOCATION is the locus of a token that is
  66    located in a system header, O otherwise. It returns 1 if LOCATION
  67    is the locus of a token that is located in a system header, and 2
  68    if LOCATION is the locus of a token located in a C system header
  69    that therefore needs to be extern "C" protected in C++.
  70
  71    Note that this function returns 1 if LOCATION belongs to a token
  72    that is part of a macro replacement-list defined in a system
  73    header, but expanded in a non-system file.  */
  74 #define in_system_header_at(LOC) \
  75   (linemap_location_in_system_header_p (line_table, LOC))
  76 /* Return a positive value if LOCATION is the locus of a token that
  77    comes from a macro expansion, O otherwise.  */
  78 #define from_macro_expansion_at(LOC) \
  79   ((linemap_location_from_macro_expansion_p (line_table, LOC)))
  80 /* Return a positive value if LOCATION is the locus of a token that comes from
  81    a macro definition, O otherwise.  This differs from from_macro_expansion_at
  82    in its treatment of macro arguments, for which this returns false.  */
  83 #define from_macro_definition_at(LOC) \
  84   ((linemap_location_from_macro_definition_p (line_table, LOC)))
  85
  86 static inline location_t
  87 get_pure_location (location_t loc)
  88 {
  89   return get_pure_location (line_table, loc);
  90 }
  91
  92 /* Get the start of any range encoded within location LOC.  */
  93
  94 static inline location_t
  95 get_start (location_t loc)
  96 {
  97   return get_range_from_loc (line_table, loc).m_start;
  98 }
  99
 100 /* Get the endpoint of any range encoded within location LOC.  */
 101
 102 static inline location_t
 103 get_finish (location_t loc)
 104 {
 105   return get_range_from_loc (line_table, loc).m_finish;
 106 }
 107
 108 extern location_t make_location (location_t caret,
 109                                  location_t start, location_t finish);
 110
 111 void dump_line_table_statistics (void);
 112
 113 void dump_location_info (FILE *stream);
 114
 115 void diagnostics_file_cache_fini (void);
 116
 117 void diagnostics_file_cache_forcibly_evict_file (const char *file_path);
 118
 119 struct GTY(()) string_concat
 120 {
 121   string_concat (int num, location_t *locs);
 122
 123   int m_num;
 124   location_t * GTY ((atomic)) m_locs;
 125 };
 126
 127 struct location_hash : int_hash <location_t, UNKNOWN_LOCATION> { };
 128
 129 class GTY(()) string_concat_db
 130 {
 131  public:
 132   string_concat_db ();
 133   void record_string_concatenation (int num, location_t *locs);
 134
 135   bool get_string_concatenation (location_t loc,
 136                                  int *out_num,
 137                                  location_t **out_locs);
 138
 139  private:
 140   static location_t get_key_loc (location_t loc);
 141
 142   /* For the fields to be private, we must grant access to the
 143      generated code in gtype-desc.c.  */
 144
 145   friend void ::gt_ggc_mx_string_concat_db (void *x_p);
 146   friend void ::gt_pch_nx_string_concat_db (void *x_p);
 147   friend void ::gt_pch_p_16string_concat_db (void *this_obj, void *x_p,
 148                                              gt_pointer_operator op,
 149                                              void *cookie);
 150
 151   hash_map <location_hash, string_concat *> *m_table;
 152 };
 153
 154 #endif