| Gwyddion Library Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Signals | ||||
#include <libgwyddion/gwyddion.h> struct GwyStringList; struct GwyStringListClass; #define gwy_string_list_duplicate (strlist) GwyStringList * gwy_string_list_new (void); void gwy_string_list_append (GwyStringList *strlist,const gchar *string); void gwy_string_list_append_take (GwyStringList *strlist,gchar *string); guint gwy_string_list_get_length (GwyStringList *strlist); const gchar * gwy_string_list_get (GwyStringList *strlist,guint i); void gwy_string_list_clear (GwyStringList *strlist);
GwyStringList object represents a reference-counted, serializable list of strings. The current interface is very minimal, more methods may be added later as needed.
struct GwyStringList;
The GwyStringList struct contains private data only and should be accessed using the functions below.
struct GwyStringListClass {
GObjectClass parent_class;
void (*value_changed)(GwyStringList *strlist);
void (*reserved1)(void);
void (*reserved2)(void);
void (*reserved3)(void);
};
#define gwy_string_list_duplicate(strlist)
Convenience macro doing gwy_serializable_duplicate() with all the necessary
typecasting.
|
A string list to duplicate. |
GwyStringList * gwy_string_list_new (void);
Creates a new string list.
Returns : |
A new empty string list. |
void gwy_string_list_append (GwyStringList *strlist,const gchar *string);
Appends a string to the end of a string list.
|
A string list. |
|
A string to add. |
void gwy_string_list_append_take (GwyStringList *strlist,gchar *string);
Appends a string to the end of a string list, taking ownership of the string.
|
A string list. |
|
A string to add. |
Since 2.35
guint gwy_string_list_get_length (GwyStringList *strlist);
Gets the number of strings in a string list.
|
A string list. |
Returns : |
The number of strings in strlist. |
const gchar * gwy_string_list_get (GwyStringList *strlist,guint i);
Gets a string from a string list by position.
|
A string list. |
|
The position of string to get. |
Returns : |
The string, owned by strlist. It is valid only until strlist
changes. |
void gwy_string_list_clear (GwyStringList *strlist);
Clears the contents of a string list, removing all strings.
|
A string list. |
Since 2.35
"value-changed" signalvoid user_function (GwyStringList *gwystrlist,
gpointer user_data) : Run First
The ::value-changed signal is emitted whenever a string list changes.
|
The GwyStringList which received the signal. |
|
user data set when the signal handler was connected. |