-- --
-- S p e c --
-- --
--- Copyright (C) 2003 Free Software Foundation, Inc. --
+-- Copyright (C) 2003-2009, Free Software Foundation, Inc. --
-- --
-- GNAT is free software; you can redistribute it and/or modify it under --
-- terms of the GNU General Public License as published by the Free Soft- --
--- ware Foundation; either version 2, or (at your option) any later ver- --
+-- ware Foundation; either version 3, or (at your option) any later ver- --
-- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
-- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
--- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
--- for more details. You should have received a copy of the GNU General --
--- Public License distributed with GNAT; see file COPYING. If not, write --
--- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
--- MA 02111-1307, USA. --
+-- or FITNESS FOR A PARTICULAR PURPOSE. --
-- --
--- As a special exception, if other files instantiate generics from this --
--- unit, or you link this unit with other files to produce an executable, --
--- this unit does not by itself cause the resulting executable to be --
--- covered by the GNU General Public License. This exception does not --
--- however invalidate any other reasons why the executable file might be --
--- covered by the GNU Public License. --
+-- As a special exception under Section 7 of GPL version 3, you are granted --
+-- additional permissions described in the GCC Runtime Library Exception, --
+-- version 3.1, as published by the Free Software Foundation. --
+-- --
+-- You should have received a copy of the GNU General Public License and --
+-- a copy of the GCC Runtime Library Exception along with this program; --
+-- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
+-- <http://www.gnu.org/licenses/>. --
-- --
-- GNAT was originally developed by the GNAT team at New York University. --
-- Extensive contributions were provided by Ada Core Technologies Inc. --
with Ada.Strings.Maps;
package Ada.Strings.Superbounded is
-pragma Preelaborate (Superbounded);
+ pragma Preelaborate;
type Super_String (Max_Length : Positive) is record
Current_Length : Natural := 0;
function To_Super_String
(Source : String;
Max_Length : Natural;
- Drop : Truncation := Error)
- return Super_String;
+ Drop : Truncation := Error) return Super_String;
-- Note the additional parameter Max_Length, which specifies the maximum
-- length setting of the resulting Super_String value.
function Super_To_String (Source : Super_String) return String;
+ procedure Set_Super_String
+ (Target : out Super_String;
+ Source : String;
+ Drop : Truncation := Error);
+
function Super_Append
- (Left, Right : Super_String;
- Drop : Truncation := Error)
- return Super_String;
+ (Left : Super_String;
+ Right : Super_String;
+ Drop : Truncation := Error) return Super_String;
function Super_Append
(Left : Super_String;
Right : String;
- Drop : Truncation := Error)
- return Super_String;
+ Drop : Truncation := Error) return Super_String;
function Super_Append
(Left : String;
Right : Super_String;
- Drop : Truncation := Error)
- return Super_String;
+ Drop : Truncation := Error) return Super_String;
function Super_Append
(Left : Super_String;
Right : Character;
- Drop : Truncation := Error)
- return Super_String;
+ Drop : Truncation := Error) return Super_String;
function Super_Append
(Left : Character;
Right : Super_String;
- Drop : Truncation := Error)
- return Super_String;
+ Drop : Truncation := Error) return Super_String;
procedure Super_Append
(Source : in out Super_String;
Drop : Truncation := Error);
function Concat
- (Left, Right : Super_String)
- return Super_String;
+ (Left : Super_String;
+ Right : Super_String) return Super_String;
function Concat
(Left : Super_String;
- Right : String)
- return Super_String;
+ Right : String) return Super_String;
function Concat
(Left : String;
- Right : Super_String)
- return Super_String;
+ Right : Super_String) return Super_String;
function Concat
(Left : Super_String;
- Right : Character)
- return Super_String;
+ Right : Character) return Super_String;
function Concat
(Left : Character;
- Right : Super_String)
- return Super_String;
+ Right : Super_String) return Super_String;
function Super_Element
(Source : Super_String;
- Index : Positive)
- return Character;
+ Index : Positive) return Character;
procedure Super_Replace_Element
(Source : in out Super_String;
function Super_Slice
(Source : Super_String;
Low : Positive;
- High : Natural)
- return String;
+ High : Natural) return String;
+
+ function Super_Slice
+ (Source : Super_String;
+ Low : Positive;
+ High : Natural) return Super_String;
+
+ procedure Super_Slice
+ (Source : Super_String;
+ Target : out Super_String;
+ Low : Positive;
+ High : Natural);
- function "=" (Left, Right : Super_String) return Boolean;
+ function "="
+ (Left : Super_String;
+ Right : Super_String) return Boolean;
- function Equal (Left, Right : Super_String) return Boolean renames "=";
+ function Equal
+ (Left : Super_String;
+ Right : Super_String) return Boolean renames "=";
function Equal
(Left : Super_String;
- Right : String)
- return Boolean;
+ Right : String) return Boolean;
function Equal
(Left : String;
- Right : Super_String)
- return Boolean;
+ Right : Super_String) return Boolean;
- function Less (Left, Right : Super_String) return Boolean;
+ function Less
+ (Left : Super_String;
+ Right : Super_String) return Boolean;
function Less
(Left : Super_String;
- Right : String)
- return Boolean;
+ Right : String) return Boolean;
function Less
(Left : String;
- Right : Super_String)
- return Boolean;
+ Right : Super_String) return Boolean;
- function Less_Or_Equal (Left, Right : Super_String) return Boolean;
+ function Less_Or_Equal
+ (Left : Super_String;
+ Right : Super_String) return Boolean;
function Less_Or_Equal
(Left : Super_String;
- Right : String)
- return Boolean;
+ Right : String) return Boolean;
function Less_Or_Equal
(Left : String;
- Right : Super_String)
- return Boolean;
+ Right : Super_String) return Boolean;
- function Greater (Left, Right : Super_String) return Boolean;
+ function Greater
+ (Left : Super_String;
+ Right : Super_String) return Boolean;
function Greater
(Left : Super_String;
- Right : String)
- return Boolean;
+ Right : String) return Boolean;
function Greater
(Left : String;
- Right : Super_String)
- return Boolean;
+ Right : Super_String) return Boolean;
- function Greater_Or_Equal (Left, Right : Super_String) return Boolean;
+ function Greater_Or_Equal
+ (Left : Super_String;
+ Right : Super_String) return Boolean;
function Greater_Or_Equal
(Left : Super_String;
- Right : String)
- return Boolean;
+ Right : String) return Boolean;
function Greater_Or_Equal
(Left : String;
- Right : Super_String)
- return Boolean;
+ Right : Super_String) return Boolean;
----------------------
-- Search Functions --
(Source : Super_String;
Pattern : String;
Going : Direction := Forward;
- Mapping : Maps.Character_Mapping := Maps.Identity)
- return Natural;
+ Mapping : Maps.Character_Mapping := Maps.Identity) return Natural;
+
+ function Super_Index
+ (Source : Super_String;
+ Pattern : String;
+ Going : Direction := Forward;
+ Mapping : Maps.Character_Mapping_Function) return Natural;
+
+ function Super_Index
+ (Source : Super_String;
+ Set : Maps.Character_Set;
+ Test : Membership := Inside;
+ Going : Direction := Forward) return Natural;
+
+ function Super_Index
+ (Source : Super_String;
+ Pattern : String;
+ From : Positive;
+ Going : Direction := Forward;
+ Mapping : Maps.Character_Mapping := Maps.Identity) return Natural;
function Super_Index
(Source : Super_String;
Pattern : String;
+ From : Positive;
Going : Direction := Forward;
- Mapping : Maps.Character_Mapping_Function)
- return Natural;
+ Mapping : Maps.Character_Mapping_Function) return Natural;
function Super_Index
(Source : Super_String;
Set : Maps.Character_Set;
+ From : Positive;
Test : Membership := Inside;
- Going : Direction := Forward)
- return Natural;
+ Going : Direction := Forward) return Natural;
+
+ function Super_Index_Non_Blank
+ (Source : Super_String;
+ Going : Direction := Forward) return Natural;
function Super_Index_Non_Blank
(Source : Super_String;
- Going : Direction := Forward)
- return Natural;
+ From : Positive;
+ Going : Direction := Forward) return Natural;
function Super_Count
(Source : Super_String;
Pattern : String;
- Mapping : Maps.Character_Mapping := Maps.Identity)
- return Natural;
+ Mapping : Maps.Character_Mapping := Maps.Identity) return Natural;
function Super_Count
(Source : Super_String;
Pattern : String;
- Mapping : Maps.Character_Mapping_Function)
- return Natural;
+ Mapping : Maps.Character_Mapping_Function) return Natural;
function Super_Count
(Source : Super_String;
- Set : Maps.Character_Set)
- return Natural;
+ Set : Maps.Character_Set) return Natural;
procedure Super_Find_Token
(Source : Super_String;
------------------------------------
function Super_Translate
- (Source : Super_String;
- Mapping : Maps.Character_Mapping)
- return Super_String;
+ (Source : Super_String;
+ Mapping : Maps.Character_Mapping) return Super_String;
procedure Super_Translate
(Source : in out Super_String;
function Super_Translate
(Source : Super_String;
- Mapping : Maps.Character_Mapping_Function)
- return Super_String;
+ Mapping : Maps.Character_Mapping_Function) return Super_String;
procedure Super_Translate
(Source : in out Super_String;
---------------------------------------
function Super_Replace_Slice
- (Source : Super_String;
- Low : Positive;
- High : Natural;
- By : String;
- Drop : Truncation := Error)
- return Super_String;
+ (Source : Super_String;
+ Low : Positive;
+ High : Natural;
+ By : String;
+ Drop : Truncation := Error) return Super_String;
procedure Super_Replace_Slice
- (Source : in out Super_String;
- Low : Positive;
- High : Natural;
- By : String;
- Drop : Truncation := Error);
+ (Source : in out Super_String;
+ Low : Positive;
+ High : Natural;
+ By : String;
+ Drop : Truncation := Error);
function Super_Insert
(Source : Super_String;
Before : Positive;
New_Item : String;
- Drop : Truncation := Error)
- return Super_String;
+ Drop : Truncation := Error) return Super_String;
procedure Super_Insert
(Source : in out Super_String;
Drop : Truncation := Error);
function Super_Overwrite
- (Source : Super_String;
- Position : Positive;
- New_Item : String;
- Drop : Truncation := Error)
- return Super_String;
+ (Source : Super_String;
+ Position : Positive;
+ New_Item : String;
+ Drop : Truncation := Error) return Super_String;
procedure Super_Overwrite
(Source : in out Super_String;
function Super_Delete
(Source : Super_String;
From : Positive;
- Through : Natural)
- return Super_String;
+ Through : Natural) return Super_String;
procedure Super_Delete
(Source : in out Super_String;
function Super_Trim
(Source : Super_String;
- Side : Trim_End)
- return Super_String;
+ Side : Trim_End) return Super_String;
procedure Super_Trim
(Source : in out Super_String;
Side : Trim_End);
function Super_Trim
- (Source : Super_String;
+ (Source : Super_String;
Left : Maps.Character_Set;
- Right : Maps.Character_Set)
- return Super_String;
+ Right : Maps.Character_Set) return Super_String;
procedure Super_Trim
(Source : in out Super_String;
(Source : Super_String;
Count : Natural;
Pad : Character := Space;
- Drop : Truncation := Error)
- return Super_String;
+ Drop : Truncation := Error) return Super_String;
procedure Super_Head
(Source : in out Super_String;
Count : Natural;
- Pad : Character := Space;
+ Pad : Character := Space;
Drop : Truncation := Error);
function Super_Tail
(Source : Super_String;
Count : Natural;
- Pad : Character := Space;
- Drop : Truncation := Error)
- return Super_String;
+ Pad : Character := Space;
+ Drop : Truncation := Error) return Super_String;
procedure Super_Tail
(Source : in out Super_String;
Count : Natural;
- Pad : Character := Space;
+ Pad : Character := Space;
Drop : Truncation := Error);
------------------------------------
function Times
(Left : Natural;
Right : Character;
- Max_Length : Positive)
- return Super_String;
+ Max_Length : Positive) return Super_String;
-- Note the additional parameter Max_Length
function Times
(Left : Natural;
Right : String;
- Max_Length : Positive)
- return Super_String;
+ Max_Length : Positive) return Super_String;
-- Note the additional parameter Max_Length
function Times
(Left : Natural;
- Right : Super_String)
- return Super_String;
+ Right : Super_String) return Super_String;
function Super_Replicate
(Count : Natural;
Item : Character;
Drop : Truncation := Error;
- Max_Length : Positive)
- return Super_String;
+ Max_Length : Positive) return Super_String;
-- Note the additional parameter Max_Length
function Super_Replicate
(Count : Natural;
Item : String;
Drop : Truncation := Error;
- Max_Length : Positive)
- return Super_String;
+ Max_Length : Positive) return Super_String;
-- Note the additional parameter Max_Length
function Super_Replicate
(Count : Natural;
Item : Super_String;
- Drop : Truncation := Error)
- return Super_String;
+ Drop : Truncation := Error) return Super_String;
private
-
-- Pragma Inline declarations
pragma Inline ("=");