OSDN Git Service

2006-10-31 Robert Dewar <dewar@adacore.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / a-strsea.ads
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                         GNAT RUN-TIME COMPONENTS                         --
4 --                                                                          --
5 --                   A D A . S T R I N G S . S E A R C H                    --
6 --                                                                          --
7 --                                 S p e c                                  --
8 --                                                                          --
9 --          Copyright (C) 1992-2005, Free Software Foundation, Inc.         --
10 --                                                                          --
11 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
12 -- terms of the  GNU General Public License as published  by the Free Soft- --
13 -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
14 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
17 -- for  more details.  You should have  received  a copy of the GNU General --
18 -- Public License  distributed with GNAT;  see file COPYING.  If not, write --
19 -- to  the  Free Software Foundation,  51  Franklin  Street,  Fifth  Floor, --
20 -- Boston, MA 02110-1301, USA.                                              --
21 --                                                                          --
22 -- As a special exception,  if other files  instantiate  generics from this --
23 -- unit, or you link  this unit with other files  to produce an executable, --
24 -- this  unit  does not  by itself cause  the resulting  executable  to  be --
25 -- covered  by the  GNU  General  Public  License.  This exception does not --
26 -- however invalidate  any other reasons why  the executable file  might be --
27 -- covered by the  GNU Public License.                                      --
28 --                                                                          --
29 -- GNAT was originally developed  by the GNAT team at  New York University. --
30 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
31 --                                                                          --
32 ------------------------------------------------------------------------------
33
34 --  This package contains the search functions from Ada.Strings.Fixed. They
35 --  are separated out because they are shared by Ada.Strings.Bounded and
36 --  Ada.Strings.Unbounded, and we don't want to drag other irrelevant stuff
37 --  from Ada.Strings.Fixed when using the other two packages. We make this
38 --  a private package, since user programs should access these subprograms
39 --  via one of the standard string packages.
40
41 with Ada.Strings.Maps;
42
43 private package Ada.Strings.Search is
44    pragma Preelaborate;
45
46    function Index
47      (Source  : String;
48       Pattern : String;
49       Going   : Direction := Forward;
50       Mapping : Maps.Character_Mapping := Maps.Identity) return Natural;
51
52    function Index
53      (Source  : String;
54       Pattern : String;
55       Going   : Direction := Forward;
56       Mapping : Maps.Character_Mapping_Function) return Natural;
57
58    function Index
59      (Source : String;
60       Set    : Maps.Character_Set;
61       Test   : Membership := Inside;
62       Going  : Direction  := Forward) return Natural;
63
64    function Index
65      (Source  : String;
66       Pattern : String;
67       From    : Positive;
68       Going   : Direction := Forward;
69       Mapping : Maps.Character_Mapping := Maps.Identity) return Natural;
70
71    function Index
72      (Source  : String;
73       Pattern : String;
74       From    : Positive;
75       Going   : Direction := Forward;
76       Mapping : Maps.Character_Mapping_Function) return Natural;
77
78    function Index
79      (Source  : String;
80       Set     : Maps.Character_Set;
81       From    : Positive;
82       Test    : Membership := Inside;
83       Going   : Direction := Forward) return Natural;
84
85    function Index_Non_Blank
86      (Source : String;
87       Going  : Direction := Forward) return Natural;
88
89    function Index_Non_Blank
90      (Source : String;
91       From   : Positive;
92       Going  : Direction := Forward) return Natural;
93
94    function Count
95      (Source  : String;
96       Pattern : String;
97       Mapping : Maps.Character_Mapping := Maps.Identity) return Natural;
98
99    function Count
100      (Source  : String;
101       Pattern : String;
102       Mapping : Maps.Character_Mapping_Function) return Natural;
103
104    function Count
105      (Source : String;
106       Set    : Maps.Character_Set) return Natural;
107
108    procedure Find_Token
109      (Source : String;
110       Set    : Maps.Character_Set;
111       Test   : Membership;
112       First  : out Positive;
113       Last   : out Natural);
114
115 end Ada.Strings.Search;