Subversion Repositories openrisc

-- C761003.A

--

--                             Grant of Unlimited Rights

--

--     Under contracts F33600-87-D-0337, F33600-84-D-0280, MDA903-79-C-0687,

--     F08630-91-C-0015, and DCA100-97-D-0025, the U.S. Government obtained

--     unlimited rights in the software and documentation contained herein.

--     Unlimited rights are defined in DFAR 252.227-7013(a)(19).  By making

--     this public release, the Government intends to confer upon all

--     recipients unlimited rights  equal to those held by the Government.

--     These rights include rights to use, duplicate, release or disclose the

--     released technical data and computer software in whole or in part, in

--     any manner and for any purpose whatsoever, and to have or permit others

--     to do so.

--

--                                    DISCLAIMER

--

--     ALL MATERIALS OR INFORMATION HEREIN RELEASED, MADE AVAILABLE OR

--     DISCLOSED ARE AS IS.  THE GOVERNMENT MAKES NO EXPRESS OR IMPLIED

--     WARRANTY AS TO ANY MATTER WHATSOEVER, INCLUDING THE CONDITIONS OF THE

--     SOFTWARE, DOCUMENTATION OR OTHER INFORMATION RELEASED, MADE AVAILABLE

--     OR DISCLOSED, OR THE OWNERSHIP, MERCHANTABILITY, OR FITNESS FOR A

--     PARTICULAR PURPOSE OF SAID MATERIAL.

--*

--

-- OBJECTIVE:

--      Check that an object of a controlled type is finalized when the

--      enclosing master is complete.

--      Check this for controlled types where the derived type has a

--      discriminant.

--      Check this for subprograms of abstract types derived from the

--      types in Ada.Finalization.

--

--      Check that finalization of controlled objects is

--      performed in the correct order.  In particular, check that if

--      multiple objects of controlled types are declared immediately

--      within the same declarative part then type are finalized in the

--      reverse order of their creation.

--

-- TEST DESCRIPTION:

--      This test checks these conditions for subprograms and

--      block statements; both variables and constants of controlled

--      types; cases of a controlled component of a record type, as

--      well as an array with controlled components.

--

--      The base controlled types used for the test are defined

--      with a character discriminant.  The initialize procedure for

--      the types will record the order of creation in a globally

--      accessible array, the finalize procedure for the types will call

--      TCTouch with that tag character.  The test can then check that

--      the order of finalization is indeed the reverse of the order of

--      creation (assuming that the implementation calls Initialize in

--      the order that the objects are created).

--

--

-- CHANGE HISTORY:

--      06 Dec 94   SAIC    ACVC 2.0

--      02 Nov 95   SAIC    ACVC 2.0.1

--

--!

------------------------------------------------------------ C761003_Support

package C761003_Support is

  function Pick_Char return Character;

  -- successive calls to Pick_Char return distinct characters which may

  -- be assigned to objects to track an order sequence.  These characters

  -- are then used in calls to TCTouch.Touch.

  procedure Validate(Initcount   : Natural;

                     Testnumber  : Natural;

                     Check_Order : Boolean := True);

  -- does a little extra processing prior to calling TCTouch.Validate,

  -- specifically, it reverses the stored string of characters, and checks

  -- for a correct count.

  Inits_Order  : String(1..255);

  Inits_Called : Natural := 0;

end C761003_Support;

-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --

with Report;

with TCTouch;

