]>
Commit | Line | Data |
---|---|---|
d23b8f57 RK |
1 | ------------------------------------------------------------------------------ |
2 | -- -- | |
3 | -- GNAT RUN-TIME COMPONENTS -- | |
4 | -- -- | |
b2834fbd | 5 | -- A D A . S T R E A M S -- |
d23b8f57 RK |
6 | -- -- |
7 | -- S p e c -- | |
8 | -- -- | |
4b490c1e | 9 | -- Copyright (C) 1992-2020, Free Software Foundation, Inc. -- |
d23b8f57 RK |
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- -- | |
748086b7 | 17 | -- ware Foundation; either version 3, or (at your option) any later ver- -- |
d23b8f57 RK |
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 -- | |
748086b7 JJ |
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/>. -- | |
d23b8f57 RK |
30 | -- -- |
31 | -- GNAT was originally developed by the GNAT team at New York University. -- | |
71ff80dc | 32 | -- Extensive contributions were provided by Ada Core Technologies Inc. -- |
d23b8f57 RK |
33 | -- -- |
34 | ------------------------------------------------------------------------------ | |
35 | ||
d23b8f57 | 36 | package Ada.Streams is |
009186e0 | 37 | pragma Pure; |
d23b8f57 RK |
38 | |
39 | type Root_Stream_Type is abstract tagged limited private; | |
9b832db5 | 40 | pragma Preelaborable_Initialization (Root_Stream_Type); |
d23b8f57 RK |
41 | |
42 | type Stream_Element is mod 2 ** Standard'Storage_Unit; | |
43 | ||
697b781a | 44 | type Stream_Element_Offset is new Long_Long_Integer; |
2d249f52 | 45 | -- Stream_Element_Offset needs 64 bits to accommodate large stream files. |
697b781a AC |
46 | -- However, rather than make this explicitly 64-bits we derive from |
47 | -- Long_Long_Integer. In normal usage this will have the same effect. | |
48 | -- But in the case of CodePeer with a target configuration file with a | |
49 | -- maximum integer size of 32, it allows analysis of this unit. | |
d23b8f57 RK |
50 | |
51 | subtype Stream_Element_Count is | |
52 | Stream_Element_Offset range 0 .. Stream_Element_Offset'Last; | |
53 | ||
54 | type Stream_Element_Array is | |
07fc65c4 | 55 | array (Stream_Element_Offset range <>) of aliased Stream_Element; |
d23b8f57 RK |
56 | |
57 | procedure Read | |
58 | (Stream : in out Root_Stream_Type; | |
59 | Item : out Stream_Element_Array; | |
60 | Last : out Stream_Element_Offset) | |
61 | is abstract; | |
62 | ||
63 | procedure Write | |
64 | (Stream : in out Root_Stream_Type; | |
0ae9f22f | 65 | Item : Stream_Element_Array) |
d23b8f57 RK |
66 | is abstract; |
67 | ||
68 | private | |
69 | ||
70 | type Root_Stream_Type is abstract tagged limited null record; | |
71 | ||
b2834fbd AC |
72 | -- Stream attributes for Stream_Element_Array: trivially call the |
73 | -- corresponding stream primitive for the whole array, instead of doing | |
74 | -- so element by element. | |
75 | ||
76 | procedure Read_SEA | |
77 | (S : access Root_Stream_Type'Class; | |
78 | V : out Stream_Element_Array); | |
79 | ||
80 | procedure Write_SEA | |
81 | (S : access Root_Stream_Type'Class; | |
82 | V : Stream_Element_Array); | |
83 | ||
84 | for Stream_Element_Array'Read use Read_SEA; | |
85 | for Stream_Element_Array'Write use Write_SEA; | |
86 | ||
d23b8f57 | 87 | end Ada.Streams; |