Inheritance diagram for xtd::guid:

Definition

Represents a globally unique identifier (GUID). A GUID is a 128-bit integer (16 bytes) that can be used across all computers and networks wherever a unique identifier is required. Such an identifier has a very low probability of being duplicated.

Namespace: xtd

Library: xtd.core

Examples: The following code example demonstrates the use of xtd::guid class.
#include <xtd/console>

#include <xtd/guid>

using namespace xtd;

auto main() -> int {

for (auto counter = 0; counter < 10; ++counter)

console::write_line("{:X}", guid::new_guid());

}

// This code can produce the following output :

//

// {0x8b29b084,0x4be2,0x4a1d,{0x93,0x44,0x59,0xea,0x59,0x9b,0x5b,0xaa}}

// {0x27e83739,0x1d25,0x47b0,{0xbc,0x22,0xb7,0x0b,0x96,0x3d,0xf4,0x1b}}

// {0x7516c2d6,0x1c88,0x46d2,{0x9c,0x17,0xd4,0x18,0xb5,0x7d,0x23,0xb4}}

// {0xec556311,0x969b,0x4095,{0x9e,0xce,0x40,0x27,0x73,0x3d,0x55,0xc5}}

// {0x35674f52,0x154e,0x4dce,{0xb1,0xaa,0x58,0x4d,0x79,0x44,0xe0,0xb6}}

// {0xc9a6f085,0x8ea1,0x4825,{0xa8,0x74,0x03,0xdf,0x26,0xba,0xed,0x92}}

// {0xed2922f4,0x664b,0x4c85,{0xb6,0x0d,0x01,0xcd,0x3c,0x20,0xcf,0x1d}}

// {0xbaed4d04,0x772f,0x47a7,{0xac,0x87,0xb3,0xd1,0x3c,0x0f,0x8c,0xdc}}

// {0x0cba6b46,0xce6d,0x41c7,{0x99,0x17,0x0f,0x41,0x5a,0x50,0x0a,0xfb}}

// {0x1e8e6ac6,0x163c,0x43d4,{0x9d,0x36,0x1b,0x3e,0x04,0x13,0x73,0x0c}}

xtd::console::write_line
static void write_line()
Writes the current line terminator to the standard output stream using the specified format informati...

xtd::guid::new_guid
static guid new_guid() noexcept
Initializes a new instance of the xtd::guid structure.

xtd
The xtd namespace contains all fundamental classes to access Hardware, Os, System,...
Definition xtd_about_box.hpp:10

Examples: system_exception.cpp.

Public Fields
static const guid	empty
	Gets A read-only instance of the xtd::guid structure whose value is all zeros.

Public Constructors
	guid ()=default
	Initializes a new instance of the xtd::guid structure.

	guid (const xtd::array< xtd::byte > &data)
	Initializes a new instance of the xtd::guid structure by using the specified array of bytes.

	guid (const std::initializer_list< xtd::byte > &data)
	Initializes a new instance of the xtd::guid structure by using the specified array of bytes.

	guid (int32 a, int16 b, int16 c, const xtd::array< xtd::byte > &d)
	Initializes a new instance of the xtd::guid structure by using the specified integers and byte array.

	guid (uint32 a, uint16 b, uint16 c, const xtd::array< xtd::byte > &d)
	Initializes a new instance of the xtd::guid structure by using the specified unsigned integers and byte array.

	guid (int32 a, int16 b, int16 c, xtd::byte d, xtd::byte e, xtd::byte f, xtd::byte g, xtd::byte h, xtd::byte i, xtd::byte j, xtd::byte k) noexcept
	Initializes a new instance of the xtd::guid structure by using the specified integers and bytes.

	guid (uint32 a, uint16 b, uint16 c, xtd::byte d, xtd::byte e, xtd::byte f, xtd::byte g, xtd::byte h, xtd::byte i, xtd::byte j, xtd::byte k) noexcept
	Initializes a new instance of the xtd::guid structure by using the specified unsigned integers and bytes.

	guid (const string &guid)
	Initializes a new instance of the xtd::guid structure by using the value represented by the specified string.

Public Methods
int32	compare_to (const guid &value) const noexcept override
	Compares the current instance with another object of the same type.

bool	equals (const object &obj) const noexcept override
	Determines whether the specified object is equal to the current object.

bool	equals (const guid &g) const noexcept override
	Determines whether the specified object is equal to the current object.

