gcc/ada/a-finali.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT RUN-TIME COMPONENTS                         --
   4 --                                                                          --
   5 --                     A D A . F I N A L I Z A T I O N                      --
   6 --                                                                          --
   7 --                                 S p e c                                  --
   8 --                                                                          --
   9 --          Copyright (C) 1992-2011, Free Software Foundation, Inc.         --
  10 --                                                                          --
  11 -- This specification is derived from the Ada Reference Manual for use with --
  12 -- GNAT. The copyright notice above, and the license provisions that follow --
  13 -- apply solely to the  contents of the part following the private keyword. --
  14 --                                                                          --
  15 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  16 -- terms of the  GNU General Public License as published  by the Free Soft- --
  17 -- ware  Foundation;  either version 3,  or (at your option) any later ver- --
  18 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  19 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  20 -- or FITNESS FOR A PARTICULAR PURPOSE.                                     --
  21 --                                                                          --
  22 -- As a special exception under Section 7 of GPL version 3, you are granted --
  23 -- additional permissions described in the GCC Runtime Library Exception,   --
  24 -- version 3.1, as published by the Free Software Foundation.               --
  25 --                                                                          --
  26 -- You should have received a copy of the GNU General Public License and    --
  27 -- a copy of the GCC Runtime Library Exception along with this program;     --
  28 -- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
  29 -- <http://www.gnu.org/licenses/>.                                          --
  30 --                                                                          --
  31 -- GNAT was originally developed  by the GNAT team at  New York University. --
  32 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  33 --                                                                          --
  34 ------------------------------------------------------------------------------
  35
  36 pragma Warnings (Off);
  37 with System.Finalization_Root;
  38 pragma Warnings (On);
  39
  40 package Ada.Finalization is
  41    pragma Pure_12;
  42    --  Ada.Finalization is declared pure in Ada 2012 (AI05-0212)
  43
  44    pragma Preelaborate;
  45    pragma Remote_Types;
  46    --  The above apply in versions of Ada before Ada 2012
  47
  48    type Controlled is abstract tagged private;
  49    pragma Preelaborable_Initialization (Controlled);
  50
  51    procedure Initialize (Object : in out Controlled);
  52    procedure Adjust     (Object : in out Controlled);
  53    procedure Finalize   (Object : in out Controlled);
  54
  55    type Limited_Controlled is abstract tagged limited private;
  56    pragma Preelaborable_Initialization (Limited_Controlled);
  57
  58    procedure Initialize (Object : in out Limited_Controlled);
  59    procedure Finalize   (Object : in out Limited_Controlled);
  60
  61 private
  62    package SFR renames System.Finalization_Root;
  63
  64    type Controlled is abstract new SFR.Root_Controlled with null record;
  65
  66    --  In order to simplify the implementation, the mechanism in Process_Full_
  67    --  View ensures that the full view is limited even though the parent type
  68    --  is not.
  69
  70    type Limited_Controlled is
  71      abstract new SFR.Root_Controlled with null record;
  72
  73 end Ada.Finalization;