File : a-strsea.ads


     ------------------------------------------------------------------------------
     --                                                                          --
     --                         GNAT RUN-TIME COMPONENTS                         --
     --                                                                          --
   5 --                   A D A . S T R I N G S . S E A R C H                    --
     --                                                                          --
     --                                 S p e c                                  --
     --                                                                          --
     --                            $Revision: 1.10 $                             --
  10 --                                                                          --
     --          Copyright (C) 1992-1997 Free Software Foundation, Inc.          --
     --                                                                          --
     --                                                                          --
     -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  15 -- 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- --
     -- 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 --
  20 -- 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.                                                      --
     --                                                                          --
  25 -- 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 --
  30 -- covered by the  GNU Public License.                                      --
     --                                                                          --
     -- GNAT was originally developed  by the GNAT team at  New York University. --
     -- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
     --                                                                          --
  35 ------------------------------------------------------------------------------
     
     --  This package contains the search functions from Ada.Strings.Fixed. They
     --  are separated out because they are shared by Ada.Strings.Bounded and
     --  Ada.Strings.Unbounded, and we don't want to drag other irrelevant stuff
  40 --  from Ada.Strings.Fixed when using the other two packages. We make this
     --  a private package, since user programs should access these subprograms
     --  via one of the standard string packages.
     
     with Ada.Strings.Maps;
  45 
     private package Ada.Strings.Search is
     pragma Preelaborate (Search);
     
        function Index
  50      (Source   : in String;
           Pattern  : in String;
           Going    : in Direction := Forward;
           Mapping  : in Maps.Character_Mapping := Maps.Identity)
           return     Natural;
  55 
        function Index
          (Source   : in String;
           Pattern  : in String;
           Going    : in Direction := Forward;
  60       Mapping  : in Maps.Character_Mapping_Function)
           return     Natural;
     
        function Index
          (Source : in String;
  65       Set    : in Maps.Character_Set;
           Test   : in Membership := Inside;
           Going  : in Direction  := Forward)
           return   Natural;
     
  70    function Index_Non_Blank
          (Source : in String;
           Going  : in Direction := Forward)
           return   Natural;
     
  75    function Count
          (Source   : in String;
           Pattern  : in String;
           Mapping  : in Maps.Character_Mapping := Maps.Identity)
           return     Natural;
  80 
        function Count
          (Source   : in String;
           Pattern  : in String;
           Mapping  : in Maps.Character_Mapping_Function)
  85       return     Natural;
     
        function Count
          (Source   : in String;
           Set      : in Maps.Character_Set)
  90       return     Natural;
     
     
        procedure Find_Token
          (Source : in String;
  95       Set    : in Maps.Character_Set;
           Test   : in Membership;
           First  : out Positive;
           Last   : out Natural);
     
 100 end Ada.Strings.Search;