package body C761003_Support is

  type Pick_Rotation is mod 52;

  type Pick_String is array(Pick_Rotation) of Character;

  From : constant Pick_String  := "ABCDEFGHIJKLMNOPQRSTUVWXYZ"

                                & "abcdefghijklmnopqrstuvwxyz";

  Recent_Pick : Pick_Rotation := Pick_Rotation'Last;

  function Pick_Char return Character is

  begin

    Recent_Pick := Recent_Pick +1;

    return From(Recent_Pick);

  end Pick_Char;

  function Invert(S:String) return String is

    T: String(1..S'Length);

  begin

    for SI in reverse S'Range loop

      T(S'Last - SI + 1) := S(SI);

    end loop;

    return T;

  end Invert;

  procedure Validate(Initcount   : Natural;

                     Testnumber  : Natural;

                     Check_Order : Boolean := True) is

    Number : constant String := Natural'Image(Testnumber);

  begin

    if Inits_Called /= Initcount then

      Report.Failed("Got" & Natural'Image(Inits_Called) & " inits, expected"

                    & Natural'Image(Initcount) & ", Subtest " & Number);

      TCTouch.Flush;

    else

      TCTouch.Validate(

        Invert(Inits_Order(1..Inits_Called)),

               "Subtest " & Number, Order_Meaningful => Check_Order );

    end if;

    Inits_Called := 0;  -- reset for the next batch

  end Validate;

end C761003_Support;

------------------------------------------------------------------ C761003_0

with Ada.Finalization;

package C761003_0 is

  type Global(Tag: Character) is new Ada.Finalization.Controlled

    with null record;

  procedure Initialize( It: in out Global );

  procedure Finalize  ( It: in out Global );

  Null_Global : Global('1') := (Ada.Finalization.Controlled with Tag => '1');

  type Second(Tag: Character) is new Ada.Finalization.Limited_Controlled

    with null record;

  procedure Initialize( It: in out Second );

  procedure Finalize  ( It: in out Second );

end C761003_0;

------------------------------------------------------------------ C761003_1

with Ada.Finalization;

package C761003_1 is

  type Global is abstract new Ada.Finalization.Controlled with record

    Tag: Character;

  end record;

  procedure Initialize( It: in out Global );

  procedure Finalize  ( It: in out Global );

  type Second is abstract new Ada.Finalization.Limited_Controlled with record

    Tag: Character;

  end record;

  procedure Initialize( It: in out Second );

  procedure Finalize  ( It: in out Second );

end C761003_1;

------------------------------------------------------------------ C761003_2

with C761003_1;

package C761003_2 is

  type Global is new C761003_1.Global with null record;

  -- inherits Initialize and Finalize

  type Second is new C761003_1.Second with null record;

  -- inherits Initialize and Finalize

end C761003_2;

-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --  C761003_0

with TCTouch;

with C761003_Support;

package body C761003_0 is

  package Sup renames C761003_Support;

  procedure Initialize( It: in out Global ) is

  begin

    Sup.Inits_Called := Sup.Inits_Called +1;

    Sup.Inits_Order(Sup.Inits_Called) := It.Tag;

  end Initialize;

  procedure Finalize( It: in out Global ) is

  begin

    TCTouch.Touch(It.Tag);  --------------------------------------------- Tag

  end Finalize;

  procedure Initialize( It: in out Second ) is

  begin

    Sup.Inits_Called := Sup.Inits_Called +1;

    Sup.Inits_Order(Sup.Inits_Called) := It.Tag;

  end Initialize;

  procedure Finalize( It: in out Second ) is

  begin

    TCTouch.Touch(It.Tag);  --------------------------------------------- Tag

  end Finalize;

end C761003_0;

-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --  C761003_1

with TCTouch;

with C761003_Support;

package body C761003_1 is

  package Sup renames C761003_Support;

  procedure Initialize( It: in out Global ) is

  begin

    Sup.Inits_Called := Sup.Inits_Called +1;

    It.Tag := Sup.Pick_Char;

    Sup.Inits_Order(Sup.Inits_Called) := It.Tag;

  end Initialize;

  procedure Finalize( It: in out Global ) is

  begin

    TCTouch.Touch(It.Tag);  --------------------------------------------- Tag

  end Finalize;

  procedure Initialize( It: in out Second ) is

  begin

    Sup.Inits_Called := Sup.Inits_Called +1;

    It.Tag := Sup.Pick_Char;

    Sup.Inits_Order(Sup.Inits_Called) := It.Tag;

  end Initialize;

  procedure Finalize( It: in out Second ) is

  begin

    TCTouch.Touch(It.Tag);  --------------------------------------------- Tag

  end Finalize;

end C761003_1;

-------------------------------------------------------------------- C761003

with Report;

with TCTouch;

with C761003_0;

with C761003_2;

with C761003_Support;

procedure C761003 is

  package Sup renames C761003_Support;

---------------------------------------------------------------- Subtest_1

  Subtest_1_Inits_Expected : constant := 5;  -- includes 1 previous

  procedure Subtest_1 is

    -- the constant will take its constraint from the value.

    -- must be declared first to be finalized last (and take the

    -- initialize from before calling subtest_1)

    Item_1 : constant C761003_0.Global := C761003_0.Null_Global;

    -- Item_2, declared second, should be finalized second to last.

    Item_2 : C761003_0.Global(Sup.Pick_Char);

    -- Item_3 and Item_4 will be created in the order of the

    -- list.

    Item_3, Item_4 : C761003_0.Global(Sup.Pick_Char);

   -- Item_5 will be finalized first.

    Item_5 : C761003_0.Second(Sup.Pick_Char);

  begin

    if Item_3.Tag >= Item_4.Tag then

      Report.Failed("Controlled objects created by list in wrong order");

    end if;

    -- check that nothing has happened yet!

    TCTouch.Validate("","Subtest 1 body");

  end Subtest_1;

---------------------------------------------------------------- Subtest_2

  -- These declarations should cause calls to initialize and

  -- finalize.  The expected operations are the subprograms associated

  -- with the abstract types.  Note that for these objects, the

  -- Initialize and Finalize are visible only by inheritance.

  Subtest_2_Inits_Expected : constant := 4;

  procedure Subtest_2 is

    Item_1 : C761003_2.Global;

    Item_2, Item_3 : C761003_2.Global;

    Item_4 : C761003_2.Second;

  begin

    -- check that nothing has happened yet!

    TCTouch.Validate("","Subtest 2 body");

  end Subtest_2;

---------------------------------------------------------------- Subtest_3

  -- Test for controlled objects embedded in arrays.  Using structures

  -- that will cause a checkable order.

  Subtest_3_Inits_Expected : constant := 8;

  procedure Subtest_3 is

    type Global_List is array(Natural range <>)

                          of C761003_0.Global(Sup.Pick_Char);

    Items : Global_List(1..4);  -- components have the same tag

    type Second_List is array(Natural range <>)

                          of C761003_0.Second(Sup.Pick_Char);

    Second_Items : Second_List(1..4);  -- components have the same tag,

                                       -- distinct from the tag used in Items

  begin

    -- check that nothing has happened yet!

    TCTouch.Validate("","Subtest 3 body");

  end Subtest_3;

---------------------------------------------------------------- Subtest_4

  -- These declarations should cause dispatching calls to initialize and

  -- finalize.  The expected operations are the subprograms associated

  -- with the abstract types.

  Subtest_4_Inits_Expected : constant := 2;

  procedure Subtest_4 is

    type Global_Rec is record

      Item1: C761003_0.Global(Sup.Pick_Char);

    end record;

    type Second_Rec is record

      Item2: C761003_2.Second;

    end record;

    G : Global_Rec;

    S : Second_Rec;

  begin

    -- check that nothing has happened yet!

    TCTouch.Validate("","Subtest 4 body");

  end Subtest_4;

---------------------------------------------------------------- Subtest_5

  -- Test for controlled objects embedded in arrays.  In these cases, the

  -- order of the finalization of the components is not defined by the

  -- language.

  Subtest_5_Inits_Expected : constant := 8;

  procedure Subtest_5 is

    type Another_Global_List is array(Natural range <>)

                          of C761003_2.Global;

    More_Items : Another_Global_List(1..4);

    type Another_Second_List is array(Natural range <>)

                          of C761003_2.Second;

    Second_More_Items : Another_Second_List(1..4);

  begin

    -- check that nothing has happened yet!

    TCTouch.Validate("","Subtest 5 body");

  end Subtest_5;

---------------------------------------------------------------- Subtest_6

  -- These declarations should cause dispatching calls to initialize and

  -- finalize.  The expected operations are the subprograms associated

  -- with the abstract types.

  Subtest_6_Inits_Expected : constant := 2;

  procedure Subtest_6 is

    type Global_Rec is record

     Item2: C761003_2.Global;

    end record;

    type Second_Rec is record

      Item1: C761003_0.Second(Sup.Pick_Char);

   end record;

    G : Global_Rec;

    S : Second_Rec;

  begin

    -- check that nothing has happened yet!

    TCTouch.Validate("","Subtest 6 body");

  end Subtest_6;

begin  -- Main test procedure.

  Report.Test ("C761003", "Check that an object of a controlled type "

                        & "is finalized when the enclosing master is "

                        & "complete, left by a transfer of control, "

                        & "and performed in the correct order" );

  -- adjust for optional adjusts and initializes for C761003_0.Null_Global

  TCTouch.Flush; -- clear the optional adjust

  if Sup.Inits_Called /= 1 then

    -- C761003_0.Null_Global did not get "initialized"

    C761003_0.Initialize(C761003_0.Null_Global);  -- prime the pump

  end if;

  Subtest_1;

  Sup.Validate(Subtest_1_Inits_Expected, 1);

  Subtest_2;

  Sup.Validate(Subtest_2_Inits_Expected, 2);

  Subtest_3;

  Sup.Validate(Subtest_3_Inits_Expected, 3);

  Subtest_4;

  Sup.Validate(Subtest_4_Inits_Expected, 4);

  Subtest_5;

  Sup.Validate(Subtest_5_Inits_Expected, 5, Check_Order => False);

  Subtest_6;

  Sup.Validate(Subtest_6_Inits_Expected, 6);

  Report.Result;

end C761003;