diff options
Diffstat (limited to 'gcc/ada/scng.ads')
-rw-r--r-- | gcc/ada/scng.ads | 102 |
1 files changed, 102 insertions, 0 deletions
diff --git a/gcc/ada/scng.ads b/gcc/ada/scng.ads new file mode 100644 index 00000000000..7ebb441f63e --- /dev/null +++ b/gcc/ada/scng.ads @@ -0,0 +1,102 @@ +------------------------------------------------------------------------------ +-- -- +-- GNAT COMPILER COMPONENTS -- +-- -- +-- S C N G -- +-- -- +-- S p e c -- +-- -- +-- Copyright (C) 1992-2002 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 2, 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 COPYING. If not, write -- +-- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, -- +-- MA 02111-1307, USA. -- +-- -- +-- GNAT was originally developed by the GNAT team at New York University. -- +-- Extensive contributions were provided by Ada Core Technologies Inc. -- +-- -- +------------------------------------------------------------------------------ + +-- This package contains a generic lexical analyzer. This is used +-- for scanning Ada source files or text files with an Ada-like syntax, +-- such as project files. It is instantiated in Scn and Prj.Err. + +with Casing; use Casing; +with Styleg; +with Types; use Types; + +generic + with procedure Post_Scan; + -- Procedure called by Scan for the following tokens: + -- Tok_Char_Literal, Tok_Identifier, Tok_Real_Literal, Tok_Real_Literal, + -- Tok_Integer_Literal, Tok_String_Literal, Tok_Operator_Symbol. + + with procedure Error_Msg (Msg : String; Flag_Location : Source_Ptr); + -- Output a message at specified location + + with procedure Error_Msg_S (Msg : String); + -- Output a message at current scan pointer location + + with procedure Error_Msg_SC (Msg : String); + -- Output a message at the start of the current token + + with procedure Error_Msg_SP (Msg : String); + -- Output a message at the start of the previous token + + with package Style is new Styleg + (Error_Msg, Error_Msg_S, Error_Msg_SC, Error_Msg_SP); + -- Instantiation of Styleg with the same error reporting routines + +package Scng is + + procedure Initialize_Scanner + (Unit : Unit_Number_Type; + Index : Source_File_Index); + -- Initialize lexical scanner for scanning a new file. The caller has + -- completed the construction of the Units.Table entry for the specified + -- Unit and Index references the corresponding source file. A special + -- case is when Unit = No_Unit_Number, and Index corresponds to the + -- source index for reading the configuration pragma file. + -- Initialize_Scanner does not call Scan. + + procedure Scan; + -- Scan scans out the next token, and advances the scan state accordingly + -- (see package Scan_State for details). If the scan encounters an illegal + -- token, then an error message is issued pointing to the bad character, + -- and Scan returns a reasonable substitute token of some kind. + -- For tokens Char_Literal, Identifier, Real_Literal, Integer_Literal, + -- String_Literal and Operator_Symbol, Post_Scan is called after scanning. + + function Determine_Token_Casing return Casing_Type; + pragma Inline (Determine_Token_Casing); + -- Determines the casing style of the current token, which is + -- either a keyword or an identifier. See also package Casing. + + procedure Set_Special_Character (C : Character); + -- Indicate that one of the following character '#', '$', '?', '@', '`', + -- '\', '^', '_' or '~', when found is a Special token. + + procedure Reset_Special_Characters; + -- Indicate that there is no characters that are Special tokens., which + -- is the default. + + procedure Set_End_Of_Line_As_Token (Value : Boolean); + -- Indicate if End_Of_Line is a token or not. + -- By default, End_Of_Line is not a token. + + function Set_Start_Column return Column_Number; + -- This routine is called with Scan_Ptr pointing to the first character + -- of a line. On exit, Scan_Ptr is advanced to the first non-blank + -- character of this line (or to the terminating format effector if the + -- line contains no non-blank characters), and the returned result is the + -- column number of this non-blank character (zero origin), which is the + -- value to be stored in the Start_Column scan variable. + +end Scng; |