--::::::::::
--sttacnad.ads   --       -Advanced
--::::::::::
with Stack_LPBase.Advanced;
generic
package Stack_Tag_Cntl.Advanced is
   ---------------------------------------------------------------------
   -- DO NOT USE adv_lps
      package adv_stk is new stk.Advanced;
   ---------------------------------------------------------------------

function Size_Of (Stack: Stack_Type) return natural;
   ---------------------------------------------------------------------
   -- Pre  Cond  : None
   -- Post Cond  : Returns a count of the number of object in the stack
   -- Exceptions : None
   ---------------------------------------------------------------------

function Peek (Stack   : Stack_Type;
               Position: positive) return Object_Ptr;
   ---------------------------------------------------------------------
   -- Pre  Cond  : 1 <= Position <= Size_Of (Stack)
   --              1 = top, Size_Of (Stack) = bottom
   -- Post Cond  : Returns Stack(Position)
   -- Exceptions : Invalid_Position
   ---------------------------------------------------------------------

procedure Poke (Stack   : in out Stack_Type;
                Position: in     positive;
                Object  : in     Object_Type'Class);
   ---------------------------------------------------------------------
   -- Pre  Cond  : 1 <= Position <= Size_Of (Stack)
   --              1 = top, Size_Of (Stack) = bottom
   -- Post Cond  : Stack(Position)' = Object
   -- Exceptions : Invalid_Position
   ---------------------------------------------------------------------

procedure Insert (Object  : in     Object_Type'Class;
                  Position: in     positive;
                  Stack   : in out Stack_Type);
   ---------------------------------------------------------------------
   -- Pre  Cond : 1 <= Position <= Size_Of (Stack)
   -- Post Cond : Stack'=(a ,...,a          ,Object,a        ,...,a )
   --                      1      position-1         position      n
   -- Exceptions: Invalid_Position
   ---------------------------------------------------------------------

procedure Remove (Stack   : in out Stack_Type;
                  Position: in     positive;
                  Object  :    out Object_Ptr);
   ---------------------------------------------------------------------
   -- Pre  Cond : 1 <= Position <= Size_Of (Stack)
   -- Post Cond : Stack'=(a ,...,a          ,a          ,...,a )
   --                      1      position-1  position+1      n
   --             Object' = Stack(position)
   -- Exceptions: Invalid_Position
   ---------------------------------------------------------------------

end Stack_Tag_Cntl.Advanced;