xtd::size	get_hash_code () const noexcept override
	Serves as a hash function for a particular type.

const xtd::array< xtd::byte > &	to_byte_array () const noexcept
	Returns a 16-element byte array that contains the value of this instance.

xtd::string	to_string () const noexcept override
	Returns a string representation of the value of this instance in registry format.

string	to_string (const string &format) const
	Returns a string representation of the value of this xtd::guid instance, according to the provided format specifier.

string	to_string (const string &format, const std::locale &loc) const override
	Returns a string representation of the value of this xtd::guid instance, according to the provided format specifier, and locale.

Public Static Methods
static guid	new_guid () noexcept
	Initializes a new instance of the xtd::guid structure.

Additional Inherited Members
Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object.

virtual type_object	get_type () const noexcept
	Gets the type of the current instance.

template<class object_t >
xtd::uptr< object_t >	memberwise_clone () const
	Creates a shallow copy of the current object.

Public Member Functions inherited from xtd::icomparable< guid >
Public Member Functions inherited from xtd::iequatable< guid >
Public Member Functions inherited from xtd::iformatable
Static Public Member Functions inherited from xtd::object
template<class object_a_t , class object_b_t >
static bool	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are considered equal.

template<class object_a_t , class object_b_t >
static bool	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are the same instance.

Constructor & Destructor Documentation

◆ guid() [1/8]

xtd::guid::guid ( )

default

Initializes a new instance of the xtd::guid structure.

◆ guid() [2/8]

xtd::guid::guid ( const xtd::array< xtd::byte > & data )

explicit

Initializes a new instance of the xtd::guid structure by using the specified array of bytes.

Parameters

bytes A 16-element byte array containing values with which to initialize the GUID.

Exceptions

xtd::argument_exception bytes is not 16 bytes long.

◆ guid() [3/8]

xtd::guid::guid ( const std::initializer_list< xtd::byte > & data )

explicit

Initializes a new instance of the xtd::guid structure by using the specified array of bytes.

Parameters

bytes A 16-element byte array containing values with which to initialize the GUID.

Exceptions

xtd::argument_exception bytes is not 16 bytes long.

◆ guid() [4/8]

xtd::guid::guid	(	int32	a,
		int16	b,
		int16	c,
		const xtd::array< xtd::byte > &	d
	)

explicit

Initializes a new instance of the xtd::guid structure by using the specified integers and byte array.

Parameters

a	The first 4 bytes of the GUID.
b	The next 2 bytes of the GUID.
c	The next 2 bytes of the GUID.
d	The remaining 8 bytes of the GUID.

Exceptions

xtd::argument_exception bytes is not 8 bytes long.

Initializes a new instance of the xtd::guid structure by using the specified integers and byte array.

Parameters

a	The first 4 bytes of the GUID.
b	The next 2 bytes of the GUID.
c	The next 2 bytes of the GUID.
d	The remaining 8 bytes of the GUID.

Exceptions

xtd::argument_exception bytes is not 8 bytes long.

◆ guid() [5/8]

xtd::guid::guid	(	uint32	a,
		uint16	b,
		uint16	c,
		const xtd::array< xtd::byte > &	d
	)

explicit

Initializes a new instance of the xtd::guid structure by using the specified unsigned integers and byte array.

Parameters

a	The first 4 bytes of the GUID.
b	The next 2 bytes of the GUID.
c	The next 2 bytes of the GUID.
d	The remaining 8 bytes of the GUID.

Exceptions

xtd::argument_exception bytes is not 8 bytes long.

Initializes a new instance of the xtd::guid structure by using the specified integers and byte array.

Parameters

a	The first 4 bytes of the GUID.
b	The next 2 bytes of the GUID.
c	The next 2 bytes of the GUID.
d	The remaining 8 bytes of the GUID.

Exceptions

xtd::argument_exception bytes is not 8 bytes long.

◆ guid() [6/8]

xtd::guid::guid	(	int32	a,
		int16	b,
		int16	c,
		xtd::byte	d,
		xtd::byte	e,
		xtd::byte	f,
		xtd::byte	g,
		xtd::byte	h,
		xtd::byte	i,
		xtd::byte	j,
		xtd::byte	k
	)

noexcept

Initializes a new instance of the xtd::guid structure by using the specified integers and bytes.

Parameters

