------------------------------------------------------------------------------ -- -- -- GNAT COMPILER COMPONENTS -- -- -- -- S I N P U T . L -- -- -- -- S p e c -- -- -- -- Copyright (C) 1992-2019, Free Software Foundation, Inc. -- -- -- -- GNAT is free software; you can redistribute it and/or modify it under -- -- terms of the GNU General Public License as published by the Free Soft- -- -- ware Foundation; either version 3, or (at your option) any later ver- -- -- sion. GNAT is distributed in the hope that it will be useful, but WITH- -- -- OUT 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 distributed with GNAT; see file COPYING3. If not, go to -- -- http://www.gnu.org/licenses for a complete copy of the license. -- -- -- -- GNAT was originally developed by the GNAT team at New York University. -- -- Extensive contributions were provided by Ada Core Technologies Inc. -- -- -- ------------------------------------------------------------------------------ -- This child package contains the routines used to actually load a source -- file and create entries in the source file table. It also contains the -- routines to create virtual entries for instantiations. This is separated -- off into a child package to avoid a dependence of Sinput on Osint which -- would cause trouble in the tree read/write routines. package Sinput.L is ------------------------------------------ -- Subprograms for Loading Source Files -- ------------------------------------------ function Load_Source_File (N : File_Name_Type) return Source_File_Index; -- Given a source file name, returns the index of the corresponding entry -- in the source file table. If the file is not currently loaded, then -- this is the call that causes the source file to be read and an entry -- made in the table. A new entry in the table has the file name and time -- stamp entries set and the Casing entries set to Unknown. Version is set -- to all blanks, and the lines table is initialized but only the first -- entry is set (and Last_Line is set to 1). If the given source file -- cannot be opened, then the value returned is No_Source_File. function Load_Config_File (N : File_Name_Type) return Source_File_Index; -- Similar to Load_Source_File, except that the file name is always -- interpreted in the context of the current working directory. -- The file is never preprocessed. function Load_Definition_File (N : File_Name_Type) return Source_File_Index; -- Loads preprocessing definition file. Similar to Load_Source_File -- except that this file is not itself preprocessed. function Load_Preprocessing_Data_File (N : File_Name_Type) return Source_File_Index; -- Loads preprocessing data file. Similar to Load_Source_File except -- that this file is not itself preprocessed. procedure Complete_Source_File_Entry; -- Called on completing the parsing of a source file. This call completes -- the source file table entry for the current source file. function Source_File_Is_Body (X : Source_File_Index) return Boolean; -- Returns true if the designated source file contains a subprogram body -- or a package body. This is a limited scan just to determine the answer -- to this question. function Source_File_Is_No_Body (X : Source_File_Index) return Boolean; -- Returns true if the designated source file contains pragma No_Body; -- and no other tokens. If the source file contains anything other than -- this sequence of three tokens, then False is returned. ------------------------------------------------- -- Subprograms for Dealing With Instantiations -- ------------------------------------------------- type Sloc_Adjustment is private; -- Type returned by Create_Instantiation_Source for use in subsequent calls -- to Adjust_Instantiation_Sloc. procedure Adjust_Instantiation_Sloc (N : Node_Id; Factor : Sloc_Adjustment); -- The instantiation tree is created by copying the tree of the generic -- template (including the original Sloc values), and then applying -- Adjust_Instantiation_Sloc to each copied node to adjust the Sloc to -- reference the source entry for the instantiation. procedure Create_Instantiation_Source (Inst_Node : Entity_Id; Template_Id : Entity_Id; Factor : out Sloc_Adjustment; Inlined_Body : Boolean := False; Inherited_Pragma : Boolean := False); -- This procedure creates the source table entry for an instantiation. -- Inst_Node is the instantiation node, and Template_Id is the defining -- identifier of the generic declaration or body unit as appropriate. -- Factor is set to an adjustment factor to be used in subsequent calls to -- Adjust_Instantiation_Sloc. Template_Id can also be a subunit body that -- replaces a stub in a generic unit. -- -- The instantiation mechanism is also used for inlined function and -- procedure calls. The parameter Inlined_Body is set to True in such -- cases. This is used for generating error messages that distinguish these -- two cases, otherwise the two cases are handled identically. Similarly, -- the instantiation mechanism is also used for inherited class-wide pre- -- and postconditions. Parameter Inherited_Pragma is set to True in such -- cases. private type Sloc_Adjustment is record Adjust : Source_Ptr; -- Adjustment factor. To be added to source location values in the -- source table entry for the template to get corresponding sloc -- values for the instantiation image of the template. This is not -- really a Source_Ptr value, but rather an offset, but it is more -- convenient to represent it as a Source_Ptr value and this is a -- private type anyway. Lo, Hi : Source_Ptr; -- Lo and hi values to which adjustment factor can legitimately -- be applied, used to ensure that no incorrect adjustments are -- made. Really it is a bug if anyone ever tries to adjust outside -- this range, but since we are only doing this anyway for getting -- better error messages, it is not critical. end record; end Sinput.L;