UUID: add nil value for UUIDs

Add `BLI_uuid_nil()` that returns the nil UUID (used to indicate "not
set") and `BLI_uuid_is_nil(uuid)` to do an equality test with the nil
value.

1 files changed, 8 insertions, 0 deletions

diff --git a/source/blender/blenlib/BLI_uuid.h b/source/blender/blenlib/BLI_uuid.h
index 5440e9426bf..15913cc1017 100644
--- a/source/blender/blenlib/BLI_uuid.h
+++ b/source/blender/blenlib/BLI_uuid.h
@@ -37,6 +37,14 @@ extern "C" {
  * This function is not thread-safe. */
 UUID BLI_uuid_generate_random(void);
 
+/**
+ * Return the UUID nil value, consisting of all-zero fields.
+ */
+UUID BLI_uuid_nil(void);
+
+/** Return true iff this is the nil UUID. */
+bool BLI_uuid_is_nil(UUID uuid);
+
 /** Compare two UUIDs, return true if they are equal. */
 bool BLI_uuid_equal(UUID uuid1, UUID uuid2);