JUCE
Public Member Functions | Static Public Member Functions | List of all members
Uuid Class Reference

A universally unique 128-bit identifier. More...

Public Member Functions

 Uuid ()
 Creates a new unique ID, compliant with RFC 4122 version 4. More...
 
 ~Uuid () noexcept
 Destructor. More...
 
 Uuid (const Uuid &) noexcept
 Creates a copy of another UUID. More...
 
Uuidoperator= (const Uuid &) noexcept
 Copies another UUID. More...
 
bool isNull () const noexcept
 Returns true if the ID is zero. More...
 
bool operator== (const Uuid &) const noexcept
 
bool operator!= (const Uuid &) const noexcept
 
String toString () const
 Returns a stringified version of this UUID. More...
 
String toDashedString () const
 Returns a stringified version of this UUID, separating it into sections with dashes. More...
 
 Uuid (const String &uuidString)
 Creates an ID from an encoded string version. More...
 
Uuidoperator= (const String &uuidString)
 Copies from a stringified UUID. More...
 
const uint8getRawData () const noexcept
 Returns a pointer to the internal binary representation of the ID. More...
 
 Uuid (const uint8 *rawData) noexcept
 Creates a UUID from a 16-byte array. More...
 
Uuidoperator= (const uint8 *rawData) noexcept
 Sets this UUID from 16-bytes of raw data. More...
 

Static Public Member Functions

static Uuid null () noexcept
 Returns a null Uuid object. More...
 

Detailed Description

A universally unique 128-bit identifier.

This class generates very random unique numbers. It's vanishingly unlikely that two identical UUIDs would ever be created by chance. The values are formatted to meet the RFC 4122 version 4 standard.

The class includes methods for saving the ID as a string or as raw binary data.

Constructor & Destructor Documentation

Uuid::Uuid ( )

Creates a new unique ID, compliant with RFC 4122 version 4.

Uuid::~Uuid ( )
noexcept

Destructor.

Uuid::Uuid ( const Uuid )
noexcept

Creates a copy of another UUID.

Uuid::Uuid ( const String uuidString)

Creates an ID from an encoded string version.

See also
toString
Uuid::Uuid ( const uint8 rawData)
noexcept

Creates a UUID from a 16-byte array.

See also
getRawData

Member Function Documentation

Uuid& Uuid::operator= ( const Uuid )
noexcept

Copies another UUID.

bool Uuid::isNull ( ) const
noexcept

Returns true if the ID is zero.

static Uuid Uuid::null ( )
staticnoexcept

Returns a null Uuid object.

bool Uuid::operator== ( const Uuid ) const
noexcept
bool Uuid::operator!= ( const Uuid ) const
noexcept
String Uuid::toString ( ) const

Returns a stringified version of this UUID.

A Uuid object can later be reconstructed from this string using operator= or the constructor that takes a string parameter.

Returns
a 32 character hex string.
String Uuid::toDashedString ( ) const

Returns a stringified version of this UUID, separating it into sections with dashes.

Returns
a string in the format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Uuid& Uuid::operator= ( const String uuidString)

Copies from a stringified UUID.

The string passed in should be one that was created with the toString() method.

const uint8* Uuid::getRawData ( ) const
noexcept

Returns a pointer to the internal binary representation of the ID.

This is an array of 16 bytes. To reconstruct a Uuid from its data, use the constructor or operator= method that takes an array of uint8s.

References JUCE_LEAK_DETECTOR.

Uuid& Uuid::operator= ( const uint8 rawData)
noexcept

Sets this UUID from 16-bytes of raw data.


The documentation for this class was generated from the following file: