gcc/ada/libgnat/a-tideio.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT RUN-TIME COMPONENTS                         --
   4 --                                                                          --
   5 --               A D A . T E X T _ I O . D E C I M A L _ I O                --
   6 --                                                                          --
   7 --                                 S p e c                                  --
   8 --                                                                          --
   9 --          Copyright (C) 1992-2023, 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 --  In Ada 95, the package Ada.Text_IO.Decimal_IO is a subpackage of Text_IO.
  37 --  This is for compatibility with Ada 83. In GNAT we make it a child package
  38 --  to avoid loading the necessary code if Decimal_IO is not instantiated.
  39 --  See routine Rtsfind.Check_Text_IO_Special_Unit for a description of how
  40 --  we patch up the difference in semantics so that it is invisible to the
  41 --  Ada programmer.
  42
  43 private generic
  44    type Num is delta <> digits <>;
  45
  46 package Ada.Text_IO.Decimal_IO with
  47   Always_Terminates
  48 is
  49
  50    Default_Fore : Field := Num'Fore;
  51    Default_Aft  : Field := Num'Aft;
  52    Default_Exp  : Field := 0;
  53
  54    procedure Get
  55      (File  : File_Type;
  56       Item  : out Num;
  57       Width : Field := 0)
  58    with
  59      Pre               => Is_Open (File) and then Mode (File) = In_File,
  60      Global            => (In_Out => File_System),
  61      Exceptional_Cases => (Data_Error | End_Error => Standard.True);
  62
  63    procedure Get
  64      (Item  : out Num;
  65       Width : Field := 0)
  66    with
  67      Post              =>
  68        Line_Length'Old = Line_Length
  69        and Page_Length'Old = Page_Length,
  70      Global            => (In_Out => File_System),
  71      Exceptional_Cases => (Data_Error | End_Error => Standard.True);
  72
  73    procedure Put
  74      (File : File_Type;
  75       Item : Num;
  76       Fore : Field := Default_Fore;
  77       Aft  : Field := Default_Aft;
  78       Exp  : Field := Default_Exp)
  79    with
  80      Pre               => Is_Open (File) and then Mode (File) /= In_File,
  81      Post              =>
  82        Line_Length (File)'Old = Line_Length (File)
  83        and Page_Length (File)'Old = Page_Length (File),
  84      Global            => (In_Out => File_System),
  85      Exceptional_Cases => (Layout_Error => Line_Length (File) /= 0);
  86
  87    procedure Put
  88      (Item : Num;
  89       Fore : Field := Default_Fore;
  90       Aft  : Field := Default_Aft;
  91       Exp  : Field := Default_Exp)
  92    with
  93      Post              =>
  94        Line_Length'Old = Line_Length
  95        and Page_Length'Old = Page_Length,
  96      Global            => (In_Out => File_System),
  97      Exceptional_Cases => (Layout_Error => Ada.Text_IO.Line_Length /= 0);
  98
  99    procedure Get
 100      (From : String;
 101       Item : out Num;
 102       Last : out Positive)
 103    with
 104      Global   => null,
 105      Exceptional_Cases => (Data_Error => Standard.True);
 106
 107    procedure Put
 108      (To   : out String;
 109       Item : Num;
 110       Aft  : Field := Default_Aft;
 111       Exp  : Field := Default_Exp)
 112    with
 113      Global            => null,
 114      Exceptional_Cases => (Layout_Error => Standard.True);
 115
 116 private
 117    pragma Inline (Get);
 118    pragma Inline (Put);
 119
 120 end Ada.Text_IO.Decimal_IO;