/usr/share/ada/adainclude/opentoken/opentoken-recognizer.ads is in libopentoken4-dev 5.0a-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 | -------------------------------------------------------------------------------
--
-- Copyright (C) 1999 FlightSafety International and Ted Dennison
--
-- This file is part of the OpenToken package.
--
-- The OpenToken package is free software; you can redistribute it and/or
-- modify it under the terms of the GNU General Public License as published
-- by the Free Software Foundation; either version 3, or (at your option)
-- any later version. The OpenToken package is distributed in the hope that
-- it will be useful, but WITHOUT 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 the OpenToken
-- package; see file GPL.txt. If not, write to the Free Software Foundation,
-- 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
--
-- As a special exception, if other files instantiate generics from
-- this unit, or you link this unit with other files to produce an
-- executable, this unit does not by itself cause the resulting
-- executable to be covered by the GNU General Public License. This
-- exception does not however invalidate any other reasons why the
-- executable file might be covered by the GNU Public License.
--
-------------------------------------------------------------------------------
-----------------------------------------------------------------------------
-- This package declares an abstract type for recognizing a single
-- token. It is designed to be called by an instance of the
-- OpenToken.Analyzer class, which will typically be calling several
-- instances of Recognizer simultaniously to find the best match for
-- a string.
--
-- Note that the token analysis method of analyzing a character at a
-- time is a very fast method for complex grammars, but is also
-- fairly complicated to implement. Analyzers must be implemented as
-- state-machines and save their state between calls. This makes it a
-- bit tough for meer mortals to implement, so using the predefined
-- tokens in the child packages is highly reccomended where possible.
-- State information should be saved in the token itself to make the
-- system reentrant.
-----------------------------------------------------------------------------
package OpenToken.Recognizer is
-- Indication from a recognizer of how the given string matches.
type Analysis_Verdict is
(Matches, -- The string matches
So_Far_So_Good, -- The string might match if it were just a bit longer
Failed); -- The string will never match, no matter how many more characters it has
type Instance is abstract tagged record
-- Indication of if this token is to be reported to the parser
-- (client) when it is found. Set to FALSE to ignore tokens
-- like comments and whitespace.
Report : Boolean := True;
end record;
subtype Class is Instance'Class;
type Handle is access all Class;
--------------------------------------------------------------------------
-- This procedure will be called when analysis on a new candidate
-- string is started. The Token needs to clear its state (if any).
--------------------------------------------------------------------------
procedure Clear (The_Token : in out Instance) is abstract;
----------------------------------------------------------------------------
-- This procedure will be called to perform further analysis on a token
-- based on the given next character.
----------------------------------------------------------------------------
procedure Analyze (The_Token : in out Instance;
Next_Char : in Character;
Verdict : out Analysis_Verdict) is abstract;
end OpenToken.Recognizer;
|