/usr/share/ada/adainclude/opentoken/opentoken-token-enumerated-list.ads is in libopentoken5-dev 6.0b-4.
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 134 135 136 137 138 139 140 | -------------------------------------------------------------------------------
--
-- Copyright (C) 2012 - 2014 Stephe Leake
-- 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.
--
-------------------------------------------------------------------------------
-----------------------------------------------------------------------------
-- This package provides a type and operations for building lists of
-- tokens for use in grammar productions
-----------------------------------------------------------------------------
generic
package OpenToken.Token.Enumerated.List is
type Instance is tagged private;
Null_List : constant Instance;
function Length (Item : in Instance) return Natural;
----------------------------------------------------------------------------
-- Create a token list from a single instance.
----------------------------------------------------------------------------
function Only (Subject : in Class) return Instance;
function Only (Subject : in Handle) return Instance;
----------------------------------------------------------------------------
-- Create a token list from a pair of token instances.
----------------------------------------------------------------------------
function "&" (Left : in Class;
Right : in Class) return Instance;
----------------------------------------------------------------------------
-- Create a token list from a token instance and a token list.
----------------------------------------------------------------------------
function "&" (Left : in Class;
Right : in Instance) return Instance;
function "&" (Left : in Instance;
Right : in Class) return Instance;
----------------------------------------------------------------------------
-- Create a token list from a pair of token lists.
----------------------------------------------------------------------------
function "&" (Left : in Instance;
Right : in Instance) return Instance;
function "&"
(Left : in Handle;
Right : in Handle)
return Instance;
function "&"
(Left : in Instance;
Right : in Handle)
return Instance;
--------------------------------------------------------------------------
-- This routine needs to be called when you are done using a list,
-- or want to reset it to empty.
--------------------------------------------------------------------------
procedure Clean (List : in out Instance);
type List_Iterator is private;
Null_Iterator : constant List_Iterator;
----------------------------------------------------------------------------
-- Return an initialized iterator for traversing the token list
----------------------------------------------------------------------------
function Initial_Iterator (List : in Instance) return List_Iterator;
----------------------------------------------------------------------------
-- Move the iterator down the list to the next token, or to
-- Null_Iterator if there is no next token.
----------------------------------------------------------------------------
procedure Next_Token (Iterator : in out List_Iterator);
procedure Next (Iterator : in out List_Iterator) renames Next_Token;
function Next_Token (Iterator : in List_Iterator) return List_Iterator;
function Next (Iterator : in List_Iterator) return List_Iterator renames Next_Token;
function Token_Handle (Iterator : in List_Iterator) return Handle;
function ID (Iterator : in List_Iterator) return Token_ID;
---------------------
-- Parser Routines --
-- Enqueue Token on List, at the head. Token itself is not
-- copied; it will be freed by Clean.
procedure Enqueue
(List : in out Instance;
Token : in Handle);
-- Append to tail of List, without copying Token
procedure Append
(List : in out Instance;
Token : in Handle);
procedure Print (Item : in Instance);
-- Print Item to Ada.Text_IO.Current_Output.
private
type List_Node;
type List_Node_Ptr is access List_Node;
type List_Node is record
Token : Handle;
Next : List_Node_Ptr;
end record;
type Instance is tagged record
Head : List_Node_Ptr;
Tail : List_Node_Ptr;
end record;
type List_Iterator is new List_Node_Ptr;
Null_Iterator : constant List_Iterator := null;
Null_List : constant Instance := (null, null);
end OpenToken.Token.Enumerated.List;
|