Subversion Repositories openrisc

-- C730001.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 the full view of a private extension may be derived

--      indirectly from the ancestor type (i.e., the parent type of the full

--      type may be any descendant of the ancestor type). Check that, for

--      a primitive subprogram of the private extension that is inherited from

--      the ancestor type and not overridden, the formal parameter names and

--      default expressions come from the corresponding primitive subprogram

--      of the ancestor type, while the body comes from that of the parent

--      type.  Check both dispatching and non-dispatching cases.

--

-- TEST DESCRIPTION:

--      Consider:

--

--      package P is

--         type Ancestor is tagged ...

--         procedure Op (P1: Ancestor; P2: Boolean := True);

--      end P;

--

--      with P;

--      package Q is

--         type Derived is new P.Ancestor with ...

--         procedure Op (X: Ancestor; Y: Boolean := False);

--      end Q;

--

--      with P, Q;

--      package R is

--         type Priv_Ext is new P.Ancestor with private;   -- (A)

--         -- Inherits procedure Op (P1: Priv_Ext; P2: Boolean := True);

--         -- But body executed is that of Q.Op.

--      private

--         type Priv_Ext is new Q.Derived with record ...  -- (B)

--      end R;

--

--      The ancestor type in (A) differs from the parent type in (B); the

--      parent of the full type is descended from the ancestor type of the

--      private extension. For a call to Op (from outside the scope of the

--      full view) with an operand of type Priv_Ext, the formal parameter

