--  GHDL Run Time (GRT) - Misc subprograms for characters and strings
--  Copyright (C) 2016 Tristan Gingold
--
--  GHDL is free software; you can redistribute it and/or modify it under
--  the terms of the GNU General Public License as published by the Free
--  Software Foundation; either version 2, or (at your option) any later
--  version.
--
--  GHDL is distributed in the hope that it will be useful, but WITHOUT 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
--  along with GCC; see the 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
--  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.

package Grt.Strings is
   pragma Pure;

   NBSP : constant Character := Character'Val (160);

   --  Return True IFF C is a whitespace character (as defined in LRM93 14.3)
   function Is_Whitespace (C : in Character) return Boolean;

   -- The following functions return -1 in case there is no match in string ---

   -- Return the index of the first non whitespace character in string
   function First_Non_Whitespace_Pos (Str : String) return Integer;

   -- Return the index of the last non whitespace character in string
   function Last_Non_Whitespace_Pos (Str : String) return Integer;

   -- Return the index of the new line character (ASCII.LF) in string
   function New_Line_Pos (Line : String) return Integer;

   -- Return the index of the first character that matches Char in string
   function Find (Str : String; Char : Character) return Integer;
   function Find (Str : String; Char : Character; Start : Positive)
                 return Integer;

   ----------------------------------------------------------------------------

   --  Convert C/S to lowercase.
   function To_Lower (C : Character) return Character;

   -- Str/Char : image of a natural number/digit
   function Value (Str : String) return Integer;
   function Value (Char : Character) return Integer;
end Grt.Strings;