UUID: libnkutils Reference Manual

UUID

UUID — v4 (random) and v5 (namespace) UUID generation

void
nk_uuid_generate (NkUuid *uuid);

Generates a v4 (random) UUID.

uuid

[out caller-allocates]

gboolean
nk_uuid_parse (NkUuid *uuid,
               const gchar *string);

Parses an UUID stirng.

uuid	an NkUuid.	[out caller-allocates]
string	a string containing an UUID in the xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx format

TRUE if parsing succeeded, FALSE otherwise

void
nk_uuid_from_name (NkUuid *uuid,
                   const gchar *name,
                   gssize length);

Generates a v5 (namespace) UUID.

uuid must contains the namespace UUID and will be updated to the new UUID.

#define NK_UUID_LENGTH 16

#define NK_UUID_FORMATTED_LENGTH 36

typedef struct {
    guchar data[NK_UUID_LENGTH];
    gchar string[NK_UUID_FORMATTED_LENGTH + 1];
} NkUuid;

guchar `data`[NK_UUID_LENGTH];	the UUID has raw bytes
gchar `string`[NK_UUID_FORMATTED_LENGTH + 1];	the UUID as a string using the xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx format

#define NK_UUID_INIT { .data = { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 }, .string = "00000000-0000-0000-0000-000000000000" }

You can use this macro to initialize an NkUuid structure:

1	NkUuid uuid = NK_UUID_INIT;