grefstring.h File Reference

#include "gmem.h"
#include "gmacros.h"

Go to the source code of this file.

Typedefs
typedef char	GRefString

Functions
G_BEGIN_DECLS GLIB_AVAILABLE_IN_2_58 char *	g_ref_string_new (const char *str)
GLIB_AVAILABLE_IN_2_58 char *	g_ref_string_new_len (const char *str, gssize len)
GLIB_AVAILABLE_IN_2_58 char *	g_ref_string_new_intern (const char *str)
GLIB_AVAILABLE_IN_2_58 char *	g_ref_string_acquire (char *str)
GLIB_AVAILABLE_IN_2_58 void	g_ref_string_release (char *str)
GLIB_AVAILABLE_IN_2_58 gsize	g_ref_string_length (char *str)

Typedef Documentation

GRefString

typedef char GRefString

GRefString:

A typedef for a reference-counted string. A pointer to a GRefString can be treated like a standard char* array by all code, but can additionally have g_ref_string_*() methods called on it. g_ref_string_*() methods cannot be called on char* arrays not allocated using g_ref_string_new().

If using GRefString with autocleanups, g_autoptr() must be used rather than g_autofree(), so that the reference counting metadata is also freed.

Since: 2.58

Definition at line 57 of file grefstring.h.

Function Documentation

g_ref_string_acquire()

GLIB_AVAILABLE_IN_2_58 char * g_ref_string_acquire

(

char *

str

)

g_ref_string_length()

GLIB_AVAILABLE_IN_2_58 gsize g_ref_string_length

(

char *

str

)

g_ref_string_new()

G_BEGIN_DECLS GLIB_AVAILABLE_IN_2_58 char * g_ref_string_new

(

const char *

str

)

g_ref_string_new_intern()

GLIB_AVAILABLE_IN_2_58 char * g_ref_string_new_intern

(

const char *

str

)

g_ref_string_new_len()

GLIB_AVAILABLE_IN_2_58 char * g_ref_string_new_len	(	const char *	str,
		gssize	len )

g_ref_string_release()

GLIB_AVAILABLE_IN_2_58 void g_ref_string_release

(

char *

str

)