a	The first 4 bytes of the GUID.
b	The next 2 bytes of the GUID.
c	The next 2 bytes of the GUID.
d	The next byte of the GUID.
e	The next byte of the GUID.
f	The next byte of the GUID.
g	The next byte of the GUID.
h	The next byte of the GUID.
i	The next byte of the GUID.
j	The next byte of the GUID.
k	The next byte of the GUID.

◆ guid() [7/8]

xtd::guid::guid	(	uint32	a,
		uint16	b,
		uint16	c,
		xtd::byte	d,
		xtd::byte	e,
		xtd::byte	f,
		xtd::byte	g,
		xtd::byte	h,
		xtd::byte	i,
		xtd::byte	j,
		xtd::byte	k
	)

noexcept

Initializes a new instance of the xtd::guid structure by using the specified unsigned integers and bytes.

Parameters

a	The first 4 bytes of the GUID.
b	The next 2 bytes of the GUID.
c	The next 2 bytes of the GUID.
d	The next byte of the GUID.
e	The next byte of the GUID.
f	The next byte of the GUID.
g	The next byte of the GUID.
h	The next byte of the GUID.
i	The next byte of the GUID.
j	The next byte of the GUID.
k	The next byte of the GUID.

◆ guid() [8/8]

xtd::guid::guid ( const string & guid )

explicit

Initializes a new instance of the xtd::guid structure by using the value represented by the specified string.

Parameters

guid A string that contains a GUID in one of the following formats ("d" represents a hexadecimal digit whose case is ignored): 32 contiguous digits: dddddddddddddddddddddddddddddddd -or- Groups of 8, 4, 4, 4, and 12 digits with hyphens between the groups. The entire GUID can optionally be enclosed in matching braces or parentheses: dddddddd-dddd-dddd-dddd-dddddddddddd -or- {dddddddd-dddd-dddd-dddd-dddddddddddd} -or- (dddddddd-dddd-dddd-dddd-dddddddddddd) -or- Groups of 8, 4, and 4 digits, and a subset of eight groups of 2 digits, with each group prefixed by "0x" or "0X", and separated by commas. The entire GUID, as well as the subset, is enclosed in matching braces: {0xdddddddd, 0xdddd, 0xdddd,{0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd}} All braces, commas, and "0x" prefixes are required. All embedded spaces are ignored. All leading zeros in a group are ignored. The digits shown in a group are the maximum number of meaningful digits that can appear in that group. You can specify from 1 to the number of digits shown for a group. The specified digits are assumed to be the low-order digits of the group.

Exceptions

xtd::format_exception The format of gui is invalid.

Remarks: The alphabetic hexadecimal digits in the g parameter can be uppercase or lowercase. For example, the following strings represent the same GUID:; "ca761232ed4211cebacd00aa0057b223"; "CA761232-ED42-11CE-BACD-00AA0057B223"; "{CA761232-ED42-11CE-BACD-00AA0057B223}"; "(CA761232-ED42-11CE-BACD-00AA0057B223)"; "{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}"

Member Function Documentation

◆ compare_to()

int32 xtd::guid::compare_to ( const guid & value ) const

overridevirtualnoexcept

Compares the current instance with another object of the same type.

Parameters

obj	An object to compare with this instance.

Returns: A 32-bit signed integer that indicates the relative order of the objects being compared. The return value has these meanings:

Value	Condition
Less than zero	This instance is less than obj.
Zero	This instance is equal to obj.
Greater than zero	This instance is greater than obj.

Implements xtd::icomparable< guid >.

◆ equals() [1/2]

bool xtd::guid::equals ( const object & obj ) const

overridevirtualnoexcept

Determines whether the specified object is equal to the current object.

Parameters

obj	The object to compare with the current object.

Returns: true if the specified object is equal to the current object. otherwise, false.

Reimplemented from xtd::object.

◆ equals() [2/2]

bool xtd::guid::equals ( const guid & g ) const

overridevirtualnoexcept

Determines whether the specified object is equal to the current object.

Parameters

g	The object to compare with the current object.

Returns: true if the specified object is equal to the current object. otherwise, false.

Implements xtd::iequatable< guid >.

◆ get_hash_code()

xtd::size xtd::guid::get_hash_code ( ) const

overridevirtualnoexcept

Serves as a hash function for a particular type.

Returns: A hash code for the current object.

Reimplemented from xtd::object.

◆ to_byte_array()

const xtd::array< xtd::byte > & xtd::guid::to_byte_array ( ) const

noexcept

Returns a 16-element byte array that contains the value of this instance.

Returns: A 16-element byte array.

◆ to_string() [1/3]

