Gwyddion – Free SPM (AFM, SNOM/NSOM, STM, MFM, …) data analysis software

GwyStringList (HEAD)

GwyStringList — A string list object wrapper

Functions

#define gwy_string_list_duplicate()
GwyStringList * gwy_string_list_new ()
void gwy_string_list_append ()
void gwy_string_list_append_take ()
guint gwy_string_list_get_length ()
const gchar * gwy_string_list_get ()
void gwy_string_list_clear ()

Signals

void value-changed Run First

Types and Values

struct GwyStringList
struct GwyStringListClass

Object Hierarchy

    GObject
    ╰── GwyStringList

Implemented Interfaces

GwyStringList implements GwySerializable.

Includes

#include <libgwyddion/gwyddion.h>

Description

GwyStringList object represents a reference-counted, serializable list of strings. The current interface is very minimal, more methods may be added later as needed.

Functions

gwy_string_list_duplicate()

#define             gwy_string_list_duplicate(strlist)

Convenience macro doing gwy_serializable_duplicate() with all the necessary typecasting.

Parameters

strlist

A string list to duplicate.

 

gwy_string_list_new ()

GwyStringList *
gwy_string_list_new (void);

Creates a new string list.

Returns

A new empty string list.

gwy_string_list_append ()

void
gwy_string_list_append (GwyStringList *strlist,
                        const gchar *string);

Appends a string to the end of a string list.

Parameters

strlist

A string list.

 

string

A string to add.

 

gwy_string_list_append_take ()

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.

Parameters

strlist

A string list.

 

string

A string to add.

 

Since: 2.35

gwy_string_list_get_length ()

guint
gwy_string_list_get_length (GwyStringList *strlist);

Gets the number of strings in a string list.

Parameters

strlist

A string list.

 

Returns

The number of strings in strlist .

gwy_string_list_get ()

const gchar *
gwy_string_list_get (GwyStringList *strlist,
                     guint i);

Gets a string from a string list by position.

Parameters

strlist

A string list.

 

i

The position of string to get.

 

Returns

The string, owned by strlist . It is valid only until strlist changes.

gwy_string_list_clear ()

void
gwy_string_list_clear (GwyStringList *strlist);

Clears the contents of a string list, removing all strings.

Parameters

strlist

A string list.

 

Since: 2.35

Types and Values

struct GwyStringList

struct GwyStringList;

The GwyStringList struct contains private data only and should be accessed using the functions below.

struct GwyStringListClass

struct GwyStringListClass {
    GObjectClass parent_class;

    void (*value_changed)(GwyStringList *strlist);
};

Signal Details

The “value-changed” signal

void
user_function (GwyStringList *gwystrlist,
               gpointer       user_data)

The ::value-changed signal is emitted whenever a string list changes.

Parameters

gwystrlist

The GwyStringList which received the signal.

 

user_data

user data set when the signal handler was connected.

 

Flags: Run First

© David Nečas and Petr Klapetek

Home Download News Features Screenshots Documentation Communicate Participate Resources Publications Applications Site Map

Valid XHTML 1.0 Valid CSS