gcc/ada/libgnat/a-tiflio.ads

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