gcc/ada/s-valuti.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT COMPILER COMPONENTS                         --
   4 --                                                                          --
   5 --                      S Y S T E M . V A L _ U T I L                       --
   6 --                                                                          --
   7 --                                 S p e c                                  --
   8 --                                                                          --
   9 --                                                                          --
  10 --   Copyright (C) 1992,1993,1994,1995,1996 Free Software Foundation, Inc.  --
  11 --                                                                          --
  12 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  13 -- terms of the  GNU General Public License as published  by the Free Soft- --
  14 -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
  15 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  16 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  17 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  18 -- for  more details.  You should have  received  a copy of the GNU General --
  19 -- Public License  distributed with GNAT;  see file COPYING.  If not, write --
  20 -- to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, --
  21 -- MA 02111-1307, USA.                                                      --
  22 --                                                                          --
  23 -- As a special exception,  if other files  instantiate  generics from this --
  24 -- unit, or you link  this unit with other files  to produce an executable, --
  25 -- this  unit  does not  by itself cause  the resulting  executable  to  be --
  26 -- covered  by the  GNU  General  Public  License.  This exception does not --
  27 -- however invalidate  any other reasons why  the executable file  might be --
  28 -- covered by the  GNU Public License.                                      --
  29 --                                                                          --
  30 -- GNAT was originally developed  by the GNAT team at  New York University. --
  31 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  32 --                                                                          --
  33 ------------------------------------------------------------------------------
  34
  35 --  This package provides some common utilities used by the s-valxxx files
  36
  37 package System.Val_Util is
  38 pragma Pure (Val_Util);
  39
  40    procedure Normalize_String
  41      (S    : in out String;
  42       F, L : out Integer);
  43    --  This procedure scans the string S setting F to be the index of the first
  44    --  non-blank character of S and L to be the index of the last non-blank
  45    --  character of S. Any lower case characters present in S will be folded
  46    --  to their upper case equivalent except for character literals. If S
  47    --  consists of entirely blanks then Constraint_Error is raised.
  48    --
  49    --  Note: if S is the null string, F is set to S'First, L to S'Last
  50
  51    procedure Scan_Sign
  52      (Str   : String;
  53       Ptr   : access Integer;
  54       Max   : Integer;
  55       Minus : out Boolean;
  56       Start : out Positive);
  57    --  The Str, Ptr, Max parameters are as for the scan routines (Str is the
  58    --  string to be scanned starting at Ptr.all, and Max is the index of the
  59    --  last character in the string). Scan_Sign first scans out any initial
  60    --  blanks, raising Constraint_Error if the field is all blank. It then
  61    --  checks for and skips an initial plus or minus, requiring a non-blank
  62    --  character to follow (Constraint_Error is raised if plus or minus
  63    --  appears at the end of the string or with a following blank). Minus is
  64    --  set True if a minus sign was skipped, and False otherwise. On exit
  65    --  Ptr.all points to the character after the sign, or to the first
  66    --  non-blank character if no sign is present. Start is set to the point
  67    --  to the first non-blank character (sign or digit after it).
  68    --
  69    --  Note: if Str is null, i.e. if Max is less than Ptr, then this is a
  70    --  special case of an all-blank string, and Ptr is unchanged, and hence
  71    --  is greater than Max as required in this case. Constraint_Error is
  72    --  also raised in this case.
  73
  74    function Scan_Exponent
  75      (Str  : String;
  76       Ptr  : access Integer;
  77       Max  : Integer;
  78       Real : Boolean := False)
  79       return Integer;
  80    --  Called to scan a possible exponent. Str, Ptr, Max are as described above
  81    --  for Scan_Sign. If Ptr.all < Max and Str (Ptr.all) = 'E' or 'e', then an
  82    --  exponent is scanned out, with the exponent value returned in Exp, and
  83    --  Ptr.all updated to point past the exponent. If the exponent field is
  84    --  incorrectly formed or not present, then Ptr.all is unchanged, and the
  85    --  returned exponent value is zero. Real indicates whether a minus sign
  86    --  is permitted (True = permitted). Very large exponents are handled by
  87    --  returning a suitable large value. If the base is zero, then any value
  88    --  is allowed, and otherwise the large value will either cause underflow
  89    --  or overflow during the scaling process which is fine.
  90
  91    procedure Scan_Trailing_Blanks (Str : String; P : Positive);
  92    --  Checks that the remainder of the field Str (P .. Str'Last) is all
  93    --  blanks. Raises Constraint_Error if a non-blank character is found.
  94
  95    procedure Scan_Underscore
  96      (Str : String;
  97       P   : in out Natural;
  98       Ptr : access Integer;
  99       Max : Integer;
 100       Ext : Boolean);
 101    --  Called if an underscore is encountered while scanning digits. Str (P)
 102    --  contains the underscore. Ptr it the pointer to be returned to the
 103    --  ultimate caller of the scan routine, Max is the maximum subscript in
 104    --  Str, and Ext indicates if extended digits are allowed. In the case
 105    --  where the underscore is invalid, Constraint_Error is raised with Ptr
 106    --  set appropriately, otherwise control returns with P incremented past
 107    --  the underscore.
 108
 109 end System.Val_Util;