annotate gcc/ada/libgnat/a-strunb.ads @ 131:84e7813d76e9

gcc-8.2
author mir3636
date Thu, 25 Oct 2018 07:37:49 +0900
parents 04ced10e8804
children 1830386684a0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 ------------------------------------------------------------------------------
kono
parents:
diff changeset
2 -- --
kono
parents:
diff changeset
3 -- GNAT RUN-TIME COMPONENTS --
kono
parents:
diff changeset
4 -- --
kono
parents:
diff changeset
5 -- A D A . S T R I N G S . U N B O U N D E D --
kono
parents:
diff changeset
6 -- --
kono
parents:
diff changeset
7 -- S p e c --
kono
parents:
diff changeset
8 -- --
131
84e7813d76e9 gcc-8.2
mir3636
parents: 111
diff changeset
9 -- Copyright (C) 1992-2018, Free Software Foundation, Inc. --
111
kono
parents:
diff changeset
10 -- --
kono
parents:
diff changeset
11 -- This specification is derived from the Ada Reference Manual for use with --
kono
parents:
diff changeset
12 -- GNAT. The copyright notice above, and the license provisions that follow --
kono
parents:
diff changeset
13 -- apply solely to the contents of the part following the private keyword. --
kono
parents:
diff changeset
14 -- --
kono
parents:
diff changeset
15 -- GNAT is free software; you can redistribute it and/or modify it under --
kono
parents:
diff changeset
16 -- terms of the GNU General Public License as published by the Free Soft- --
kono
parents:
diff changeset
17 -- ware Foundation; either version 3, or (at your option) any later ver- --
kono
parents:
diff changeset
18 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
kono
parents:
diff changeset
19 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
kono
parents:
diff changeset
20 -- or FITNESS FOR A PARTICULAR PURPOSE. --
kono
parents:
diff changeset
21 -- --
kono
parents:
diff changeset
22 -- As a special exception under Section 7 of GPL version 3, you are granted --
kono
parents:
diff changeset
23 -- additional permissions described in the GCC Runtime Library Exception, --
kono
parents:
diff changeset
24 -- version 3.1, as published by the Free Software Foundation. --
kono
parents:
diff changeset
25 -- --
kono
parents:
diff changeset
26 -- You should have received a copy of the GNU General Public License and --
kono
parents:
diff changeset
27 -- a copy of the GCC Runtime Library Exception along with this program; --
kono
parents:
diff changeset
28 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
kono
parents:
diff changeset
29 -- <http://www.gnu.org/licenses/>. --
kono
parents:
diff changeset
30 -- --
kono
parents:
diff changeset
31 -- GNAT was originally developed by the GNAT team at New York University. --
kono
parents:
diff changeset
32 -- Extensive contributions were provided by Ada Core Technologies Inc. --
kono
parents:
diff changeset
33 -- --
kono
parents:
diff changeset
34 ------------------------------------------------------------------------------
kono
parents:
diff changeset
35
kono
parents:
diff changeset
36 with Ada.Strings.Maps;
kono
parents:
diff changeset
37 with Ada.Finalization;
kono
parents:
diff changeset
38
kono
parents:
diff changeset
39 package Ada.Strings.Unbounded is
kono
parents:
diff changeset
40 pragma Preelaborate;
kono
parents:
diff changeset
41
kono
parents:
diff changeset
42 type Unbounded_String is private;
kono
parents:
diff changeset
43 pragma Preelaborable_Initialization (Unbounded_String);
kono
parents:
diff changeset
44
kono
parents:
diff changeset
45 Null_Unbounded_String : constant Unbounded_String;
kono
parents:
diff changeset
46
kono
parents:
diff changeset
47 function Length (Source : Unbounded_String) return Natural;
kono
parents:
diff changeset
48
kono
parents:
diff changeset
49 type String_Access is access all String;
kono
parents:
diff changeset
50
kono
parents:
diff changeset
51 procedure Free (X : in out String_Access);
kono
parents:
diff changeset
52
kono
parents:
diff changeset
53 --------------------------------------------------------
kono
parents:
diff changeset
54 -- Conversion, Concatenation, and Selection Functions --
kono
parents:
diff changeset
55 --------------------------------------------------------
kono
parents:
diff changeset
56
kono
parents:
diff changeset
57 function To_Unbounded_String
kono
parents:
diff changeset
58 (Source : String) return Unbounded_String;
kono
parents:
diff changeset
59
kono
parents:
diff changeset
60 function To_Unbounded_String
kono
parents:
diff changeset
61 (Length : Natural) return Unbounded_String;
kono
parents:
diff changeset
62
kono
parents:
diff changeset
63 function To_String (Source : Unbounded_String) return String;
kono
parents:
diff changeset
64
kono
parents:
diff changeset
65 procedure Set_Unbounded_String
kono
parents:
diff changeset
66 (Target : out Unbounded_String;
kono
parents:
diff changeset
67 Source : String);
kono
parents:
diff changeset
68 pragma Ada_05 (Set_Unbounded_String);
kono
parents:
diff changeset
69
kono
parents:
diff changeset
70 procedure Append
kono
parents:
diff changeset
71 (Source : in out Unbounded_String;
kono
parents:
diff changeset
72 New_Item : Unbounded_String);
kono
parents:
diff changeset
73
kono
parents:
diff changeset
74 procedure Append
kono
parents:
diff changeset
75 (Source : in out Unbounded_String;
kono
parents:
diff changeset
76 New_Item : String);
kono
parents:
diff changeset
77
kono
parents:
diff changeset
78 procedure Append
kono
parents:
diff changeset
79 (Source : in out Unbounded_String;
kono
parents:
diff changeset
80 New_Item : Character);
kono
parents:
diff changeset
81
kono
parents:
diff changeset
82 function "&"
kono
parents:
diff changeset
83 (Left : Unbounded_String;
kono
parents:
diff changeset
84 Right : Unbounded_String) return Unbounded_String;
kono
parents:
diff changeset
85
kono
parents:
diff changeset
86 function "&"
kono
parents:
diff changeset
87 (Left : Unbounded_String;
kono
parents:
diff changeset
88 Right : String) return Unbounded_String;
kono
parents:
diff changeset
89
kono
parents:
diff changeset
90 function "&"
kono
parents:
diff changeset
91 (Left : String;
kono
parents:
diff changeset
92 Right : Unbounded_String) return Unbounded_String;
kono
parents:
diff changeset
93
kono
parents:
diff changeset
94 function "&"
kono
parents:
diff changeset
95 (Left : Unbounded_String;
kono
parents:
diff changeset
96 Right : Character) return Unbounded_String;
kono
parents:
diff changeset
97
kono
parents:
diff changeset
98 function "&"
kono
parents:
diff changeset
99 (Left : Character;
kono
parents:
diff changeset
100 Right : Unbounded_String) return Unbounded_String;
kono
parents:
diff changeset
101
kono
parents:
diff changeset
102 function Element
kono
parents:
diff changeset
103 (Source : Unbounded_String;
kono
parents:
diff changeset
104 Index : Positive) return Character;
kono
parents:
diff changeset
105
kono
parents:
diff changeset
106 procedure Replace_Element
kono
parents:
diff changeset
107 (Source : in out Unbounded_String;
kono
parents:
diff changeset
108 Index : Positive;
kono
parents:
diff changeset
109 By : Character);
kono
parents:
diff changeset
110
kono
parents:
diff changeset
111 function Slice
kono
parents:
diff changeset
112 (Source : Unbounded_String;
kono
parents:
diff changeset
113 Low : Positive;
kono
parents:
diff changeset
114 High : Natural) return String;
kono
parents:
diff changeset
115
kono
parents:
diff changeset
116 function Unbounded_Slice
kono
parents:
diff changeset
117 (Source : Unbounded_String;
kono
parents:
diff changeset
118 Low : Positive;
kono
parents:
diff changeset
119 High : Natural) return Unbounded_String;
kono
parents:
diff changeset
120 pragma Ada_05 (Unbounded_Slice);
kono
parents:
diff changeset
121
kono
parents:
diff changeset
122 procedure Unbounded_Slice
kono
parents:
diff changeset
123 (Source : Unbounded_String;
kono
parents:
diff changeset
124 Target : out Unbounded_String;
kono
parents:
diff changeset
125 Low : Positive;
kono
parents:
diff changeset
126 High : Natural);
kono
parents:
diff changeset
127 pragma Ada_05 (Unbounded_Slice);
kono
parents:
diff changeset
128
kono
parents:
diff changeset
129 function "="
kono
parents:
diff changeset
130 (Left : Unbounded_String;
kono
parents:
diff changeset
131 Right : Unbounded_String) return Boolean;
kono
parents:
diff changeset
132
kono
parents:
diff changeset
133 function "="
kono
parents:
diff changeset
134 (Left : Unbounded_String;
kono
parents:
diff changeset
135 Right : String) return Boolean;
kono
parents:
diff changeset
136
kono
parents:
diff changeset
137 function "="
kono
parents:
diff changeset
138 (Left : String;
kono
parents:
diff changeset
139 Right : Unbounded_String) return Boolean;
kono
parents:
diff changeset
140
kono
parents:
diff changeset
141 function "<"
kono
parents:
diff changeset
142 (Left : Unbounded_String;
kono
parents:
diff changeset
143 Right : Unbounded_String) return Boolean;
kono
parents:
diff changeset
144
kono
parents:
diff changeset
145 function "<"
kono
parents:
diff changeset
146 (Left : Unbounded_String;
kono
parents:
diff changeset
147 Right : String) return Boolean;
kono
parents:
diff changeset
148
kono
parents:
diff changeset
149 function "<"
kono
parents:
diff changeset
150 (Left : String;
kono
parents:
diff changeset
151 Right : Unbounded_String) return Boolean;
kono
parents:
diff changeset
152
kono
parents:
diff changeset
153 function "<="
kono
parents:
diff changeset
154 (Left : Unbounded_String;
kono
parents:
diff changeset
155 Right : Unbounded_String) return Boolean;
kono
parents:
diff changeset
156
kono
parents:
diff changeset
157 function "<="
kono
parents:
diff changeset
158 (Left : Unbounded_String;
kono
parents:
diff changeset
159 Right : String) return Boolean;
kono
parents:
diff changeset
160
kono
parents:
diff changeset
161 function "<="
kono
parents:
diff changeset
162 (Left : String;
kono
parents:
diff changeset
163 Right : Unbounded_String) return Boolean;
kono
parents:
diff changeset
164
kono
parents:
diff changeset
165 function ">"
kono
parents:
diff changeset
166 (Left : Unbounded_String;
kono
parents:
diff changeset
167 Right : Unbounded_String) return Boolean;
kono
parents:
diff changeset
168
kono
parents:
diff changeset
169 function ">"
kono
parents:
diff changeset
170 (Left : Unbounded_String;
kono
parents:
diff changeset
171 Right : String) return Boolean;
kono
parents:
diff changeset
172
kono
parents:
diff changeset
173 function ">"
kono
parents:
diff changeset
174 (Left : String;
kono
parents:
diff changeset
175 Right : Unbounded_String) return Boolean;
kono
parents:
diff changeset
176
kono
parents:
diff changeset
177 function ">="
kono
parents:
diff changeset
178 (Left : Unbounded_String;
kono
parents:
diff changeset
179 Right : Unbounded_String) return Boolean;
kono
parents:
diff changeset
180
kono
parents:
diff changeset
181 function ">="
kono
parents:
diff changeset
182 (Left : Unbounded_String;
kono
parents:
diff changeset
183 Right : String) return Boolean;
kono
parents:
diff changeset
184
kono
parents:
diff changeset
185 function ">="
kono
parents:
diff changeset
186 (Left : String;
kono
parents:
diff changeset
187 Right : Unbounded_String) return Boolean;
kono
parents:
diff changeset
188
kono
parents:
diff changeset
189 ------------------------
kono
parents:
diff changeset
190 -- Search Subprograms --
kono
parents:
diff changeset
191 ------------------------
kono
parents:
diff changeset
192
kono
parents:
diff changeset
193 function Index
kono
parents:
diff changeset
194 (Source : Unbounded_String;
kono
parents:
diff changeset
195 Pattern : String;
kono
parents:
diff changeset
196 Going : Direction := Forward;
kono
parents:
diff changeset
197 Mapping : Maps.Character_Mapping := Maps.Identity) return Natural;
kono
parents:
diff changeset
198
kono
parents:
diff changeset
199 function Index
kono
parents:
diff changeset
200 (Source : Unbounded_String;
kono
parents:
diff changeset
201 Pattern : String;
kono
parents:
diff changeset
202 Going : Direction := Forward;
kono
parents:
diff changeset
203 Mapping : Maps.Character_Mapping_Function) return Natural;
kono
parents:
diff changeset
204
kono
parents:
diff changeset
205 function Index
kono
parents:
diff changeset
206 (Source : Unbounded_String;
kono
parents:
diff changeset
207 Set : Maps.Character_Set;
kono
parents:
diff changeset
208 Test : Membership := Inside;
kono
parents:
diff changeset
209 Going : Direction := Forward) return Natural;
kono
parents:
diff changeset
210
kono
parents:
diff changeset
211 function Index
kono
parents:
diff changeset
212 (Source : Unbounded_String;
kono
parents:
diff changeset
213 Pattern : String;
kono
parents:
diff changeset
214 From : Positive;
kono
parents:
diff changeset
215 Going : Direction := Forward;
kono
parents:
diff changeset
216 Mapping : Maps.Character_Mapping := Maps.Identity) return Natural;
kono
parents:
diff changeset
217 pragma Ada_05 (Index);
kono
parents:
diff changeset
218
kono
parents:
diff changeset
219 function Index
kono
parents:
diff changeset
220 (Source : Unbounded_String;
kono
parents:
diff changeset
221 Pattern : String;
kono
parents:
diff changeset
222 From : Positive;
kono
parents:
diff changeset
223 Going : Direction := Forward;
kono
parents:
diff changeset
224 Mapping : Maps.Character_Mapping_Function) return Natural;
kono
parents:
diff changeset
225 pragma Ada_05 (Index);
kono
parents:
diff changeset
226
kono
parents:
diff changeset
227 function Index
kono
parents:
diff changeset
228 (Source : Unbounded_String;
kono
parents:
diff changeset
229 Set : Maps.Character_Set;
kono
parents:
diff changeset
230 From : Positive;
kono
parents:
diff changeset
231 Test : Membership := Inside;
kono
parents:
diff changeset
232 Going : Direction := Forward) return Natural;
kono
parents:
diff changeset
233 pragma Ada_05 (Index);
kono
parents:
diff changeset
234
kono
parents:
diff changeset
235 function Index_Non_Blank
kono
parents:
diff changeset
236 (Source : Unbounded_String;
kono
parents:
diff changeset
237 Going : Direction := Forward) return Natural;
kono
parents:
diff changeset
238
kono
parents:
diff changeset
239 function Index_Non_Blank
kono
parents:
diff changeset
240 (Source : Unbounded_String;
kono
parents:
diff changeset
241 From : Positive;
kono
parents:
diff changeset
242 Going : Direction := Forward) return Natural;
kono
parents:
diff changeset
243 pragma Ada_05 (Index_Non_Blank);
kono
parents:
diff changeset
244
kono
parents:
diff changeset
245 function Count
kono
parents:
diff changeset
246 (Source : Unbounded_String;
kono
parents:
diff changeset
247 Pattern : String;
kono
parents:
diff changeset
248 Mapping : Maps.Character_Mapping := Maps.Identity) return Natural;
kono
parents:
diff changeset
249
kono
parents:
diff changeset
250 function Count
kono
parents:
diff changeset
251 (Source : Unbounded_String;
kono
parents:
diff changeset
252 Pattern : String;
kono
parents:
diff changeset
253 Mapping : Maps.Character_Mapping_Function) return Natural;
kono
parents:
diff changeset
254
kono
parents:
diff changeset
255 function Count
kono
parents:
diff changeset
256 (Source : Unbounded_String;
kono
parents:
diff changeset
257 Set : Maps.Character_Set) return Natural;
kono
parents:
diff changeset
258
kono
parents:
diff changeset
259 procedure Find_Token
kono
parents:
diff changeset
260 (Source : Unbounded_String;
kono
parents:
diff changeset
261 Set : Maps.Character_Set;
kono
parents:
diff changeset
262 From : Positive;
kono
parents:
diff changeset
263 Test : Membership;
kono
parents:
diff changeset
264 First : out Positive;
kono
parents:
diff changeset
265 Last : out Natural);
kono
parents:
diff changeset
266 pragma Ada_2012 (Find_Token);
kono
parents:
diff changeset
267
kono
parents:
diff changeset
268 procedure Find_Token
kono
parents:
diff changeset
269 (Source : Unbounded_String;
kono
parents:
diff changeset
270 Set : Maps.Character_Set;
kono
parents:
diff changeset
271 Test : Membership;
kono
parents:
diff changeset
272 First : out Positive;
kono
parents:
diff changeset
273 Last : out Natural);
kono
parents:
diff changeset
274
kono
parents:
diff changeset
275 ------------------------------------
kono
parents:
diff changeset
276 -- String Translation Subprograms --
kono
parents:
diff changeset
277 ------------------------------------
kono
parents:
diff changeset
278
kono
parents:
diff changeset
279 function Translate
kono
parents:
diff changeset
280 (Source : Unbounded_String;
kono
parents:
diff changeset
281 Mapping : Maps.Character_Mapping) return Unbounded_String;
kono
parents:
diff changeset
282
kono
parents:
diff changeset
283 procedure Translate
kono
parents:
diff changeset
284 (Source : in out Unbounded_String;
kono
parents:
diff changeset
285 Mapping : Maps.Character_Mapping);
kono
parents:
diff changeset
286
kono
parents:
diff changeset
287 function Translate
kono
parents:
diff changeset
288 (Source : Unbounded_String;
kono
parents:
diff changeset
289 Mapping : Maps.Character_Mapping_Function) return Unbounded_String;
kono
parents:
diff changeset
290
kono
parents:
diff changeset
291 procedure Translate
kono
parents:
diff changeset
292 (Source : in out Unbounded_String;
kono
parents:
diff changeset
293 Mapping : Maps.Character_Mapping_Function);
kono
parents:
diff changeset
294
kono
parents:
diff changeset
295 ---------------------------------------
kono
parents:
diff changeset
296 -- String Transformation Subprograms --
kono
parents:
diff changeset
297 ---------------------------------------
kono
parents:
diff changeset
298
kono
parents:
diff changeset
299 function Replace_Slice
kono
parents:
diff changeset
300 (Source : Unbounded_String;
kono
parents:
diff changeset
301 Low : Positive;
kono
parents:
diff changeset
302 High : Natural;
kono
parents:
diff changeset
303 By : String) return Unbounded_String;
kono
parents:
diff changeset
304
kono
parents:
diff changeset
305 procedure Replace_Slice
kono
parents:
diff changeset
306 (Source : in out Unbounded_String;
kono
parents:
diff changeset
307 Low : Positive;
kono
parents:
diff changeset
308 High : Natural;
kono
parents:
diff changeset
309 By : String);
kono
parents:
diff changeset
310
kono
parents:
diff changeset
311 function Insert
kono
parents:
diff changeset
312 (Source : Unbounded_String;
kono
parents:
diff changeset
313 Before : Positive;
kono
parents:
diff changeset
314 New_Item : String) return Unbounded_String;
kono
parents:
diff changeset
315
kono
parents:
diff changeset
316 procedure Insert
kono
parents:
diff changeset
317 (Source : in out Unbounded_String;
kono
parents:
diff changeset
318 Before : Positive;
kono
parents:
diff changeset
319 New_Item : String);
kono
parents:
diff changeset
320
kono
parents:
diff changeset
321 function Overwrite
kono
parents:
diff changeset
322 (Source : Unbounded_String;
kono
parents:
diff changeset
323 Position : Positive;
kono
parents:
diff changeset
324 New_Item : String) return Unbounded_String;
kono
parents:
diff changeset
325
kono
parents:
diff changeset
326 procedure Overwrite
kono
parents:
diff changeset
327 (Source : in out Unbounded_String;
kono
parents:
diff changeset
328 Position : Positive;
kono
parents:
diff changeset
329 New_Item : String);
kono
parents:
diff changeset
330
kono
parents:
diff changeset
331 function Delete
kono
parents:
diff changeset
332 (Source : Unbounded_String;
kono
parents:
diff changeset
333 From : Positive;
kono
parents:
diff changeset
334 Through : Natural) return Unbounded_String;
kono
parents:
diff changeset
335
kono
parents:
diff changeset
336 procedure Delete
kono
parents:
diff changeset
337 (Source : in out Unbounded_String;
kono
parents:
diff changeset
338 From : Positive;
kono
parents:
diff changeset
339 Through : Natural);
kono
parents:
diff changeset
340
kono
parents:
diff changeset
341 function Trim
kono
parents:
diff changeset
342 (Source : Unbounded_String;
kono
parents:
diff changeset
343 Side : Trim_End) return Unbounded_String;
kono
parents:
diff changeset
344
kono
parents:
diff changeset
345 procedure Trim
kono
parents:
diff changeset
346 (Source : in out Unbounded_String;
kono
parents:
diff changeset
347 Side : Trim_End);
kono
parents:
diff changeset
348
kono
parents:
diff changeset
349 function Trim
kono
parents:
diff changeset
350 (Source : Unbounded_String;
kono
parents:
diff changeset
351 Left : Maps.Character_Set;
kono
parents:
diff changeset
352 Right : Maps.Character_Set) return Unbounded_String;
kono
parents:
diff changeset
353
kono
parents:
diff changeset
354 procedure Trim
kono
parents:
diff changeset
355 (Source : in out Unbounded_String;
kono
parents:
diff changeset
356 Left : Maps.Character_Set;
kono
parents:
diff changeset
357 Right : Maps.Character_Set);
kono
parents:
diff changeset
358
kono
parents:
diff changeset
359 function Head
kono
parents:
diff changeset
360 (Source : Unbounded_String;
kono
parents:
diff changeset
361 Count : Natural;
kono
parents:
diff changeset
362 Pad : Character := Space) return Unbounded_String;
kono
parents:
diff changeset
363
kono
parents:
diff changeset
364 procedure Head
kono
parents:
diff changeset
365 (Source : in out Unbounded_String;
kono
parents:
diff changeset
366 Count : Natural;
kono
parents:
diff changeset
367 Pad : Character := Space);
kono
parents:
diff changeset
368
kono
parents:
diff changeset
369 function Tail
kono
parents:
diff changeset
370 (Source : Unbounded_String;
kono
parents:
diff changeset
371 Count : Natural;
kono
parents:
diff changeset
372 Pad : Character := Space) return Unbounded_String;
kono
parents:
diff changeset
373
kono
parents:
diff changeset
374 procedure Tail
kono
parents:
diff changeset
375 (Source : in out Unbounded_String;
kono
parents:
diff changeset
376 Count : Natural;
kono
parents:
diff changeset
377 Pad : Character := Space);
kono
parents:
diff changeset
378
kono
parents:
diff changeset
379 function "*"
kono
parents:
diff changeset
380 (Left : Natural;
kono
parents:
diff changeset
381 Right : Character) return Unbounded_String;
kono
parents:
diff changeset
382
kono
parents:
diff changeset
383 function "*"
kono
parents:
diff changeset
384 (Left : Natural;
kono
parents:
diff changeset
385 Right : String) return Unbounded_String;
kono
parents:
diff changeset
386
kono
parents:
diff changeset
387 function "*"
kono
parents:
diff changeset
388 (Left : Natural;
kono
parents:
diff changeset
389 Right : Unbounded_String) return Unbounded_String;
kono
parents:
diff changeset
390
kono
parents:
diff changeset
391 private
kono
parents:
diff changeset
392 pragma Inline (Length);
kono
parents:
diff changeset
393
kono
parents:
diff changeset
394 package AF renames Ada.Finalization;
kono
parents:
diff changeset
395
kono
parents:
diff changeset
396 Null_String : aliased String := "";
kono
parents:
diff changeset
397
kono
parents:
diff changeset
398 function To_Unbounded (S : String) return Unbounded_String
kono
parents:
diff changeset
399 renames To_Unbounded_String;
kono
parents:
diff changeset
400
kono
parents:
diff changeset
401 type Unbounded_String is new AF.Controlled with record
kono
parents:
diff changeset
402 Reference : String_Access := Null_String'Access;
kono
parents:
diff changeset
403 Last : Natural := 0;
kono
parents:
diff changeset
404 end record;
kono
parents:
diff changeset
405 -- The Unbounded_String is using a buffered implementation to increase
kono
parents:
diff changeset
406 -- speed of the Append/Delete/Insert procedures. The Reference string
kono
parents:
diff changeset
407 -- pointer above contains the current string value and extra room at the
kono
parents:
diff changeset
408 -- end to be used by the next Append routine. Last is the index of the
kono
parents:
diff changeset
409 -- string ending character. So the current string value is really
kono
parents:
diff changeset
410 -- Reference (1 .. Last).
kono
parents:
diff changeset
411
kono
parents:
diff changeset
412 pragma Stream_Convert (Unbounded_String, To_Unbounded, To_String);
kono
parents:
diff changeset
413 -- Provide stream routines without dragging in Ada.Streams
kono
parents:
diff changeset
414
kono
parents:
diff changeset
415 pragma Finalize_Storage_Only (Unbounded_String);
kono
parents:
diff changeset
416 -- Finalization is required only for freeing storage
kono
parents:
diff changeset
417
kono
parents:
diff changeset
418 procedure Initialize (Object : in out Unbounded_String);
kono
parents:
diff changeset
419 procedure Adjust (Object : in out Unbounded_String);
kono
parents:
diff changeset
420 procedure Finalize (Object : in out Unbounded_String);
kono
parents:
diff changeset
421
kono
parents:
diff changeset
422 procedure Realloc_For_Chunk
kono
parents:
diff changeset
423 (Source : in out Unbounded_String;
kono
parents:
diff changeset
424 Chunk_Size : Natural);
kono
parents:
diff changeset
425 pragma Inline (Realloc_For_Chunk);
kono
parents:
diff changeset
426 -- Adjust the size allocated for the string. Add at least Chunk_Size so it
kono
parents:
diff changeset
427 -- is safe to add a string of this size at the end of the current content.
kono
parents:
diff changeset
428 -- The real size allocated for the string is Chunk_Size + x of the current
kono
parents:
diff changeset
429 -- string size. This buffered handling makes the Append unbounded string
kono
parents:
diff changeset
430 -- routines very fast. This spec is in the private part so that it can be
kono
parents:
diff changeset
431 -- accessed from children (e.g. from Unbounded.Text_IO).
kono
parents:
diff changeset
432
kono
parents:
diff changeset
433 Null_Unbounded_String : constant Unbounded_String :=
kono
parents:
diff changeset
434 (AF.Controlled with
kono
parents:
diff changeset
435 Reference => Null_String'Access,
kono
parents:
diff changeset
436 Last => 0);
kono
parents:
diff changeset
437 end Ada.Strings.Unbounded;