Subversion Repositories openrisc

------------------------------------------------------------------------------

--                                                                          --

--                         GNAT COMPILER COMPONENTS                         --

--                                                                          --

--                              P R J . U T I L                             --

--                                                                          --

--                                 S p e c                                  --

--                                                                          --

--          Copyright (C) 2001-2011, 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.      --

--                                                                          --

------------------------------------------------------------------------------

--  Utilities for use in processing project files

package Prj.Util is

   function Executable_Of

     (Project        : Project_Id;

      Shared         : Shared_Project_Tree_Data_Access;

      Main           : File_Name_Type;

      Index          : Int;

      Ada_Main       : Boolean := True;

      Language       : String := "";

      Include_Suffix : Boolean := True) return File_Name_Type;

   --  Return the value of the attribute Builder'Executable for file Main in

   --  the project Project, if it exists. If there is no attribute Executable

   --  for Main, remove the suffix from Main; then, if the attribute

   --  Executable_Suffix is specified, add this suffix, otherwise add the

   --  standard executable suffix for the platform.

   --

   --  If Include_Suffix is true, then the ".exe" suffix (or any suffix defined

   --  in the config) will be added. The suffix defined by the user in his own

   --  project file is always taken into account. Otherwise, such a suffix is

   --  not added. In particular, the prefix should not be added if you are

   --  potentially testing for cross-platforms, since the suffix might not be

   --  known (its default value comes from the ...-gnatmake prefix).

   --

   --  What is Ada_Main???

   --  What is Language???

   procedure Put

     (Into_List  : in out Name_List_Index;

      From_List  : String_List_Id;

      In_Tree    : Project_Tree_Ref;

      Lower_Case : Boolean := False);

   --  Append a name list to a string list

   --  Describe parameters???

   procedure Duplicate

     (This    : in out Name_List_Index;

      Shared  : Shared_Project_Tree_Data_Access);

   --  Duplicate a name list

   function Value_Of

     (Variable : Variable_Value;

      Default  : String) return String;

   --  Get the value of a single string variable. If Variable is a string list,

   --  is Nil_Variable_Value,or is defaulted, return Default.

   function Value_Of

     (Index    : Name_Id;

      In_Array : Array_Element_Id;

      Shared   : Shared_Project_Tree_Data_Access) return Name_Id;

   --  Get a single string array component. Returns No_Name if there is no

   --  component Index, if In_Array is null, or if the component is a String

   --  list. Depending on the attribute (only attributes may be associative

   --  arrays) the index may or may not be case sensitive. If the index is not

   --  case sensitive, it is first set to lower case before the search in the

   --  associative array.

   function Value_Of

     (Index                  : Name_Id;

      Src_Index              : Int := 0;

      In_Array               : Array_Element_Id;

      Shared                 : Shared_Project_Tree_Data_Access;

      Force_Lower_Case_Index : Boolean := False;

      Allow_Wildcards        : Boolean := False) return Variable_Value;

   --  Get a string array component (single String or String list). Returns

   --  Nil_Variable_Value if no component Index or if In_Array is null.

   --

   --  Depending on the attribute (only attributes may be associative arrays)

   --  the index may or may not be case sensitive. If the index is not case

   --  sensitive, it is first set to lower case before the search in the

   --  associative array.

   function Value_Of

     (Name                    : Name_Id;

      Index                   : Int := 0;

      Attribute_Or_Array_Name : Name_Id;

      In_Package              : Package_Id;

      Shared                  : Shared_Project_Tree_Data_Access;

      Force_Lower_Case_Index  : Boolean := False;

      Allow_Wildcards         : Boolean := False) return Variable_Value;

   --  In a specific package:

   --   - if there exists an array Attribute_Or_Array_Name with an index Name,

   --     returns the corresponding component (depending on the attribute, the

   --     index may or may not be case sensitive, see previous function),

   --   - otherwise if there is a single attribute Attribute_Or_Array_Name,

   --     returns this attribute,

   --   - otherwise, returns Nil_Variable_Value.

   --  If In_Package is null, returns Nil_Variable_Value.

   function Value_Of

     (Index     : Name_Id;

      In_Array  : Name_Id;

      In_Arrays : Array_Id;

      Shared    : Shared_Project_Tree_Data_Access) return Name_Id;

   --  Get a string array component in an array of an array list. Returns

   --  No_Name if there is no component Index, if In_Arrays is null, if

   --  In_Array is not found in In_Arrays or if the component is a String list.

   function Value_Of

     (Name      : Name_Id;

      In_Arrays : Array_Id;

      Shared    : Shared_Project_Tree_Data_Access) return Array_Element_Id;

   --  Returns a specified array in an array list. Returns No_Array_Element

   --  if In_Arrays is null or if Name is not the name of an array in

   --  In_Arrays. The caller must ensure that Name is in lower case.

   function Value_Of

     (Name        : Name_Id;

      In_Packages : Package_Id;

      Shared      : Shared_Project_Tree_Data_Access) return Package_Id;

   --  Returns a specified package in a package list. Returns No_Package

   --  if In_Packages is null or if Name is not the name of a package in

   --  Package_List. The caller must ensure that Name is in lower case.

   function Value_Of

     (Variable_Name : Name_Id;

      In_Variables  : Variable_Id;

      Shared        : Shared_Project_Tree_Data_Access) return Variable_Value;

   --  Returns a specified variable in a variable list. Returns null if

   --  In_Variables is null or if Variable_Name is not the name of a

   --  variable in In_Variables. Caller must ensure that Name is lower case.

   procedure Write_Str

     (S          : String;

      Max_Length : Positive;

      Separator  : Character);

   --  Output string S using Output.Write_Str. If S is too long to fit in one

   --  line of Max_Length, cut it in several lines, using Separator as the last

   --  character of each line, if possible.

   type Text_File is limited private;

   --  Represents a text file (default is invalid text file)

   function Is_Valid (File : Text_File) return Boolean;

   --  Returns True if File designates an open text file that has not yet been

   --  closed.

   procedure Open (File : out Text_File; Name : String);

   --  Open a text file to read (File is invalid if text file cannot be opened)

   procedure Create (File : out Text_File; Name : String);

   --  Create a text file to write (File is invalid if text file cannot be

   --  created).

   function End_Of_File (File : Text_File) return Boolean;

   --  Returns True if the end of the text file File has been reached. Fails if

   --  File is invalid. Return True if File is an out file.

   procedure Get_Line

     (File : Text_File;

      Line : out String;

      Last : out Natural);

   --  Reads a line from an open text file (fails if File is invalid or in an

   --  out file).

   procedure Put (File : Text_File; S : String);

   procedure Put_Line (File : Text_File; Line : String);

   --  Output a string or a line to an out text file (fails if File is invalid

   --  or in an in file).

   procedure Close (File : in out Text_File);

   --  Close an open text file. File becomes invalid. Fails if File is already

   --  invalid or if an out file cannot be closed successfully.

   -----------------------

   -- Source info files --

   -----------------------

   procedure Write_Source_Info_File (Tree : Project_Tree_Ref);

   --  Create a new source info file, with the path name specified in the

   --  project tree data. Issue a warning if it is not possible to create

   --  the new file.

   procedure Read_Source_Info_File (Tree : Project_Tree_Ref);

   --  Check if there is a source info file specified for the project Tree. If

   --  so, attempt to read it. If the file exists and is successfully read, set

   --  the flag Source_Info_File_Exists to True for the tree.

   type Source_Info_Data is record

      Project             : Name_Id;

      Language            : Name_Id;

      Kind                : Source_Kind;

      Display_Path_Name   : Name_Id;

      Path_Name           : Name_Id;

      Unit_Name           : Name_Id               := No_Name;

      Index               : Int                   := 0;

      Naming_Exception    : Naming_Exception_Type := No;

   end record;

   --  Data read from a source info file for a single source

   type Source_Info is access all Source_Info_Data;

   No_Source_Info : constant Source_Info := null;

   type Source_Info_Iterator is private;

   --  Iterator to get the sources for a single project

   procedure Initialize

     (Iter        : out Source_Info_Iterator;

      For_Project : Name_Id);

   --  Initialize Iter for the project

   function Source_Info_Of (Iter : Source_Info_Iterator) return Source_Info;

   --  Get the source info for the source corresponding to the current value of

   --  the iterator. Returns No_Source_Info if there is no source corresponding

   --  to the iterator.

   procedure Next (Iter : in out Source_Info_Iterator);

   --  Advance the iterator to the next source in the project

private

   type Text_File_Data is record

      FD                  : File_Descriptor := Invalid_FD;

      Out_File            : Boolean := False;

      Buffer              : String (1 .. 1_000);

      Buffer_Len          : Natural := 0;

      Cursor              : Natural := 0;

      End_Of_File_Reached : Boolean := False;

   end record;

   type Text_File is access Text_File_Data;

   type Source_Info_Iterator is record

      Info : Source_Info;

      Next : Natural;

   end record;

end Prj.Util;