--      names and default expression come from that of P.Op (the ancestor

--      type's version), but the body executed will be that of

--      Q.Op (the parent type's version)

--

--      One half of the test mirrors the above template, where an inherited

--      subprogram (Set_Display) is called using the formal parameter

--      name (C) and default parameter expression of the ancestor type's

--      version (type Clock), but the version of the body executed is from

--      the parent type.

--

--      The test also includes an examination of the dynamic evaluation

--      case, where correct body associations are required through dispatching

--      calls.  As described for the non-dispatching case above, the formal

--      parameter name and default values of the ancestor type's (Phone)

--      version of the inherited subprogram (Answer) are used in the

--      dispatching call, but the body executed is from the parent type.

--

--

-- CHANGE HISTORY:

--      06 Dec 94   SAIC    ACVC 2.0

--

--!

package C730001_0 is

   type Display_Kind      is (None, Analog, Digital);

   type Illumination_Type is (None, Light, Phosphorescence);

   type Capability_Type   is (Available, In_Use, Call_Waiting, Conference);

   type Indicator_Type    is (None, Light, Bell, Buzzer, Click, Modem);

   type Clock is abstract tagged record           -- ancestor type associated

      Display      : Display_Kind      := None;   -- with non-dispatching case.

      Illumination : Illumination_Type := None;

   end record;

   type Phone is tagged record                    -- ancestor type associated

      Status    : Capability_Type := Available;   -- with dispatching case.

      Indicator : Indicator_Type  := None;

   end record;

   -- The Set_Display procedure for type Clock implements a basic, no-frills

   -- clock display.

   procedure Set_Display (C   : in out Clock;

                          Disp: in     Display_Kind := Digital);

   -- The Answer procedure for type Phone implements a phone status change

   -- operation.

   procedure Answer (The_Phone : in out Phone;

                     Ind       : in     Indicator_Type := Light);

   -- ...Other general clock and/or phone operations (not specified in this

   -- test scenario).

end C730001_0;

     --==================================================================--

package body C730001_0 is

   procedure Set_Display (C   : in out Clock;

                          Disp: in     Display_Kind := Digital) is

   begin

      C.Display      := Disp;

      C.Illumination := Light;

   end Set_Display;

   procedure Answer (The_Phone : in out Phone;

                     Ind       : in     Indicator_Type := Light) is

   begin

      The_Phone.Status    := In_Use;

      The_Phone.Indicator := Ind;

   end Answer;

end C730001_0;

     --==================================================================--

with C730001_0; use C730001_0;

package C730001_1 is

   type Power_Supply_Type is (Spring, Battery, AC_Current);

   type Speaker_Type      is (None, Present, Adjustable, Stereo);

   type Wall_Clock is new Clock with record

      Power_Source : Power_Supply_Type := Spring;

   end record;

   type Office_Phone is new Phone with record

      Speaker : Speaker_Type := Present;

   end record;

   -- Note: Both procedures below, parameter names and defaults differ from

   --       parent's version.

   -- The Set_Display procedure for type Wall_Clock improves upon the

   -- basic Set_Display procedure of type Clock.

   procedure Set_Display (WC: in out Wall_Clock;

                          D : in     Display_Kind := Analog);

   procedure Answer (OP : in out Office_Phone;

                     OI : in     Indicator_Type := Buzzer);

   -- ...Other wall clock and/or Office_Phone operations (not specified in

   -- this test scenario).

end C730001_1;

     --==================================================================--

package body C730001_1 is

   -- Note: This body is the one that should be executed in the test block

   --       below, not the version of the body corresponding to type Clock.

   procedure Set_Display (WC: in out Wall_Clock;

                          D : in     Display_Kind := Analog) is

   begin

      WC.Display      := D;

      WC.Illumination := Phosphorescence;

   end Set_Display;

   procedure Answer (OP : in out Office_Phone;

                     OI : in     Indicator_Type := Buzzer) is

   begin

      OP.Status    := Call_Waiting;

      OP.Indicator := OI;

   end Answer;

end C730001_1;

     --==================================================================--

with C730001_0; use C730001_0;

with C730001_1; use C730001_1;

package C730001_2 is

   type Alarm_Type  is (Buzzer, Radio, Both);

   type Video_Type  is (None, TV_Monitor, Wall_Projection);

   type Alarm_Clock is new Clock with private;

   -- Inherits proc Set_Display (C   : in out Clock;

   --                            Disp: in     Display_Kind := Digital); -- (A)

   --

   -- Would also inherit other general clock operations (if present).

   type Conference_Room_Phone is new Office_Phone with record

      Display : Video_Type := TV_Monitor;

   end record;

   procedure Answer (CP : in out Conference_Room_Phone;

                     CI : in     Indicator_Type := Modem);

   function TC_Get_Display              (C: Alarm_Clock) return Display_Kind;

   function TC_Get_Display_Illumination (C: Alarm_Clock)

     return Illumination_Type;

private

   -- ...however, certain of the wall clock's operations (Set_Display, in

   -- this example) improve on the implementations provided for the general

   -- clock. We want to call the improved implementations, so we

   -- derive from Wall_Clock in the private part.

   type Alarm_Clock is new Wall_Clock with record

      Alarm : Alarm_Type := Buzzer;

   end record;

   -- Inherits proc Set_Display (WC: in out Wall_Clock;

   --                            D : in     Display_Kind := Analog);    -- (B)

   -- The implicit Set_Display at (B) overrides the implicit Set_Display at

   -- (A), but only within the scope of the full view.

   --

   -- Outside the scope of the full view, only (A) is visible, so calls

   -- from outside the scope will get the formal parameter names and default

   -- from (A). Both inside and outside the scope, however, the body executed

   -- will be that corresponding to Set_Display of the parent type.

end C730001_2;

     --==================================================================--

package body C730001_2 is

   procedure Answer (CP : in out Conference_Room_Phone;

                     CI : in     Indicator_Type := Modem)is

   begin

      CP.Status    := Conference;

      CP.Indicator := CI;

   end Answer;

   function TC_Get_Display (C: Alarm_Clock) return Display_Kind is

   begin

      return C.Display;

   end TC_Get_Display;

   function TC_Get_Display_Illumination (C: Alarm_Clock)

     return Illumination_Type is

   begin

      return C.Illumination;

   end TC_Get_Display_Illumination;

end C730001_2;

     --==================================================================--

with C730001_0; use C730001_0;

with C730001_1; use C730001_1;

with C730001_2; use C730001_2;

package C730001_3 is

   -- Types extended from the ancestor (Phone) type in the specification.

   type Secure_Phone_Type     is new Phone with private;

   type Auditorium_Phone_Type is new Phone with private;

   -- Inherit versions of Answer from ancestor (Phone).

   function TC_Get_Phone_Status (P : Phone'Class) return Capability_Type;

   function TC_Get_Indicator    (P : Phone'Class) return Indicator_Type;

private

   -- Types extended from descendents of Phone_Type in the private part.

   type Secure_Phone_Type is new Office_Phone with record

      Scrambled_Communication : Boolean := True;

   end record;

   type Auditorium_Phone_Type is new Conference_Room_Phone with record

      Volume_Control : Boolean := True;

   end record;

end C730001_3;

     --==================================================================--

package body C730001_3 is

   function TC_Get_Phone_Status (P : Phone'Class) return Capability_Type is

   begin

      return P.Status;

   end TC_Get_Phone_Status;

   function TC_Get_Indicator (P : Phone'Class) return Indicator_Type is

   begin

      return P.Indicator;

   end TC_Get_Indicator;

end C730001_3;

     --==================================================================--

with C730001_0; use C730001_0;

with C730001_1; use C730001_1;

with C730001_2; use C730001_2;

with C730001_3; use C730001_3;

with Report;

procedure C730001 is

begin

   Report.Test ("C730001","Check that the full view of a private extension " &

                          "may be derived indirectly from the ancestor "     &

                          "type. Check that, for a primitive subprogram "    &

                          "of the private extension that is inherited from " &

                          "the ancestor type and not overridden, the "       &

                          "formal parameter names and default expressions "  &

                          "come from the corresponding primitive "           &

                          "subprogram of the ancestor type, while the body " &

                          "comes from that of the parent type");

   Test_Block:

   declare

      Alarm                : Alarm_Clock;

      Hot_Line             : Secure_Phone_Type;

      TeleConference_Phone : Auditorium_Phone_Type;

   begin

   -- Evaluate non-dispatching case:

      -- Call Set_Display using formal parameter name from

      -- C730001_0.Set_Display.

      -- Give no 2nd parameter so that default expression must be used.

      Set_Display (C => Alarm);

      -- The value of the Display component should equal Digital, which is

      -- the default value from the ancestor's version of Set_Display,

      -- and not the default value from the parent's version of Set_Display.

      if TC_Get_Display (Alarm) /= Digital then

         Report.Failed ("Default expression for ancestor op not used " &

                        "in non-dispatching case");

      end if;

      -- However, the value of the Illumination component should equal

      -- Phosphorescence, which is assigned in the parent type's version of

      -- the body of Set_Display.

      if TC_Get_Display_Illumination (Alarm) /= Phosphorescence then

         Report.Failed ("Wrong body was executed in non-dispatching case");

      end if;

   -- Evaluate dispatching case:

      declare

         Hot_Line             : Secure_Phone_Type;

         TeleConference_Phone : Auditorium_Phone_Type;

         procedure Answer_The_Phone (P : in out Phone'Class) is

         begin

            -- Give no 2nd parameter so that default expression must be used.

            Answer (P);

         end Answer_The_Phone;

      begin

         Answer_The_Phone (Hot_Line);

         Answer_The_Phone (TeleConference_Phone);

         -- The value of the Indicator field shold equal "Light", the default

         -- value from the ancestor's version of Answer, and not the default

         -- from either of the parent versions of Answer.

         if TC_Get_Indicator(Hot_Line)             /= Light   or

            TC_Get_Indicator(TeleConference_Phone) /= Light

         then

            Report.Failed("Default expression from ancestor operation " &

                          "not used in dispatching case");

         end if;

         -- However, the value of the Status component should equal

         -- Call_Waiting or Conference respectively, based on the assignment

         -- in the parent type's version of the body of Answer.

         if TC_Get_Phone_Status(Hot_Line)  /=  Call_Waiting then

            Report.Failed("Wrong body executed in dispatching case - 1");

         end if;

         if TC_Get_Phone_Status(TeleConference_Phone) /= Conference then

            Report.Failed("Wrong body executed in dispatching case - 2");

         end if;

      end;

   exception

      when others => Report.Failed ("Exception raised in Test_Block");

   end Test_Block;

   Report.Result;

end C730001;