glib-2.0/glib/gstrvbuilder.h

0001 /*
0002  * Copyright © 2020 Canonical Ltd.
0003  * Copyright © 2021 Alexandros Theodotou
0004  *
0005  * SPDX-License-Identifier: LGPL-2.1-or-later
0006  *
0007  * This library is free software; you can redistribute it and/or
0008  * modify it under the terms of the GNU Lesser General Public
0009  * License as published by the Free Software Foundation; either
0010  * version 2.1 of the License, or (at your option) any later version.
0011  *
0012  * This library is distributed in the hope that it will be useful,
0013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
0014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
0015  * Lesser General Public License for more details.
0016  *
0017  * You should have received a copy of the GNU Lesser General Public
0018  * License along with this library; if not, see <http://www.gnu.org/licenses/>.
0019  */
0020
0021 #ifndef __G_STRVBUILDER_H__
0022 #define __G_STRVBUILDER_H__
0023
0024 #if !defined(__GLIB_H_INSIDE__) && !defined(GLIB_COMPILATION)
0025 #error "Only <glib.h> can be included directly."
0026 #endif
0027
0028 #include <glib/gstrfuncs.h>
0029 #include <glib/gtypes.h>
0030
0031 G_BEGIN_DECLS
0032
0033 typedef struct _GStrvBuilder GStrvBuilder;
0034
0035 GLIB_AVAILABLE_IN_2_68
0036 GStrvBuilder *g_strv_builder_new (void);
0037
0038 GLIB_AVAILABLE_IN_2_68
0039 void g_strv_builder_unref (GStrvBuilder *builder);
0040
0041 GLIB_AVAILABLE_IN_2_82
0042 GStrv g_strv_builder_unref_to_strv (GStrvBuilder *builder);
0043
0044 GLIB_AVAILABLE_IN_2_68
0045 GStrvBuilder *g_strv_builder_ref (GStrvBuilder *builder);
0046
0047 GLIB_AVAILABLE_IN_2_68
0048 void g_strv_builder_add (GStrvBuilder *builder,
0049                          const char *value);
0050
0051 GLIB_AVAILABLE_IN_2_70
0052 void g_strv_builder_addv (GStrvBuilder *builder,
0053                           const char **value);
0054
0055 GLIB_AVAILABLE_IN_2_70
0056 void g_strv_builder_add_many (GStrvBuilder *builder,
0057                               ...) G_GNUC_NULL_TERMINATED;
0058
0059 GLIB_AVAILABLE_IN_2_80
0060 void g_strv_builder_take (GStrvBuilder *builder,
0061                           char *value);
0062
0063 GLIB_AVAILABLE_IN_2_68
0064 GStrv g_strv_builder_end (GStrvBuilder *builder);
0065
0066 G_END_DECLS
0067
0068 #endif /* __G_STRVBUILDER_H__ */