gimpmemsize

gimpmemsize — Functions to (de)serialize a given memory size.

Synopsis




gchar*      gimp_memsize_serialize          (guint64 memsize);
gboolean    gimp_memsize_deserialize        (const gchar *string,
                                             guint64 *memsize);
gchar*      gimp_memsize_to_string          (guint64 memsize);
#define     GIMP_TYPE_MEMSIZE
#define     GIMP_VALUE_HOLDS_MEMSIZE        (value)

Description

Functions to (de)serialize a given memory size.

Details

gimp_memsize_serialize ()

gchar*      gimp_memsize_serialize          (guint64 memsize);

Creates a string representation of a given memory size. This string can be parsed by gimp_memsize_deserialize() and can thus be used in config files. It should not be displayed to the user. If you need a nice human-readable string please use gimp_memsize_to_string().

memsize : memory size in bytes
Returns : A newly allocated string representation of memsize.

Since GIMP 2.2

gimp_memsize_deserialize ()

gboolean    gimp_memsize_deserialize        (const gchar *string,
                                             guint64 *memsize);

Parses a string representation of a memory size as returned by gimp_memsize_serialize().

string : a string as returned by gimp_memsize_serialize()
memsize : return location for memory size in bytes
Returns : TRUE if the string was successfully parsed and memsize has been set, FALSE otherwise.

Since GIMP 2.2

gimp_memsize_to_string ()

gchar*      gimp_memsize_to_string          (guint64 memsize);

This function returns a human readable, translated representation of the passed memsize. Large values are displayed using a reasonable memsize unit, e.g.: "345" becomes "345 Bytes", "4500" becomes "4.4 KB" and so on.

memsize : A memory size in bytes.
Returns : A newly allocated human-readable, translated string.

GIMP_TYPE_MEMSIZE

#define GIMP_TYPE_MEMSIZE               (gimp_memsize_get_type ())

GIMP_TYPE_MEMSIZE is a GType derived from G_TYPE_UINT64.

GIMP_VALUE_HOLDS_MEMSIZE()

#define GIMP_VALUE_HOLDS_MEMSIZE(value) (G_TYPE_CHECK_VALUE_TYPE ((value), GIMP_TYPE_MEMSIZE))

value :