This file is indexed.

/usr/share/ada/adainclude/opentoken/opentoken-recognizer-string.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
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
-------------------------------------------------------------------------------
--
-- Copyright (C) 2009 Stephen Leake.  All Rights Reserved.
-- Copyright (C) 1999 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.
--
-------------------------------------------------------------------------------

with Ada.Strings.Maps;
with Ada.Characters.Latin_1;

-----------------------------------------------------------------------------
--  This package implements a token recognizer for a string literal.
--  It can optionally use an escape character to introduce special
--  character mappings, and can thus be used to recognize Ada, C or Java
--  strings.
-----------------------------------------------------------------------------
package OpenToken.Recognizer.String is

   --  \n mapping is operating system dependent; we pick the Unix
   --  convention here.
   C_Style_Escape_Code_Map : constant Ada.Strings.Maps.Character_Mapping :=
     Ada.Strings.Maps.To_Mapping
     (From => "abfnrtv""'\",
      To   =>
        Ada.Characters.Latin_1.BEL &
        Ada.Characters.Latin_1.BS &
        Ada.Characters.Latin_1.FF &
        Ada.Characters.Latin_1.LF &
        Ada.Characters.Latin_1.CR &
        Ada.Characters.Latin_1.HT &
        Ada.Characters.Latin_1.VT &
        '"' & ''' & '\');

   Java_Style_Escape_Code_Map : constant Ada.Strings.Maps.Character_Mapping :=
     Ada.Strings.Maps.To_Mapping
     (From => "bfnrt""'\",
      To   =>
        Ada.Characters.Latin_1.BS &
        Ada.Characters.Latin_1.FF &
        Ada.Characters.Latin_1.LF &
        Ada.Characters.Latin_1.CR &
        Ada.Characters.Latin_1.HT &
        '"' & ''' & '\');

   type Instance is new OpenToken.Recognizer.Instance with private;

   --------------------------------------------------------------------------
   --  This procedure will be called to create a String literal token.
   --  If Escapeable is set to False, the string will treat the Escape
   --  character as any other character.
   --
   --  If all parameters are defaulted, an Ada-style string token will
   --  be created.
   --
   --  If Escapeable is set to True, Double_Delimiter set to false,
   --  and all other parameters are defaulted, a C-style string token
   --  will be created.
   --
   --  If Escapeable is set to True, Double_Delimiter set to false,
   --  Escape_Mapping to Java_Style_Escape_Code_Map, the remaining
   --  parameters are defaulted, a Java-style string token will be
   --  created.
   --------------------------------------------------------------------------
   function Get
     (Delimiter        : in Character                          := '"';
      Double_Delimiter : in Boolean                            := True;
      Escapeable       : in Boolean                            := False;
      Escape           : in Character                          := '\';
      Escape_Mapping   : in Ada.Strings.Maps.Character_Mapping := C_Style_Escape_Code_Map)
     return Instance;

   --------------------------------------------------------------------------
   --  Return the translated value of the recognized string. This will
   --  not include any quotation characters. The escape mapping will
   --  have been applied, and internal sets of double quotes will
   --  appear as a single double-quote character.
   --------------------------------------------------------------------------
   function Value (Recognized_String : in Instance) return Standard.String;

private


   type State_ID is
     (Delimit, Text, Escaped_Text, Escaped_Octal_Number, First_Hex_Digit, Escaped_Hex_Number, Double_Delimit, Done);

   type Instance is new OpenToken.Recognizer.Instance with record

      --  The finite state machine state
      State           : State_ID := Delimit;
      Esc_Code        : Natural;

      --  The token settings
      Delimiter        : Character;
      Double_Delimiter : Boolean;
      Escapeable       : Boolean;
      Escape           : Character;
      Escape_Mapping   : Ada.Strings.Maps.Character_Mapping;

      --  The translated string value
      Value           : Standard.String (1 .. Max_String_Length);
      Value_Length    : Natural := 0;
      Good_Length     : Natural := 0;

   end record;

   overriding procedure Clear (The_Token : in out Instance);

   overriding procedure Analyze
     (The_Token : in out Instance;
      Next_Char : in     Character;
      Verdict   :    out Analysis_Verdict);

end OpenToken.Recognizer.String;