aboutsummaryrefslogtreecommitdiffstats
path: root/src/grt/grt-strings.ads
blob: 1d52a62fc8b26d18a806d3d0f60c696bc806a1b6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
--  GHDL Run Time (GRT) - Misc subprograms for characters and strings
--  Copyright (C) 2016 Tristan Gingold
--
--  This program 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 of the License, or
--  (at your option) any later version.
--
--  This program 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 this program.  If not, see <gnu.org/licenses>.
--
--  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 by LRM93 13.1
   --  Note: this is different from the definition in LRM93 14.3 (for files,
   --   which includes HT).
   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;