QOF GUID's can be used independently of any other subsystem in QOF. In particular, they do not require the use of other parts of the object subsystem.
Files | |
file | guid.h |
globally unique ID User API | |
Data Structures | |
union | _GUID |
Defines | |
#define | GUID_ENCODING_LENGTH 32 |
Typedefs | |
typedef _GUID | GUID |
Functions | |
void | guid_init (void) |
void | guid_init_with_salt (const void *salt, size_t salt_len) |
void | guid_init_only_salt (const void *salt, size_t salt_len) |
void | guid_shutdown (void) |
void | guid_new (GUID *guid) |
const GUID | guid_new_return (void) |
const GUID * | guid_null (void) |
GUID * | guid_malloc (void) |
void | guid_free (GUID *guid) |
const char * | guid_to_string (const GUID *guid) |
char * | guid_to_string_buff (const GUID *guid, char *buff) |
gboolean | string_to_guid (const char *string, GUID *guid) |
gboolean | guid_equal (const GUID *guid_1, const GUID *guid_2) |
gint | guid_compare (const GUID *g1, const GUID *g2) |
guint | guid_hash_to_guint (gconstpointer ptr) |
GHashTable * | guid_hash_table_new (void) |
|
number of characters needed to encode a guid as a string not including the null terminator. |
|
The type used to store guids |
|
Given two GUIDs, return TRUE if they are non-NULL and equal. Return FALSE, otherwise. |
|
Given a GUID *, hash it to a guint |
|
Initialize the id generator with a variety of random sources.
|
|
Initialize the id generator with the data given in the salt argument, but not with any other source. Calling this function with a specific argument will reliably produce a specific sequence of ids.
|
|
Initialize the id generator with a variety of random sources. and with the data given in the salt argument. This argument can be used to add additional randomness to the generated ids.
|
|
Efficiently allocate & free memory for GUIDs |
|
Generate a new id. If no initialization function has been called, guid_init() will be called before the id is created.
|
|
Generate a new id. If no initialization function has been called, guid_init() will be called before the id is created.
|
|
Returns a GUID which is guaranteed to never reference any entity. |
|
Release the memory chunk associated with gui storage. Use this only when shutting down the program, as it invalidates *all* GUIDs at once. |
|
The guid_to_string() routine returns a null-terminated string encoding of the id. String encodings of identifiers are hex numbers printed only with the characters '0' through '9' and 'a' through 'f'. The encoding will always be GUID_ENCODING_LENGTH characters long. XXX This routine is not thread safe and is deprecated. Please use the routine guid_to_string_buff() instead.
|
|
The guid_to_string_buff() routine puts a null-terminated string encoding of the id into the memory pointed at by buff. The buffer must be at least GUID_ENCODING_LENGTH+1 characters long. This routine is handy for avoiding a malloc/free cycle. It returns a pointer to the >>end<< of what was written. (i.e. it can be used like 'stpcpy' during string concatenation)
|
|
Given a string, decode the id into the guid if guid is non-NULL. The function returns TRUE if the string was a valid 32 character hexadecimal number. This function accepts both upper and lower case hex digits. If the return value is FALSE, the effect on guid is undefined. |