2 * Copyright © 2020 Canonical Ltd.
3 * Copyright © 2021 Alexandros Theodotou
5 * SPDX-License-Identifier: LGPL-2.1-or-later
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
21 #ifndef __G_STRVBUILDER_H__
22 #define __G_STRVBUILDER_H__
24 #if !defined(__GLIB_H_INSIDE__) && !defined(GLIB_COMPILATION)
25 #error "Only <glib.h> can be included directly."
28 #include <glib/gstrfuncs.h>
29 #include <glib/gtypes.h>
36 * A helper object to build a %NULL-terminated string array
37 * by appending. See g_strv_builder_new().
41 typedef struct _GStrvBuilder GStrvBuilder;
43 GLIB_AVAILABLE_IN_2_68
44 GStrvBuilder *g_strv_builder_new (void);
46 GLIB_AVAILABLE_IN_2_68
47 void g_strv_builder_unref (GStrvBuilder *builder);
49 GLIB_AVAILABLE_IN_2_68
50 GStrvBuilder *g_strv_builder_ref (GStrvBuilder *builder);
52 GLIB_AVAILABLE_IN_2_68
53 void g_strv_builder_add (GStrvBuilder *builder,
56 GLIB_AVAILABLE_IN_2_70
57 void g_strv_builder_addv (GStrvBuilder *builder,
60 GLIB_AVAILABLE_IN_2_70
61 void g_strv_builder_add_many (GStrvBuilder *builder,
62 ...) G_GNUC_NULL_TERMINATED;
64 GLIB_AVAILABLE_IN_2_68
65 GStrv g_strv_builder_end (GStrvBuilder *builder);
69 #endif /* __G_STRVBUILDER_H__ */