xtd::string xtd::guid::to_string ( ) const

overridevirtualnoexcept

Returns a string representation of the value of this instance in registry format.

Returns: The value of this xtd::guid, formatted by using the "D" format specifier as follows: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx where the value of the GUID is represented as a series of lowercase hexadecimal digits in groups of 8, 4, 4, 4, and 12 digits and separated by hyphens. An example of a return value is "382c74c3-721d-4f34-80e5-57657b6cbc27". To convert the hexadecimal digits from a through f to uppercase, call the string::to_string method on the returned string.

Remarks: This method provides a default GUID format that is sufficient for typical use; however, other versions of this method that take a format parameter provide a few common format variations.

Reimplemented from xtd::object.

◆ to_string() [2/3]

string xtd::guid::to_string ( const string & format ) const

Returns a string representation of the value of this xtd::guid instance, according to the provided format specifier.

Parameters

format A single format specifier that indicates how to format the value of this xtd::guid. The format parameter can be "N", "D", "B", "P", or "X". If format is null or an empty string (""), "D" is used.

Returns: The value of this xtd::guid, represented as a series of lowercase hexadecimal digits in the specified format.

Exceptions

xtd::format_exception The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

Remarks

The following table shows the accepted format specifiers for the format parameter. "0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

Specifier	Format of return value
N	32 digits:
	00000000000000000000000000000000
D	32 digits separated by hyphens:
	00000000-0000-0000-0000-000000000000
B	32 digits separated by hyphens, enclosed in braces:
	{00000000-0000-0000-0000-000000000000}
P	32 digits separated by hyphens, enclosed in parentheses:
	(00000000-0000-0000-0000-000000000000)
X	Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:
	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}

◆ to_string() [3/3]

string xtd::guid::to_string	(	const string &	format,
		const std::locale &	loc
	)		const

overridevirtual

Returns a string representation of the value of this xtd::guid instance, according to the provided format specifier, and locale.

Parameters

format	A single format specifier that indicates how to format the value of this xtd::guid. The format parameter can be "N", "D", "B", "P", or "X". If format is null or an empty string (""), "D" is used.
loc	An std::locale object that contains locale information (see std::locale).

Returns: The value of this xtd::guid, represented as a series of lowercase hexadecimal digits in the specified format.

Exceptions

xtd::format_exception The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

Remarks

The following table shows the accepted format specifiers for the format parameter. "0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

Specifier	Format of return value
N	32 digits:
	00000000000000000000000000000000
D	32 digits separated by hyphens:
	00000000-0000-0000-0000-000000000000
B	32 digits separated by hyphens, enclosed in braces:
	{00000000-0000-0000-0000-000000000000}
P	32 digits separated by hyphens, enclosed in parentheses:
	(00000000-0000-0000-0000-000000000000)
X	Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:
	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}

Implements xtd::iformatable.

◆ new_guid()

static guid xtd::guid::new_guid ( )

staticnoexcept

Initializes a new instance of the xtd::guid structure.

Returns: A new GUID object.

Remarks: This is a convenient static method that you can call to get a new guid.; The chance that the value of the new guid will be all zeros or equal to any other guid is very low. You can determine whether a GUID consists of all zeros by comparing it to guid::empty().

Member Data Documentation

◆ empty

const guid xtd::guid::empty

static

Gets A read-only instance of the xtd::guid structure whose value is all zeros.

Returns: xtd::guid A read-only instance of the xtd::guid structure whose value is all zeros.

Remarks: You can compare a GUID with the value of the xtd::guid.Empty field to determine whether a GUID is non-zero. The following example uses the Equality operator to compare two GUID values with xtd::guid.Empty to determine whether they consist exclusively of zeros.

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

xtd.core/include/xtd/guid.hpp

Definition

Public Fields

Public Constructors

Public Methods

Public Static Methods

Additional Inherited Members

Constructor & Destructor Documentation

◆ guid() [1/8]

◆ guid() [2/8]

◆ guid() [3/8]

◆ guid() [4/8]

◆ guid() [5/8]

◆ guid() [6/8]

◆ guid() [7/8]

◆ guid() [8/8]

Member Function Documentation

◆ compare_to()

◆ equals() [1/2]

◆ equals() [2/2]

◆ get_hash_code()

◆ to_byte_array()

◆ to_string() [1/3]

◆ to_string() [2/3]

◆ to_string() [3/3]

◆ new_guid()

Member Data Documentation

◆ empty