Imported Upstream version 4.8.1
[platform/upstream/gcc48.git] / gcc / ada / s-dim.ads
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                         GNAT RUN-TIME COMPONENTS                         --
4 --                                                                          --
5 --                           S Y S T E M . D I M                            --
6 --                                                                          --
7 --                                 S p e c                                  --
8 --                                                                          --
9 --          Copyright (C) 2012-2013, Free Software Foundation, Inc.         --
10 --                                                                          --
11 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
12 -- terms of the  GNU General Public License as published  by the Free Soft- --
13 -- ware  Foundation;  either version 3,  or (at your option) any later ver- --
14 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE.                                     --
17 --                                                                          --
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
19 -- additional permissions described in the GCC Runtime Library Exception,   --
20 -- version 3.1, as published by the Free Software Foundation.               --
21 --                                                                          --
22 -- You should have received a copy of the GNU General Public License and    --
23 -- a copy of the GCC Runtime Library Exception along with this program;     --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
25 -- <http://www.gnu.org/licenses/>.                                          --
26 --                                                                          --
27 -- GNAT was originally developed  by the GNAT team at  New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
29 --                                                                          --
30 ------------------------------------------------------------------------------
31
32 --  Defines the dimension terminology
33
34 ---------------------------
35 -- Dimension Terminology --
36 ---------------------------
37
38 --  * Dimensioned type
39
40 --    A dimensioned type is a type (more accurately a first subtype) to which
41 --    the aspect Dimension_System applies to.
42
43 --      type Mks_Type is new Long_Long_Float
44 --        with
45 --         Dimension_System => (
46 --          (Unit_Name => Meter,    Unit_Symbol => 'm',   Dim_Symbol => 'L'),
47 --          (Unit_Name => Kilogram, Unit_Symbol => "kg",  Dim_Symbol => 'M'),
48 --          (Unit_Name => Second,   Unit_Symbol => 's',   Dim_Symbol => 'T'),
49 --          (Unit_Name => Ampere,   Unit_Symbol => 'A',   Dim_Symbol => 'I'),
50 --          (Unit_Name => Kelvin,   Unit_Symbol => 'K',   Dim_Symbol => "Θ"),
51 --          (Unit_Name => Mole,     Unit_Symbol => "mol", Dim_Symbol => 'N'),
52 --          (Unit_Name => Candela,  Unit_Symbol => "cd",  Dim_Symbol => 'J'));
53
54 --  * Dimensioned subtype
55
56 --    A dimensioned subtype is a subtype directly defined from the dimensioned
57 --    type and to which the aspect Dimension applies to.
58
59 --      subtype Length is Mks_Type
60 --        with
61 --         Dimension => (Symbol => 'm',
62 --           Meter =>  1,
63 --           others => 0);
64
65 package System.Dim is
66    pragma Pure;
67
68 end System.Dim;