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 is
  47
  48    Default_Fore : Field := Num'Fore;
  49    Default_Aft  : Field := Num'Aft;
  50    Default_Exp  : Field := 0;
  51
  52    procedure Get
  53      (File  : File_Type;
  54       Item  : out Num;
  55       Width : Field := 0)
  56    with
  57      Pre      => Is_Open (File) and then Mode (File) = In_File,
  58      Global   => (In_Out => File_System),
  59      Annotate => (GNATprove, Might_Not_Return);
  60
  61    procedure Get
  62      (Item  : out Num;
  63       Width : Field := 0)
  64    with
  65      Post     =>
  66        Line_Length'Old = Line_Length
  67        and Page_Length'Old = Page_Length,
  68      Global   => (In_Out => File_System),
  69      Annotate => (GNATprove, Might_Not_Return);
  70
  71    procedure Put
  72      (File : File_Type;
  73       Item : Num;
  74       Fore : Field := Default_Fore;
  75       Aft  : Field := Default_Aft;
  76       Exp  : Field := Default_Exp)
  77    with
  78      Pre      => Is_Open (File) and then Mode (File) /= In_File,
  79      Post     =>
  80        Line_Length (File)'Old = Line_Length (File)
  81        and Page_Length (File)'Old = Page_Length (File),
  82      Global   => (In_Out => File_System),
  83      Annotate => (GNATprove, Might_Not_Return);
  84
  85    procedure Put
  86      (Item : Num;
  87       Fore : Field := Default_Fore;
  88       Aft  : Field := Default_Aft;
  89       Exp  : Field := Default_Exp)
  90    with
  91      Post     =>
  92        Line_Length'Old = Line_Length
  93        and Page_Length'Old = Page_Length,
  94      Global   => (In_Out => File_System),
  95      Annotate => (GNATprove, Might_Not_Return);
  96
  97    procedure Get
  98      (From : String;
  99       Item : out Num;
 100       Last : out Positive)
 101    with
 102      Global   => null,
 103      Annotate => (GNATprove, Might_Not_Return);
 104
 105    procedure Put
 106      (To   : out String;
 107       Item : Num;
 108       Aft  : Field := Default_Aft;
 109       Exp  : Field := Default_Exp)
 110    with
 111      Global   => null,
 112      Annotate => (GNATprove, Might_Not_Return);
 113
 114 private
 115    pragma Inline (Get);
 116    pragma Inline (Put);
 117
 118 end Ada.Text_IO.Decimal_IO;