e1d7ce005f
Add `BLI_uuid` and `DNA_uuid_types.h` with a UUID implementation following RFC4122 (https://datatracker.ietf.org/doc/html/rfc4122.html). The following features are implemented: - A struct of 128 bits that can be used in DNA definitions. - Generation of version 4 UUIDs, that is, purely random ones. - UUID equality function. - String to UUID and UUID to string conversion functions that are compatible with RFC4122. - C++ stream operator that outputs the UUID as string. This UUID will be used by the asset system, to uniquely identify asset catalogs. Reviewed By: Severin, jacqueslucke Differential Revision: https://developer.blender.org/D12475
76 lines
2.1 KiB
C++
76 lines
2.1 KiB
C++
/*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bli
|
|
*
|
|
* Functions for generating and handling "Session UUIDs".
|
|
*
|
|
* Note that these are not true universally-unique identifiers, but only unique during the current
|
|
* Blender session.
|
|
*
|
|
* For true UUIDs, see `BLI_uuid.h`.
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include "DNA_session_uuid_types.h"
|
|
|
|
/* Generate new UUID which is unique throughout the Blender session. */
|
|
SessionUUID BLI_session_uuid_generate(void);
|
|
|
|
/* Check whether the UUID is properly generated. */
|
|
bool BLI_session_uuid_is_generated(const SessionUUID *uuid);
|
|
|
|
/* Check whether two UUIDs are identical. */
|
|
bool BLI_session_uuid_is_equal(const SessionUUID *lhs, const SessionUUID *rhs);
|
|
|
|
uint64_t BLI_session_uuid_hash_uint64(const SessionUUID *uuid);
|
|
|
|
/* Utility functions to make it possible to create GHash/GSet with UUID as a key. */
|
|
uint BLI_session_uuid_ghash_hash(const void *uuid_v);
|
|
bool BLI_session_uuid_ghash_compare(const void *lhs_v, const void *rhs_v);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
|
|
namespace blender {
|
|
|
|
inline const bool operator==(const SessionUUID &lhs, const SessionUUID &rhs)
|
|
{
|
|
return BLI_session_uuid_is_equal(&lhs, &rhs);
|
|
}
|
|
|
|
template<typename T> struct DefaultHash;
|
|
|
|
template<> struct DefaultHash<SessionUUID> {
|
|
uint64_t operator()(const SessionUUID &value) const
|
|
{
|
|
return BLI_session_uuid_hash_uint64(&value);
|
|
}
|
|
};
|
|
|
|
} // namespace blender
|
|
|
|
#endif
|