diff options
Diffstat (limited to 'gcc-4.4.0/gcc/ada/prj-util.ads')
-rw-r--r-- | gcc-4.4.0/gcc/ada/prj-util.ads | 184 |
1 files changed, 184 insertions, 0 deletions
diff --git a/gcc-4.4.0/gcc/ada/prj-util.ads b/gcc-4.4.0/gcc/ada/prj-util.ads new file mode 100644 index 000000000..0efdfbb5b --- /dev/null +++ b/gcc-4.4.0/gcc/ada/prj-util.ads @@ -0,0 +1,184 @@ +------------------------------------------------------------------------------ +-- -- +-- GNAT COMPILER COMPONENTS -- +-- -- +-- P R J . U T I L -- +-- -- +-- S p e c -- +-- -- +-- Copyright (C) 2001-2008, 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 + + -- ??? throughout this spec, parameters are not well enough documented + + function Executable_Of + (Project : Project_Id; + In_Tree : Project_Tree_Ref; + Main : File_Name_Type; + Index : Int; + Ada_Main : Boolean := True; + Language : String := "") 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. + -- 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; + In_Tree : Project_Tree_Ref); + -- 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 + -- Nil_Variable_Value, is a string list or is defaulted, return Default. + + function Value_Of + (Index : Name_Id; + In_Array : Array_Element_Id; + In_Tree : Project_Tree_Ref) 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; + In_Tree : Project_Tree_Ref; + Force_Lower_Case_Index : 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; + In_Tree : Project_Tree_Ref; + Force_Lower_Case_Index : 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; + In_Tree : Project_Tree_Ref) 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; + In_Tree : Project_Tree_Ref) 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; + In_Tree : Project_Tree_Ref) 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; + In_Tree : Project_Tree_Ref) 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) + + 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. + + 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) + + procedure Close (File : in out Text_File); + -- Close an open text file. File becomes invalid. Fails if File is already + -- invalid. + +private + + type Text_File_Data is record + FD : File_Descriptor := Invalid_FD; + Buffer : String (1 .. 1_000); + Buffer_Len : Natural; + Cursor : Natural := 0; + End_Of_File_Reached : Boolean := False; + end record; + + type Text_File is access Text_File_Data; + +end Prj.Util; |