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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
/* SPDX-FileCopyrightText: 2009-2023 Greenbone AG
*
* SPDX-License-Identifier: GPL-2.0-or-later
*/
/**
* @file
* @brief String utilities.
*/
#include "strings.h"
#include <assert.h> /* for assert */
#include <glib.h> /* for g_free, g_strconcat, gchar, g_strdup, g_strndup */
#undef G_LOG_DOMAIN
/**
* @brief GLib log domain.
*/
#define G_LOG_DOMAIN "libgvm base"
/**
* @brief Append a string to a string variable.
*
* When the variable is NULL store a copy of the given string in the variable.
*
* When the variable already contains a string replace the string with a new
* string that is the concatenation of the two, freeing the old string. It is
* up to the caller to free the given string if it was dynamically allocated.
*
* @param[in] var The address of a string variable, that is, a pointer to
* a string.
* @param[in] string The string to append to the string in the variable.
*/
void
gvm_append_string (gchar **var, const gchar *string)
{
if (*var)
{
char *old = *var;
*var = g_strconcat (old, string, NULL);
g_free (old);
}
else
*var = g_strdup (string);
}
/**
* @brief Append a string of a known length to a string variable.
*
* When the variable is NULL store a copy of the given string in the variable.
*
* When the variable already contains a string replace the string with a new
* string that is the concatenation of the two, freeing the old string. It is
* up to the caller to free the given string if it was dynamically allocated.
*
* The string must be NULL terminated, and the given length must be the
* actual length of the string.
*
* @param[in] var The address of a string variable, that is, a pointer to
* a string.
* @param[in] string The string to append to the string in the variable.
* @param[in] length The length of string.
*/
void
gvm_append_text (gchar **var, const gchar *string, gsize length)
{
if (*var)
{
char *old = *var;
*var = g_strconcat (old, string, NULL);
g_free (old);
}
else
*var = g_strndup (string, length);
}
/**
* @brief Free a string variable.
*
* Free the string in the variable and set the variable to NULL.
*
* @param[in] var The address of a string variable, that is, a pointer to
* a string.
*/
void
gvm_free_string_var (gchar **var)
{
g_free (*var);
*var = NULL;
}
/**
* @brief "Strip" space and newline characters from either end of some memory.
*
* Return the given pointer moved forward past any spaces, replacing the
* first of any contiguous spaces at or before the end of the memory with
* a terminating NULL.
*
* This is for use when string points into a static buffers.
*
* @param[in,out] string The start of the memory.
* @param[in] end Pointer to the byte after the end of the memory.
*
* @return A new pointer into the string.
*/
char *
gvm_strip_space (char *string, char *end)
{
assert (string <= end);
if (string >= end)
return string;
end--;
while (string[0] == ' ' || string[0] == '\n')
{
string++;
if (string >= end)
{
end[0] = '\0';
return end;
}
}
/* Here string is < end. */
if (end[0] == ' ' || end[0] == '\n')
{
end--;
while (end >= string && (end[0] == ' ' || end[0] == '\n'))
{
end--;
}
end[1] = '\0';
}
return string;
}
|
