FSF GCC merge 02/23/03
[official-gcc.git] / gcc / ada / a-tienau.ads
blobc3188da19b00f663f51d395b9e082cee3e230a8b
1 ------------------------------------------------------------------------------
2 -- --
3 -- GNAT RUN-TIME COMPONENTS --
4 -- --
5 -- A D A . T E X T _ I O . E N U M E R A T I O N _ A U X --
6 -- --
7 -- S p e c --
8 -- --
9 -- --
10 -- Copyright (C) 1992-1997 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 ------------------------------------------------------------------------------
35 -- This package contains the routines for Ada.Text_IO.Enumeration_IO
36 -- that are shared among separate instantiations of this package.
38 private package Ada.Text_IO.Enumeration_Aux is
40 procedure Get_Enum_Lit
41 (File : File_Type;
42 Buf : out String;
43 Buflen : out Natural);
44 -- Reads an enumeration literal value from the file, folds to upper case,
45 -- and stores the result in Buf, setting Buflen to the number of stored
46 -- characters (Buf has a lower bound of 1). If more than Buflen characters
47 -- are present in the literal, Data_Error is raised.
49 procedure Scan_Enum_Lit
50 (From : String;
51 Start : out Natural;
52 Stop : out Natural);
53 -- Scans an enumeration literal at the start of From, skipping any leading
54 -- spaces. Sets Start to the first character, Stop to the last character.
55 -- Raises End_Error if no enumeration literal is found.
57 procedure Put
58 (File : File_Type;
59 Item : String;
60 Width : Field;
61 Set : Type_Set);
62 -- Outputs the enumeration literal image stored in Item to the given File,
63 -- using the given Width and Set parameters (Item is always in upper case).
65 procedure Puts
66 (To : out String;
67 Item : in String;
68 Set : Type_Set);
69 -- Stores the enumeration literal image stored in Item to the string To,
70 -- padding with trailing spaces if necessary to fill To. Set is used to
72 end Ada.Text_IO.Enumeration_Aux;