-- ----------------------------------------------------------------------------
--
--  Copyright (C) 1999, 2008 Christoph Karl Walter Grein
--
--  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.
-- ---------------------------------------------------------------------------

with Ada.Characters.Handling;

-- ----------------------------------------------------------------------------
--  This package implements a token recognizer for a graphic character.
-- ----------------------------------------------------------------------------
package body OpenToken.Recognizer.Graphic_Character is

   -- -------------------------------------------------------------------------
   --  This procedure will be called when analysis on a new candidate string
   --  is started. The Token needs to clear its state (if any).
   -- -------------------------------------------------------------------------
   overriding procedure Clear (The_Token : in out Instance) is
   begin
      The_Token.State := Opening_Tick;
   end Clear;

   -- -------------------------------------------------------------------------
   --  This procedure will be called to perform further analysis on a token
   --  based on the given next character.
   -- -------------------------------------------------------------------------
   overriding procedure Analyze
     (The_Token : in out Instance;
      Next_Char : in     Character;
      Verdict   :    out Analysis_Verdict)
   is begin
      case The_Token.State is
      when Opening_Tick =>
         if Next_Char = ''' then  -- '' (this comment works around an emacs colorizing bug)
            Verdict         := So_Far_So_Good;
            The_Token.State := The_Character;
         else
            Verdict         := Failed;
            The_Token.State := Done;
         end if;
      when The_Character =>
         if Ada.Characters.Handling.Is_Graphic (Next_Char) and
           not Ada.Strings.Maps.Is_In (Element => Next_Char, Set => The_Token.Excluded)
         then
            Verdict         := So_Far_So_Good;
            The_Token.State := Closing_Tick;
         else
            Verdict         := Failed;
            The_Token.State := Done;
         end if;
      when Closing_Tick =>
         if Next_Char = ''' then
            Verdict         := Matches;
            The_Token.State := Done;
         else
            Verdict         := Failed;
            The_Token.State := Done;
         end if;
      when Done =>
         Verdict := Failed;
      end case;
   end Analyze;

   -- -------------------------------------------------------------------------
   --  This procedure will be called to create a character set token.
   -- -------------------------------------------------------------------------
   function Get (Exclude : Ada.Strings.Maps.Character_Set := Ada.Strings.Maps.Null_Set)
                return Instance is
   begin
      return (Report   => True,
              Excluded => Exclude,
              State    => Opening_Tick);
   end Get;

   procedure Redefine (Inst    : in out Instance;
                       Exclude : in     Ada.Strings.Maps.Character_Set) is
   begin
      Inst.Excluded := Exclude;
   end Redefine;

end OpenToken.Recognizer.Graphic_Character;