-- --
-- B o d y --
-- --
--- Copyright (C) 2004-2005 Free Software Foundation, Inc. --
--- --
--- This specification is derived from the Ada Reference Manual for use with --
--- GNAT. The copyright notice above, and the license provisions that follow --
--- apply solely to the contents of the part following the private keyword. --
+-- Copyright (C) 2004-2009, 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- --
+-- ware Foundation; either version 3, 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. --
+-- or FITNESS FOR A PARTICULAR PURPOSE. --
+-- --
+-- As a special exception under Section 7 of GPL version 3, you are granted --
+-- additional permissions described in the GCC Runtime Library Exception, --
+-- version 3.1, as published by the Free Software Foundation. --
-- --
--- 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. --
+-- You should have received a copy of the GNU General Public License and --
+-- a copy of the GCC Runtime Library Exception along with this program; --
+-- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
+-- <http://www.gnu.org/licenses/>. --
-- --
-- This unit was originally developed by Matthew J Heaney. --
------------------------------------------------------------------------------
with System; use type System.Address;
+
with Ada.Unchecked_Deallocation;
package body Ada.Containers.Doubly_Linked_Lists is
- procedure Free is
- new Ada.Unchecked_Deallocation (Node_Type, Node_Access);
-
-----------------------
-- Local Subprograms --
-----------------------
+ procedure Free (X : in out Node_Access);
+
procedure Insert_Internal
(Container : in out List;
Before : Node_Access;
New_Node : Node_Access);
+ function Vet (Position : Cursor) return Boolean;
+
---------
-- "=" --
---------
Container.Length := 1;
Src := Src.Next;
-
while Src /= null loop
Container.Last.Next := new Node_Type'(Element => Src.Element,
Prev => Container.Last,
procedure Append
(Container : in out List;
New_Item : Element_Type;
- Count : Count_Type := 1) is
+ Count : Count_Type := 1)
+ is
begin
Insert (Container, No_Element, New_Item, Count);
end Append;
pragma Assert (Container.Last.Next = null);
if Container.Busy > 0 then
- raise Program_Error;
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
while Container.Length > 1 loop
pragma Assert (X.Next.Prev = Container.First);
Container.First := X.Next;
- X.Next := null; -- prevent mischief
-
Container.First.Prev := null;
+
Container.Length := Container.Length - 1;
Free (X);
Container.Last := null;
Container.Length := 0;
+ pragma Warnings (Off);
Free (X);
+ pragma Warnings (On);
end Clear;
--------------
- -- Continue --
+ -- Contains --
--------------
function Contains
(Container : List;
- Item : Element_Type) return Boolean is
+ Item : Element_Type) return Boolean
+ is
begin
return Find (Container, Item) /= No_Element;
end Contains;
begin
if Position.Node = null then
- pragma Assert (Position.Container = null);
- raise Constraint_Error;
+ raise Constraint_Error with
+ "Position cursor has no element";
end if;
- if Position.Container /= List_Access'(Container'Unchecked_Access) then
- raise Program_Error;
+ if Position.Container /= Container'Unrestricted_Access then
+ raise Program_Error with
+ "Position cursor designates wrong container";
end if;
- pragma Assert (Container.Length > 0);
- pragma Assert (Container.First.Prev = null);
- pragma Assert (Container.Last.Next = null);
-
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Container.Last);
+ pragma Assert (Vet (Position), "bad cursor in Delete");
if Position.Node = Container.First then
Delete_First (Container, Count);
- Position := First (Container);
+ Position := No_Element; -- Post-York behavior
return;
end if;
if Count = 0 then
+ Position := No_Element; -- Post-York behavior
return;
end if;
if Container.Busy > 0 then
- raise Program_Error;
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
for Index in 1 .. Count loop
Container.Last := X.Prev;
Container.Last.Next := null;
- X.Prev := null; -- prevent mischief
Free (X);
return;
end if;
X.Next.Prev := X.Prev;
X.Prev.Next := X.Next;
- X.Next := null;
- X.Prev := null;
Free (X);
end loop;
+
+ Position := No_Element; -- Post-York behavior
end Delete;
------------------
end if;
if Container.Busy > 0 then
- raise Program_Error;
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
for I in 1 .. Count loop
Container.Length := Container.Length - 1;
- X.Next := null; -- prevent mischief
Free (X);
end loop;
end Delete_First;
end if;
if Container.Busy > 0 then
- raise Program_Error;
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
for I in 1 .. Count loop
Container.Length := Container.Length - 1;
- X.Prev := null; -- prevent mischief
Free (X);
end loop;
end Delete_Last;
function Element (Position : Cursor) return Element_Type is
begin
- pragma Assert (Position.Container /= null);
- pragma Assert (Position.Container.Length > 0);
- pragma Assert (Position.Container.First.Prev = null);
- pragma Assert (Position.Container.Last.Next = null);
-
- pragma Assert (Position.Node /= null);
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Position.Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Position.Container.Last);
+ if Position.Node = null then
+ raise Constraint_Error with
+ "Position cursor has no element";
+ end if;
+
+ pragma Assert (Vet (Position), "bad cursor in Element");
return Position.Node.Element;
end Element;
begin
if Node = null then
Node := Container.First;
+
else
- if Position.Container /= List_Access'(Container'Unchecked_Access) then
- raise Program_Error;
+ if Position.Container /= Container'Unrestricted_Access then
+ raise Program_Error with
+ "Position cursor designates wrong container";
end if;
- pragma Assert (Container.Length > 0);
- pragma Assert (Container.First.Prev = null);
- pragma Assert (Container.Last.Next = null);
-
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Container.Last);
+ pragma Assert (Vet (Position), "bad cursor in Find");
end if;
while Node /= null loop
function First_Element (Container : List) return Element_Type is
begin
+ if Container.First = null then
+ raise Constraint_Error with "list is empty";
+ end if;
+
return Container.First.Element;
end First_Element;
+ ----------
+ -- Free --
+ ----------
+
+ procedure Free (X : in out Node_Access) is
+ procedure Deallocate is
+ new Ada.Unchecked_Deallocation (Node_Type, Node_Access);
+
+ begin
+ X.Prev := X;
+ X.Next := X;
+ Deallocate (X);
+ end Free;
+
---------------------
-- Generic_Sorting --
---------------------
(Target : in out List;
Source : in out List)
is
- LI : Cursor := First (Target);
- RI : Cursor := First (Source);
+ LI, RI : Cursor;
begin
if Target'Address = Source'Address then
return;
end if;
- if Target.Busy > 0
- or else Source.Busy > 0
- then
- raise Program_Error;
+ if Target.Busy > 0 then
+ raise Program_Error with
+ "attempt to tamper with elements of Target (list is busy)";
+ end if;
+
+ if Source.Busy > 0 then
+ raise Program_Error with
+ "attempt to tamper with elements of Source (list is busy)";
end if;
+ LI := First (Target);
+ RI := First (Source);
while RI.Node /= null loop
+ pragma Assert (RI.Node.Next = null
+ or else not (RI.Node.Next.Element <
+ RI.Node.Element));
+
if LI.Node = null then
Splice (Target, No_Element, Source);
return;
end if;
+ pragma Assert (LI.Node.Next = null
+ or else not (LI.Node.Next.Element <
+ LI.Node.Element));
+
if RI.Node.Element < LI.Node.Element then
declare
RJ : Cursor := RI;
+ pragma Warnings (Off, RJ);
begin
RI.Node := RI.Node.Next;
Splice (Target, LI, Source, RJ);
procedure Sort (Container : in out List) is
- procedure Partition
- (Pivot : in Node_Access;
- Back : in Node_Access);
+ procedure Partition (Pivot : Node_Access; Back : Node_Access);
procedure Sort (Front, Back : Node_Access);
-- Partition --
---------------
- procedure Partition
- (Pivot : Node_Access;
- Back : Node_Access)
- is
+ procedure Partition (Pivot : Node_Access; Back : Node_Access) is
Node : Node_Access := Pivot.Next;
begin
pragma Assert (Container.Last.Next = null);
if Container.Busy > 0 then
- raise Program_Error;
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
Sort (Front => null, Back => null);
function Has_Element (Position : Cursor) return Boolean is
begin
- if Position.Node = null then
- pragma Assert (Position.Container = null);
- return False;
- end if;
-
- pragma Assert (Position.Container /= null);
- pragma Assert (Position.Container.Length > 0);
- pragma Assert (Position.Container.First.Prev = null);
- pragma Assert (Position.Container.Last.Next = null);
-
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Position.Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Position.Container.Last);
-
- return True;
+ pragma Assert (Vet (Position), "bad cursor in Has_Element");
+ return Position.Node /= null;
end Has_Element;
------------
New_Node : Node_Access;
begin
- if Before.Node /= null then
- if Before.Container /= List_Access'(Container'Unchecked_Access) then
- raise Program_Error;
+ if Before.Container /= null then
+ if Before.Container /= Container'Unrestricted_Access then
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
- pragma Assert (Container.Length > 0);
- pragma Assert (Container.First.Prev = null);
- pragma Assert (Container.Last.Next = null);
-
- pragma Assert (Before.Node.Prev = null
- or else Before.Node.Prev.Next = Before.Node);
- pragma Assert (Before.Node.Next = null
- or else Before.Node.Next.Prev = Before.Node);
- pragma Assert (Before.Node.Prev /= null
- or else Before.Node = Container.First);
- pragma Assert (Before.Node.Next /= null
- or else Before.Node = Container.Last);
+ pragma Assert (Vet (Before), "bad cursor in Insert");
end if;
if Count = 0 then
end if;
if Container.Length > Count_Type'Last - Count then
- raise Constraint_Error;
+ raise Constraint_Error with "new length exceeds maximum";
end if;
if Container.Busy > 0 then
- raise Program_Error;
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
New_Node := new Node_Type'(New_Item, null, null);
Count : Count_Type := 1)
is
Position : Cursor;
+ pragma Unreferenced (Position);
begin
Insert (Container, Before, New_Item, Position, Count);
end Insert;
New_Node : Node_Access;
begin
- if Before.Node /= null then
- if Before.Container /= List_Access'(Container'Unchecked_Access) then
- raise Program_Error;
+ if Before.Container /= null then
+ if Before.Container /= Container'Unrestricted_Access then
+ raise Program_Error with
+ "Before cursor designates wrong list";
end if;
- pragma Assert (Container.Length > 0);
- pragma Assert (Container.First.Prev = null);
- pragma Assert (Container.Last.Next = null);
-
- pragma Assert (Before.Node.Prev = null
- or else Before.Node.Prev.Next = Before.Node);
- pragma Assert (Before.Node.Next = null
- or else Before.Node.Next.Prev = Before.Node);
- pragma Assert (Before.Node.Prev /= null
- or else Before.Node = Container.First);
- pragma Assert (Before.Node.Next /= null
- or else Before.Node = Container.Last);
+ pragma Assert (Vet (Before), "bad cursor in Insert");
end if;
if Count = 0 then
end if;
if Container.Length > Count_Type'Last - Count then
- raise Constraint_Error;
+ raise Constraint_Error with "new length exceeds maximum";
end if;
if Container.Busy > 0 then
- raise Program_Error;
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
New_Node := new Node_Type;
function Last_Element (Container : List) return Element_Type is
begin
+ if Container.Last = null then
+ raise Constraint_Error with "list is empty";
+ end if;
+
return Container.Last.Element;
end Last_Element;
end if;
if Source.Busy > 0 then
- raise Program_Error;
+ raise Program_Error with
+ "attempt to tamper with elements of Source (list is busy)";
end if;
Clear (Target);
procedure Next (Position : in out Cursor) is
begin
- if Position.Node = null then
- pragma Assert (Position.Container = null);
- return;
- end if;
-
- pragma Assert (Position.Container /= null);
- pragma Assert (Position.Container.Length > 0);
- pragma Assert (Position.Container.First.Prev = null);
- pragma Assert (Position.Container.Last.Next = null);
-
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Position.Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Position.Container.Last);
-
- Position.Node := Position.Node.Next;
-
- if Position.Node = null then
- Position.Container := null;
- end if;
+ Position := Next (Position);
end Next;
function Next (Position : Cursor) return Cursor is
begin
if Position.Node = null then
- pragma Assert (Position.Container = null);
return No_Element;
end if;
- pragma Assert (Position.Container /= null);
- pragma Assert (Position.Container.Length > 0);
- pragma Assert (Position.Container.First.Prev = null);
- pragma Assert (Position.Container.Last.Next = null);
-
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Position.Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Position.Container.Last);
+ pragma Assert (Vet (Position), "bad cursor in Next");
declare
Next_Node : constant Node_Access := Position.Node.Next;
procedure Previous (Position : in out Cursor) is
begin
- if Position.Node = null then
- pragma Assert (Position.Container = null);
- return;
- end if;
-
- pragma Assert (Position.Container /= null);
- pragma Assert (Position.Container.Length > 0);
- pragma Assert (Position.Container.First.Prev = null);
- pragma Assert (Position.Container.Last.Next = null);
-
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Position.Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Position.Container.Last);
-
- Position.Node := Position.Node.Prev;
-
- if Position.Node = null then
- Position.Container := null;
- end if;
+ Position := Previous (Position);
end Previous;
function Previous (Position : Cursor) return Cursor is
begin
if Position.Node = null then
- pragma Assert (Position.Container = null);
return No_Element;
end if;
- pragma Assert (Position.Container /= null);
- pragma Assert (Position.Container.Length > 0);
- pragma Assert (Position.Container.First.Prev = null);
- pragma Assert (Position.Container.Last.Next = null);
-
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Position.Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Position.Container.Last);
+ pragma Assert (Vet (Position), "bad cursor in Previous");
declare
Prev_Node : constant Node_Access := Position.Node.Prev;
procedure Query_Element
(Position : Cursor;
- Process : not null access procedure (Element : in Element_Type))
+ Process : not null access procedure (Element : Element_Type))
is
- pragma Assert (Position.Container /= null);
- pragma Assert (Position.Container.Length > 0);
- pragma Assert (Position.Container.First.Prev = null);
- pragma Assert (Position.Container.Last.Next = null);
-
- pragma Assert (Position.Node /= null);
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Position.Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Position.Container.Last);
-
- E : Element_Type renames Position.Node.Element;
-
- C : List renames Position.Container.all'Unrestricted_Access.all;
- B : Natural renames C.Busy;
- L : Natural renames C.Lock;
-
begin
- B := B + 1;
- L := L + 1;
+ if Position.Node = null then
+ raise Constraint_Error with
+ "Position cursor has no element";
+ end if;
+
+ pragma Assert (Vet (Position), "bad cursor in Query_Element");
+
+ declare
+ C : List renames Position.Container.all'Unrestricted_Access.all;
+ B : Natural renames C.Busy;
+ L : Natural renames C.Lock;
begin
- Process (E);
- exception
- when others =>
- L := L - 1;
- B := B - 1;
- raise;
- end;
+ B := B + 1;
+ L := L + 1;
- L := L - 1;
- B := B - 1;
+ begin
+ Process (Position.Node.Element);
+ exception
+ when others =>
+ L := L - 1;
+ B := B - 1;
+ raise;
+ end;
+
+ L := L - 1;
+ B := B - 1;
+ end;
end Query_Element;
----------
----------
procedure Read
- (Stream : access Root_Stream_Type'Class;
+ (Stream : not null access Root_Stream_Type'Class;
Item : out List)
is
N : Count_Type'Base;
end loop;
end Read;
+ procedure Read
+ (Stream : not null access Root_Stream_Type'Class;
+ Item : out Cursor)
+ is
+ begin
+ raise Program_Error with "attempt to stream list cursor";
+ end Read;
+
---------------------
-- Replace_Element --
---------------------
procedure Replace_Element
- (Position : Cursor;
- By : Element_Type)
+ (Container : in out List;
+ Position : Cursor;
+ New_Item : Element_Type)
is
- pragma Assert (Position.Container /= null);
- pragma Assert (Position.Container.Length > 0);
- pragma Assert (Position.Container.First.Prev = null);
- pragma Assert (Position.Container.Last.Next = null);
-
- pragma Assert (Position.Node /= null);
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Position.Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Position.Container.Last);
-
- E : Element_Type renames Position.Node.Element;
-
begin
- if Position.Container.Lock > 0 then
- raise Program_Error;
+ if Position.Container = null then
+ raise Constraint_Error with "Position cursor has no element";
end if;
- E := By;
- end Replace_Element;
-
- ------------------
- -- Reverse_Find --
- ------------------
-
- function Reverse_Find
- (Container : List;
- Item : Element_Type;
- Position : Cursor := No_Element) return Cursor
- is
- Node : Node_Access := Position.Node;
-
- begin
- if Node = null then
- Node := Container.Last;
- else
- if Position.Container /= List_Access'(Container'Unchecked_Access) then
- raise Program_Error;
- end if;
-
- pragma Assert (Container.Length > 0);
- pragma Assert (Container.First.Prev = null);
- pragma Assert (Container.Last.Next = null);
-
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Container.Last);
+ if Position.Container /= Container'Unchecked_Access then
+ raise Program_Error with
+ "Position cursor designates wrong container";
end if;
- while Node /= null loop
- if Node.Element = Item then
- return Cursor'(Container'Unchecked_Access, Node);
- end if;
-
- Node := Node.Prev;
- end loop;
-
- return No_Element;
- end Reverse_Find;
-
- ---------------------
- -- Reverse_Iterate --
- ---------------------
-
- procedure Reverse_Iterate
- (Container : List;
- Process : not null access procedure (Position : Cursor))
- is
- C : List renames Container'Unrestricted_Access.all;
- B : Natural renames C.Busy;
+ if Container.Lock > 0 then
+ raise Program_Error with
+ "attempt to tamper with cursors (list is locked)";
+ end if;
- Node : Node_Access := Container.Last;
+ pragma Assert (Vet (Position), "bad cursor in Replace_Element");
- begin
- B := B + 1;
-
- begin
- while Node /= null loop
- Process (Cursor'(Container'Unchecked_Access, Node));
- Node := Node.Prev;
- end loop;
- exception
- when others =>
- B := B - 1;
- raise;
- end;
-
- B := B - 1;
- end Reverse_Iterate;
+ Position.Node.Element := New_Item;
+ end Replace_Element;
- ------------------
- -- Reverse_List --
- ------------------
+ ----------------------
+ -- Reverse_Elements --
+ ----------------------
- procedure Reverse_List (Container : in out List) is
+ procedure Reverse_Elements (Container : in out List) is
I : Node_Access := Container.First;
J : Node_Access := Container.Last;
end if;
end Swap;
- -- Start of processing for Reverse_List
+ -- Start of processing for Reverse_Elements
begin
if Container.Length <= 1 then
pragma Assert (Container.Last.Next = null);
if Container.Busy > 0 then
- raise Program_Error;
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
Container.First := J;
pragma Assert (Container.First.Prev = null);
pragma Assert (Container.Last.Next = null);
- end Reverse_List;
+ end Reverse_Elements;
+
+ ------------------
+ -- Reverse_Find --
+ ------------------
+
+ function Reverse_Find
+ (Container : List;
+ Item : Element_Type;
+ Position : Cursor := No_Element) return Cursor
+ is
+ Node : Node_Access := Position.Node;
+
+ begin
+ if Node = null then
+ Node := Container.Last;
+
+ else
+ if Position.Container /= Container'Unrestricted_Access then
+ raise Program_Error with
+ "Position cursor designates wrong container";
+ end if;
+
+ pragma Assert (Vet (Position), "bad cursor in Reverse_Find");
+ end if;
+
+ while Node /= null loop
+ if Node.Element = Item then
+ return Cursor'(Container'Unchecked_Access, Node);
+ end if;
+
+ Node := Node.Prev;
+ end loop;
+
+ return No_Element;
+ end Reverse_Find;
+
+ ---------------------
+ -- Reverse_Iterate --
+ ---------------------
+
+ procedure Reverse_Iterate
+ (Container : List;
+ Process : not null access procedure (Position : Cursor))
+ is
+ C : List renames Container'Unrestricted_Access.all;
+ B : Natural renames C.Busy;
+
+ Node : Node_Access := Container.Last;
+
+ begin
+ B := B + 1;
+
+ begin
+ while Node /= null loop
+ Process (Cursor'(Container'Unchecked_Access, Node));
+ Node := Node.Prev;
+ end loop;
+
+ exception
+ when others =>
+ B := B - 1;
+ raise;
+ end;
+
+ B := B - 1;
+ end Reverse_Iterate;
------------
-- Splice --
Source : in out List)
is
begin
- if Before.Node /= null then
- if Before.Container /= List_Access'(Target'Unchecked_Access) then
- raise Program_Error;
+ if Before.Container /= null then
+ if Before.Container /= Target'Unrestricted_Access then
+ raise Program_Error with
+ "Before cursor designates wrong container";
end if;
- pragma Assert (Target.Length >= 1);
- pragma Assert (Target.First.Prev = null);
- pragma Assert (Target.Last.Next = null);
-
- pragma Assert (Before.Node.Prev = null
- or else Before.Node.Prev.Next = Before.Node);
- pragma Assert (Before.Node.Next = null
- or else Before.Node.Next.Prev = Before.Node);
- pragma Assert (Before.Node.Prev /= null
- or else Before.Node = Target.First);
- pragma Assert (Before.Node.Next /= null
- or else Before.Node = Target.Last);
+ pragma Assert (Vet (Before), "bad cursor in Splice");
end if;
if Target'Address = Source'Address
pragma Assert (Source.Last.Next = null);
if Target.Length > Count_Type'Last - Source.Length then
- raise Constraint_Error;
+ raise Constraint_Error with "new length exceeds maximum";
end if;
- if Target.Busy > 0
- or else Source.Busy > 0
- then
- raise Program_Error;
+ if Target.Busy > 0 then
+ raise Program_Error with
+ "attempt to tamper with elements of Target (list is busy)";
+ end if;
+
+ if Source.Busy > 0 then
+ raise Program_Error with
+ "attempt to tamper with elements of Source (list is busy)";
end if;
if Target.Length = 0 then
end Splice;
procedure Splice
- (Target : in out List;
- Before : Cursor;
- Position : Cursor)
+ (Container : in out List;
+ Before : Cursor;
+ Position : Cursor)
is
begin
- if Before.Node /= null then
- if Before.Container /= List_Access'(Target'Unchecked_Access) then
- raise Program_Error;
+ if Before.Container /= null then
+ if Before.Container /= Container'Unchecked_Access then
+ raise Program_Error with
+ "Before cursor designates wrong container";
end if;
- pragma Assert (Target.Length >= 1);
- pragma Assert (Target.First.Prev = null);
- pragma Assert (Target.Last.Next = null);
-
- pragma Assert (Before.Node.Prev = null
- or else Before.Node.Prev.Next = Before.Node);
- pragma Assert (Before.Node.Next = null
- or else Before.Node.Next.Prev = Before.Node);
- pragma Assert (Before.Node.Prev /= null
- or else Before.Node = Target.First);
- pragma Assert (Before.Node.Next /= null
- or else Before.Node = Target.Last);
+ pragma Assert (Vet (Before), "bad Before cursor in Splice");
end if;
if Position.Node = null then
- raise Constraint_Error;
+ raise Constraint_Error with "Position cursor has no element";
end if;
- if Position.Container /= List_Access'(Target'Unchecked_Access) then
- raise Program_Error;
+ if Position.Container /= Container'Unrestricted_Access then
+ raise Program_Error with
+ "Position cursor designates wrong container";
end if;
- pragma Assert (Target.Length >= 1);
- pragma Assert (Target.First.Prev = null);
- pragma Assert (Target.Last.Next = null);
-
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Target.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Target.Last);
+ pragma Assert (Vet (Position), "bad Position cursor in Splice");
if Position.Node = Before.Node
or else Position.Node.Next = Before.Node
return;
end if;
- pragma Assert (Target.Length >= 2);
+ pragma Assert (Container.Length >= 2);
- if Target.Busy > 0 then
- raise Program_Error;
+ if Container.Busy > 0 then
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
if Before.Node = null then
- pragma Assert (Position.Node /= Target.Last);
+ pragma Assert (Position.Node /= Container.Last);
- if Position.Node = Target.First then
- Target.First := Position.Node.Next;
- Target.First.Prev := null;
+ if Position.Node = Container.First then
+ Container.First := Position.Node.Next;
+ Container.First.Prev := null;
else
Position.Node.Prev.Next := Position.Node.Next;
Position.Node.Next.Prev := Position.Node.Prev;
end if;
- Target.Last.Next := Position.Node;
- Position.Node.Prev := Target.Last;
+ Container.Last.Next := Position.Node;
+ Position.Node.Prev := Container.Last;
- Target.Last := Position.Node;
- Target.Last.Next := null;
+ Container.Last := Position.Node;
+ Container.Last.Next := null;
return;
end if;
- if Before.Node = Target.First then
- pragma Assert (Position.Node /= Target.First);
+ if Before.Node = Container.First then
+ pragma Assert (Position.Node /= Container.First);
- if Position.Node = Target.Last then
- Target.Last := Position.Node.Prev;
- Target.Last.Next := null;
+ if Position.Node = Container.Last then
+ Container.Last := Position.Node.Prev;
+ Container.Last.Next := null;
else
Position.Node.Prev.Next := Position.Node.Next;
Position.Node.Next.Prev := Position.Node.Prev;
end if;
- Target.First.Prev := Position.Node;
- Position.Node.Next := Target.First;
+ Container.First.Prev := Position.Node;
+ Position.Node.Next := Container.First;
- Target.First := Position.Node;
- Target.First.Prev := null;
+ Container.First := Position.Node;
+ Container.First.Prev := null;
return;
end if;
- if Position.Node = Target.First then
- Target.First := Position.Node.Next;
- Target.First.Prev := null;
+ if Position.Node = Container.First then
+ Container.First := Position.Node.Next;
+ Container.First.Prev := null;
- elsif Position.Node = Target.Last then
- Target.Last := Position.Node.Prev;
- Target.Last.Next := null;
+ elsif Position.Node = Container.Last then
+ Container.Last := Position.Node.Prev;
+ Container.Last.Next := null;
else
Position.Node.Prev.Next := Position.Node.Next;
Before.Node.Prev := Position.Node;
Position.Node.Next := Before.Node;
- pragma Assert (Target.First.Prev = null);
- pragma Assert (Target.Last.Next = null);
+ pragma Assert (Container.First.Prev = null);
+ pragma Assert (Container.Last.Next = null);
end Splice;
procedure Splice
return;
end if;
- if Before.Node /= null then
- if Before.Container /= List_Access'(Target'Unchecked_Access) then
- raise Program_Error;
+ if Before.Container /= null then
+ if Before.Container /= Target'Unrestricted_Access then
+ raise Program_Error with
+ "Before cursor designates wrong container";
end if;
- pragma Assert (Target.Length >= 1);
- pragma Assert (Target.First.Prev = null);
- pragma Assert (Target.Last.Next = null);
-
- pragma Assert (Before.Node.Prev = null
- or else Before.Node.Prev.Next = Before.Node);
- pragma Assert (Before.Node.Next = null
- or else Before.Node.Next.Prev = Before.Node);
- pragma Assert (Before.Node.Prev /= null
- or else Before.Node = Target.First);
- pragma Assert (Before.Node.Next /= null
- or else Before.Node = Target.Last);
+ pragma Assert (Vet (Before), "bad Before cursor in Splice");
end if;
if Position.Node = null then
- raise Constraint_Error;
+ raise Constraint_Error with "Position cursor has no element";
end if;
- if Position.Container /= List_Access'(Source'Unchecked_Access) then
- raise Program_Error;
+ if Position.Container /= Source'Unrestricted_Access then
+ raise Program_Error with
+ "Position cursor designates wrong container";
end if;
- pragma Assert (Source.Length >= 1);
- pragma Assert (Source.First.Prev = null);
- pragma Assert (Source.Last.Next = null);
-
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Source.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Source.Last);
+ pragma Assert (Vet (Position), "bad Position cursor in Splice");
if Target.Length = Count_Type'Last then
- raise Constraint_Error;
+ raise Constraint_Error with "Target is full";
end if;
- if Target.Busy > 0
- or else Source.Busy > 0
- then
- raise Program_Error;
+ if Target.Busy > 0 then
+ raise Program_Error with
+ "attempt to tamper with elements of Target (list is busy)";
+ end if;
+
+ if Source.Busy > 0 then
+ raise Program_Error with
+ "attempt to tamper with elements of Source (list is busy)";
end if;
if Position.Node = Source.First then
Source.First := Position.Node.Next;
- Source.First.Prev := null;
if Position.Node = Source.Last then
pragma Assert (Source.First = null);
pragma Assert (Source.Length = 1);
Source.Last := null;
+
+ else
+ Source.First.Prev := null;
end if;
elsif Position.Node = Source.Last then
-- Swap --
----------
- procedure Swap (I, J : Cursor) is
+ procedure Swap
+ (Container : in out List;
+ I, J : Cursor)
+ is
begin
- if I.Container = null
- or else J.Container = null
- then
- raise Constraint_Error;
+ if I.Node = null then
+ raise Constraint_Error with "I cursor has no element";
end if;
- if I.Container /= J.Container then
- raise Program_Error;
+ if J.Node = null then
+ raise Constraint_Error with "J cursor has no element";
end if;
- declare
- C : List renames I.Container.all;
- begin
- pragma Assert (C.Length >= 1);
- pragma Assert (C.First.Prev = null);
- pragma Assert (C.Last.Next = null);
-
- pragma Assert (I.Node /= null);
- pragma Assert (I.Node.Prev = null
- or else I.Node.Prev.Next = I.Node);
- pragma Assert (I.Node.Next = null
- or else I.Node.Next.Prev = I.Node);
- pragma Assert (I.Node.Prev /= null
- or else I.Node = C.First);
- pragma Assert (I.Node.Next /= null
- or else I.Node = C.Last);
-
- if I.Node = J.Node then
- return;
- end if;
+ if I.Container /= Container'Unchecked_Access then
+ raise Program_Error with "I cursor designates wrong container";
+ end if;
- pragma Assert (C.Length >= 2);
- pragma Assert (J.Node /= null);
- pragma Assert (J.Node.Prev = null
- or else J.Node.Prev.Next = J.Node);
- pragma Assert (J.Node.Next = null
- or else J.Node.Next.Prev = J.Node);
- pragma Assert (J.Node.Prev /= null
- or else J.Node = C.First);
- pragma Assert (J.Node.Next /= null
- or else J.Node = C.Last);
-
- if C.Lock > 0 then
- raise Program_Error;
- end if;
+ if J.Container /= Container'Unchecked_Access then
+ raise Program_Error with "J cursor designates wrong container";
+ end if;
- declare
- EI : Element_Type renames I.Node.Element;
- EJ : Element_Type renames J.Node.Element;
+ if I.Node = J.Node then
+ return;
+ end if;
- EI_Copy : constant Element_Type := EI;
- begin
- EI := EJ;
- EJ := EI_Copy;
- end;
+ if Container.Lock > 0 then
+ raise Program_Error with
+ "attempt to tamper with cursors (list is locked)";
+ end if;
+
+ pragma Assert (Vet (I), "bad I cursor in Swap");
+ pragma Assert (Vet (J), "bad J cursor in Swap");
+
+ declare
+ EI : Element_Type renames I.Node.Element;
+ EJ : Element_Type renames J.Node.Element;
+
+ EI_Copy : constant Element_Type := EI;
+
+ begin
+ EI := EJ;
+ EJ := EI_Copy;
end;
end Swap;
procedure Swap_Links
(Container : in out List;
- I, J : Cursor) is
+ I, J : Cursor)
+ is
begin
- if I.Container = null
- or else J.Container = null
- then
- raise Constraint_Error;
+ if I.Node = null then
+ raise Constraint_Error with "I cursor has no element";
end if;
- if I.Container /= List_Access'(Container'Unchecked_Access) then
- raise Program_Error;
+ if J.Node = null then
+ raise Constraint_Error with "J cursor has no element";
end if;
- if J.Container /= I.Container then
- raise Program_Error;
+ if I.Container /= Container'Unrestricted_Access then
+ raise Program_Error with "I cursor designates wrong container";
end if;
- pragma Assert (Container.Length >= 1);
- pragma Assert (Container.First.Prev = null);
- pragma Assert (Container.Last.Next = null);
-
- pragma Assert (I.Node /= null);
- pragma Assert (I.Node.Prev = null
- or else I.Node.Prev.Next = I.Node);
- pragma Assert (I.Node.Next = null
- or else I.Node.Next.Prev = I.Node);
- pragma Assert (I.Node.Prev /= null
- or else I.Node = Container.First);
- pragma Assert (I.Node.Next /= null
- or else I.Node = Container.Last);
+ if J.Container /= Container'Unrestricted_Access then
+ raise Program_Error with "J cursor designates wrong container";
+ end if;
if I.Node = J.Node then
return;
end if;
- pragma Assert (Container.Length >= 2);
-
- pragma Assert (J.Node /= null);
- pragma Assert (J.Node.Prev = null
- or else J.Node.Prev.Next = J.Node);
- pragma Assert (J.Node.Next = null
- or else J.Node.Next.Prev = J.Node);
- pragma Assert (J.Node.Prev /= null
- or else J.Node = Container.First);
- pragma Assert (J.Node.Next /= null
- or else J.Node = Container.Last);
-
if Container.Busy > 0 then
- raise Program_Error;
+ raise Program_Error with
+ "attempt to tamper with elements (list is busy)";
end if;
+ pragma Assert (Vet (I), "bad I cursor in Swap_Links");
+ pragma Assert (Vet (J), "bad J cursor in Swap_Links");
+
declare
I_Next : constant Cursor := Next (I);
--------------------
procedure Update_Element
- (Position : Cursor;
- Process : not null access procedure (Element : in out Element_Type)) is
-
- pragma Assert (Position.Container /= null);
- pragma Assert (Position.Container.Length >= 1);
- pragma Assert (Position.Container.First.Prev = null);
- pragma Assert (Position.Container.Last.Next = null);
-
- pragma Assert (Position.Node /= null);
- pragma Assert (Position.Node.Prev = null
- or else Position.Node.Prev.Next = Position.Node);
- pragma Assert (Position.Node.Next = null
- or else Position.Node.Next.Prev = Position.Node);
- pragma Assert (Position.Node.Prev /= null
- or else Position.Node = Position.Container.First);
- pragma Assert (Position.Node.Next /= null
- or else Position.Node = Position.Container.Last);
-
- E : Element_Type renames Position.Node.Element;
-
- C : List renames Position.Container.all'Unrestricted_Access.all;
- B : Natural renames C.Busy;
- L : Natural renames C.Lock;
-
+ (Container : in out List;
+ Position : Cursor;
+ Process : not null access procedure (Element : in out Element_Type))
+ is
begin
- B := B + 1;
- L := L + 1;
+ if Position.Node = null then
+ raise Constraint_Error with "Position cursor has no element";
+ end if;
+
+ if Position.Container /= Container'Unchecked_Access then
+ raise Program_Error with
+ "Position cursor designates wrong container";
+ end if;
+
+ pragma Assert (Vet (Position), "bad cursor in Update_Element");
+
+ declare
+ B : Natural renames Container.Busy;
+ L : Natural renames Container.Lock;
begin
- Process (E);
- exception
- when others =>
- L := L - 1;
- B := B - 1;
- raise;
- end;
+ B := B + 1;
+ L := L + 1;
- L := L - 1;
- B := B - 1;
+ begin
+ Process (Position.Node.Element);
+ exception
+ when others =>
+ L := L - 1;
+ B := B - 1;
+ raise;
+ end;
+
+ L := L - 1;
+ B := B - 1;
+ end;
end Update_Element;
+ ---------
+ -- Vet --
+ ---------
+
+ function Vet (Position : Cursor) return Boolean is
+ begin
+ if Position.Node = null then
+ return Position.Container = null;
+ end if;
+
+ if Position.Container = null then
+ return False;
+ end if;
+
+ if Position.Node.Next = Position.Node then
+ return False;
+ end if;
+
+ if Position.Node.Prev = Position.Node then
+ return False;
+ end if;
+
+ declare
+ L : List renames Position.Container.all;
+ begin
+ if L.Length = 0 then
+ return False;
+ end if;
+
+ if L.First = null then
+ return False;
+ end if;
+
+ if L.Last = null then
+ return False;
+ end if;
+
+ if L.First.Prev /= null then
+ return False;
+ end if;
+
+ if L.Last.Next /= null then
+ return False;
+ end if;
+
+ if Position.Node.Prev = null
+ and then Position.Node /= L.First
+ then
+ return False;
+ end if;
+
+ if Position.Node.Next = null
+ and then Position.Node /= L.Last
+ then
+ return False;
+ end if;
+
+ if L.Length = 1 then
+ return L.First = L.Last;
+ end if;
+
+ if L.First = L.Last then
+ return False;
+ end if;
+
+ if L.First.Next = null then
+ return False;
+ end if;
+
+ if L.Last.Prev = null then
+ return False;
+ end if;
+
+ if L.First.Next.Prev /= L.First then
+ return False;
+ end if;
+
+ if L.Last.Prev.Next /= L.Last then
+ return False;
+ end if;
+
+ if L.Length = 2 then
+ if L.First.Next /= L.Last then
+ return False;
+ end if;
+
+ if L.Last.Prev /= L.First then
+ return False;
+ end if;
+
+ return True;
+ end if;
+
+ if L.First.Next = L.Last then
+ return False;
+ end if;
+
+ if L.Last.Prev = L.First then
+ return False;
+ end if;
+
+ if Position.Node = L.First then
+ return True;
+ end if;
+
+ if Position.Node = L.Last then
+ return True;
+ end if;
+
+ if Position.Node.Next = null then
+ return False;
+ end if;
+
+ if Position.Node.Prev = null then
+ return False;
+ end if;
+
+ if Position.Node.Next.Prev /= Position.Node then
+ return False;
+ end if;
+
+ if Position.Node.Prev.Next /= Position.Node then
+ return False;
+ end if;
+
+ if L.Length = 3 then
+ if L.First.Next /= Position.Node then
+ return False;
+ end if;
+
+ if L.Last.Prev /= Position.Node then
+ return False;
+ end if;
+ end if;
+
+ return True;
+ end;
+ end Vet;
+
-----------
-- Write --
-----------
procedure Write
- (Stream : access Root_Stream_Type'Class;
+ (Stream : not null access Root_Stream_Type'Class;
Item : List)
is
Node : Node_Access := Item.First;
end loop;
end Write;
+ procedure Write
+ (Stream : not null access Root_Stream_Type'Class;
+ Item : Cursor)
+ is
+ begin
+ raise Program_Error with "attempt to stream list cursor";
+ end Write;
+
end Ada.Containers.Doubly_Linked_Lists;