File : g-casuti.ads


     ------------------------------------------------------------------------------
     --                                                                          --
     --                         GNAT RUNTIME COMPONENTS                          --
     --                                                                          --
   5 --                       G N A T . C A S E _ U T I L                        --
     --                                                                          --
     --                                 S p e c                                  --
     --                                                                          --
     --                            $Revision: 1.3 $                              --
  10 --                                                                          --
     --           Copyright (C) 1995-1998 Ada Core Technologies, 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- --
  15 -- 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 --
     -- for  more details.  You should have  received  a copy of the GNU General --
  20 -- 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.                                                      --
     --                                                                          --
     -- As a special exception,  if other files  instantiate  generics from this --
  25 -- 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.                                      --
  30 --                                                                          --
     -- GNAT is maintained by Ada Core Technologies Inc (http://www.gnat.com).   --
     --                                                                          --
     ------------------------------------------------------------------------------
     
  35 --  Simple casing functions
     
     --  This package provides simple casing functions that do not require the
     --  overhead of the full casing tables found in Ada.Characters.Handling.
     
  40 package GNAT.Case_Util is
     pragma Pure (Case_Util);
     
        --  Note: all the following functions handle the full Latin-1 set
     
  45    function To_Upper (A : Character) return Character;
        --  Converts A to upper case if it is a lower case letter, otherwise
        --  returns the input argument unchanged.
     
        procedure To_Upper (A : in out String);
  50    --  Folds all characters of string A to upper csae
     
        function To_Lower (A : Character) return Character;
        --  Converts A to lower case if it is an upper case letter, otherwise
        --  returns the input argument unchanged.
  55 
        procedure To_Lower (A : in out String);
        --  Folds all characters of string A to lower case
     
        procedure To_Mixed (A : in out String);
  60    --  Converts A to mixed case (i.e. lower case, except for initial
        --  character and any character after an underscore, which are
        --  converted to upper case.
     
     end GNAT.Case_Util;