就业培训     下载中心     Wiki     联络 登录   注册

---

内容

The content of a maxon::Uuid can be managed with these functions:

• maxon::UuidInterface::IsEmpty() : returns whether the UUID is empty or not;
• maxon::UuidInterface::IsPopulated() : returns whether the UUID is populated or not.

// allocate the Uuid maxon::Uuid uniqueid;

// init the Uuid uniqueid.CreateId() iferr_return ; const Bool uuidIsPopulated = uniqueid.IsPopulated(); if (uuidIsPopulated) { // uniqueid is populated do something }

A maxon::Uuid object's value can be set and retrieved using:

• maxon::UuidInterface::Set(const String& uuid) : given a valid string sets a UUID;
• maxon::UuidInterface::Set(const UChar* uuid, Int uuidSize) : given an UUID pointer and the size of the memory block sets a given memory block of a UUID;
• maxon::UuidInterface::Get() : given an UUID pointer and the size of the memory block gets a given memory block of a UUID.

// allocate an Uuid maxon::Uuid firstUuid, secondUuid;

// set the value of the first UUID by using a given string firstUuid.Set( "AABBCCDD-EEFF-0123-4567-FFEEDDCCBBAA" _s) iferr_return ;

// allocate a BaseArray of UChar const Int size = 16; BaseArray<UChar> data;

// resize the array accordingly to the expected size of the UUID object data.Resize(size) iferr_return ;

// retrieve the value of the first UUID and fill the data array firstUuid.Get(data.GetFirst(), size) iferr_return ;

// set the value of the second UUID using the retrieved data secondUuid.Set(data.GetFirst(), size) iferr_return ;

比较

A given maxon::Uuid can be compared to another using:

• maxon::UuidInterface::Compare() : compare the UUID against the passed UUID.

Conversion

A given maxon::Uuid can be converted to a maxon::String using:

• maxon::UuidInterface::ToString() : Converts the UUID into a string.

注意

The format will be "00000000-0000-0000-0000-000000000000" and the letters will be uppercase.

// allocate an Uuid object maxon::Uuid uniqueId;

// initialize the Uuid uniqueId.CreateId() iferr_return ;

// convert the Uuid to a String const maxon::String uniqueIdString = uniqueId.ToString( nullptr );

// display the string DiagnosticOutput ( "The uniqueIdString is @" , uniqueIdString);

Utility

A given maxon::Uuid can return the hash-code of the UUID using:

• maxon::UuidInterface::GetHashCode() : returns the hash-code of the UUID; if UUID is empty returns 0.

// allocate an Uuid object maxon::Uuid uniqueId;

// initialize the Uuid uniqueId.CreateId() iferr_return ;

// generate the hash code from the Uuid const maxon::UInt uuidHash = uniqueId.GetHashCode();

// display the hash code DiagnosticOutput ( "The hash of uniqueId is @" , uuidHash);

To generate a string containing a UUID it's available for immediate use:

• maxon::UuidInterface::CreateUuidString() .

// allocate directly a string containing an Uuid value maxon::String uuidString = maxon::Uuid::CreateUuidString() iferr_return ;

// display the string DiagnosticOutput ("The string is populated with @", uuidString);

A maxon::Uuid object can be read from and written to disk by serializing the data contained using the conventional functions.

// file URL const maxon::Url url = (targetFolder + "uuid.txt" _s) iferr_return ; const maxon::Id fileID { "net.maxonexample.uuid" };

// save to file maxon::WriteDocument (url, maxon::OPENSTREAMFLAGS::NONE , fileID, savedUuid, maxon::IOFORMAT::JSON ) iferr_return ;

// read from file maxon::Uuid loadedUuid; maxon::ReadDocument (url, fileID, loadedUuid) iferr_return ;

// display loaded uuid DiagnosticOutput ( "Loaded Uuid: @" , loadedUuid.ToString( nullptr ));

延伸阅读

• 数据 & 算法
• String Manual
• DescribeIO Manual