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
36pragma Warnings (Off);
37with System.Finalization_Root;
38pragma Warnings (On);
39
40package 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
61private
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
73end Ada.Finalization;
74