blob: eab6bc41da2cc6cf2ab04c1c5cfc2353fc868417 (
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
-- GHDL Run Time (GRT) - variable strings.
-- Copyright (C) 2002 - 2014 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.
with Grt.Types; use Grt.Types;
with System; use System;
package Grt.Vstrings is
pragma Preelaborate;
-- A Vstring (Variable string) is an object which contains an unbounded
-- string.
type Vstring is limited private;
-- Deallocate all storage internally allocated.
procedure Free (Vstr : in out Vstring);
-- Reset VSTR to an empty string.
procedure Reset (Vstr : in out Vstring);
-- Append a character.
procedure Append (Vstr : in out Vstring; C : Character);
-- Append a string.
procedure Append (Vstr : in out Vstring; Str : String);
-- Append a C string.
procedure Append (Vstr : in out Vstring; Str : Ghdl_C_String);
-- Get length of VSTR.
function Length (Vstr : Vstring) return Natural;
-- Truncate VSTR to LEN.
-- It is an error if LEN is greater than the current length.
procedure Truncate (Vstr : in out Vstring; Len : Natural);
-- Return the address of the first character of VSTR.
function Get_Address (Vstr : Vstring) return Address;
-- Get VSTR as a C String. The NUL character must have been added.
function Get_C_String (Vstr : Vstring) return Ghdl_C_String;
-- A Rstring is link a Vstring but characters can only be prepended.
type Rstring is limited private;
-- Deallocate storage associated with Rstr.
procedure Free (Rstr : in out Rstring);
-- Prepend characters or strings.
procedure Prepend (Rstr : in out Rstring; C : Character);
procedure Prepend (Rstr : in out Rstring; Str : String);
procedure Prepend (Rstr : in out Rstring; Str : Ghdl_C_String);
-- Get the length of RSTR.
function Length (Rstr : Rstring) return Natural;
-- Return the address of the first character of RSTR.
function Get_Address (Rstr : Rstring) return Address;
-- Copy RSTR to STR, and return length of the string to LEN.
procedure Copy (Rstr : Rstring; Str : in out String; Len : out Natural);
private
type Vstring is record
Str : Ghdl_C_String := null;
Max : Natural := 0;
Len : Natural := 0;
end record;
type Rstring is record
-- String whose bounds is (1 .. Max).
Str : Ghdl_C_String := null;
-- Last index in STR.
Max : Natural := 0;
-- Index of the first character.
First : Natural := 1;
end record;
end Grt.Vstrings;
|
