PTLib
Version 2.10.4
|
Globally unique ID definition. More...
#include <guid.h>
Public Member Functions | |
Construction | |
PGloballyUniqueID () | |
Create a new ID. | |
PGloballyUniqueID (const char *cstr) | |
Create an ID from a C string of hex (as produced by AsString()). | |
PGloballyUniqueID (const PString &str) | |
Create an ID from a PString of hex (as produced by AsString()). | |
Overrides from PObject | |
virtual void | PrintOn (ostream &strm) const |
Standard stream print function. | |
virtual void | ReadFrom (istream &strm) |
Standard stream read function. | |
virtual PObject * | Clone () const |
Create a clone of the ID. | |
virtual PINDEX | HashFunction () const |
Get the hash value for the ID. | |
Operations | |
PString | AsString () const |
Convert the ID to human readable string. | |
PBoolean | IsNULL () const |
Test if the GUID is null, ie consists of all zeros. | |
PBoolean | operator! () const |
![]() | |
PBYTEArray (PINDEX initialSize=0) | |
Construct a new dynamic array of unsigned chars. | |
PBYTEArray (BYTE const *buffer, PINDEX length, PBoolean dynamic=true) | |
Construct a new dynamic array of unsigned chars. | |
![]() | |
PBaseArray (PINDEX initialSize=0) | |
Construct a new dynamic array of elements of the specified type. | |
PBaseArray (T const *buffer, PINDEX length, PBoolean dynamic=true) | |
Construct a new dynamic array of elements of the specified type. | |
PBoolean | SetAt (PINDEX index, T val) |
Set the specific element in the array. | |
T | GetAt (PINDEX index) const |
Get a value from the array. | |
void | Attach (const T *buffer, PINDEX bufferSize) |
Attach a pointer to a static block to the base array type. | |
T * | GetPointer (PINDEX minSize=0) |
Get a pointer to the internal array and assure that it is of at least the specified size. | |
T | operator[] (PINDEX index) const |
Get a value from the array. | |
T & | operator[] (PINDEX index) |
Get a reference to value from the array. | |
operator T const * () const | |
Get a pointer to the internal array. | |
PBoolean | Concatenate (const PBaseArray &array) |
Concatenate one array to the end of this array. | |
![]() | |
PAbstractArray (PINDEX elementSizeInBytes, PINDEX initialSize=0) | |
Create a new dynamic array of initalSize elements of elementSizeInBytes bytes each. | |
PAbstractArray (PINDEX elementSizeInBytes, const void *buffer, PINDEX bufferSizeInElements, PBoolean dynamicAllocation) | |
Create a new dynamic array of bufferSizeInElements elements of elementSizeInBytes bytes each. | |
virtual Comparison | Compare (const PObject &obj) const |
Get the relative rank of the two arrays. | |
virtual PBoolean | SetSize (PINDEX newSize) |
Set the size of the array in elements. | |
void | Attach (const void *buffer, PINDEX bufferSize) |
Attach a pointer to a static block to the base array type. | |
PBoolean | Concatenate (const PAbstractArray &array) |
Concatenate one array to the end of this array. | |
![]() | |
PContainer (PINDEX initialSize=0) | |
Create a new unique container. | |
PContainer (const PContainer &cont) | |
Create a new refernce to container. | |
PContainer & | operator= (const PContainer &cont) |
Assign one container reference to another. | |
virtual | ~PContainer () |
Destroy the container class. | |
virtual PINDEX | GetSize () const |
Get the current size of the container. | |
PBoolean | SetMinSize (PINDEX minSize) |
Set the minimum size of container. | |
virtual PBoolean | IsEmpty () const |
Determine if the container is empty. | |
PBoolean | IsUnique () const |
Determine if container is unique reference. | |
virtual PBoolean | MakeUnique () |
Make this instance to be the one and only reference to the container contents. | |
![]() | |
virtual | ~PObject () |
virtual Comparison | CompareObjectMemoryDirect (const PObject &obj) const |
Determine the byte wise comparison of two objects. | |
bool | operator== (const PObject &obj) const |
Compare the two objects. | |
bool | operator!= (const PObject &obj) const |
Compare the two objects. | |
bool | operator< (const PObject &obj) const |
Compare the two objects. | |
bool | operator> (const PObject &obj) const |
Compare the two objects. | |
bool | operator<= (const PObject &obj) const |
Compare the two objects. | |
bool | operator>= (const PObject &obj) const |
Compare the two objects. | |
virtual const char * | GetClass (unsigned ancestor=0) const |
Get the current dynamic type of the object instance. | |
PBoolean | IsClass (const char *cls) const |
virtual PBoolean | InternalIsDescendant (const char *clsName) const |
Determine if the dynamic type of the current instance is a descendent of the specified class. |
Additional Inherited Members | |
![]() | |
enum | Comparison { LessThan = -1, EqualTo = 0, GreaterThan = 1 } |
Result of the comparison operation performed by the Compare() function. More... | |
![]() | |
static Comparison | InternalCompareObjectMemoryDirect (const PObject *obj1, const PObject *obj2, PINDEX size) |
Internal function caled from CompareObjectMemoryDirect() | |
static const char * | Class () |
Get the name of the class as a C string. | |
![]() | |
virtual void | PrintElementOn (ostream &stream, PINDEX index) const |
PBaseArray (PContainerReference &reference) | |
![]() | |
PINDEX | elementSize |
Size of an element in bytes. | |
char * | theArray |
Pointer to the allocated block of memory. | |
PBoolean | allocatedDynamically |
Flag indicating the array was allocated on the heap. | |
![]() |
Globally unique ID definition.
This implements a 128 bit globally unique ID as required by many protocols and software systems. The value is constructed in such a way as to make a duplicate anywhere in the world highly unlikely.
PGloballyUniqueID::PGloballyUniqueID | ( | ) |
Create a new ID.
The ID created with this will be initialised to a globally unique ID as per specification.
PGloballyUniqueID::PGloballyUniqueID | ( | const char * | cstr | ) |
Create an ID from a C string of hex (as produced by AsString()).
A useful construct is to construct a OpalGloballyUniqueID() with NULL which produces an all zero GUID, detectable with the IsNULL() function.
cstr | C string to convert |
PGloballyUniqueID::PGloballyUniqueID | ( | const PString & | str | ) |
Create an ID from a PString of hex (as produced by AsString()).
str | String of hex to convert |
PString PGloballyUniqueID::AsString | ( | ) | const |
Convert the ID to human readable string.
|
virtual |
Create a clone of the ID.
The duplicate ID has the same value as the source. Required for having this object as a key in dictionaries.
Reimplemented from PBaseArray< T >.
|
virtual |
Get the hash value for the ID.
Creates a number based on the ID value for use in the hash table of a dictionary. Required for having this object as a key in dictionaries.
Reimplemented from PObject.
PBoolean PGloballyUniqueID::IsNULL | ( | ) | const |
Test if the GUID is null, ie consists of all zeros.
Referenced by operator!().
|
virtual |
Standard stream print function.
The PObject class has a << operator defined that calls this function polymorphically.
strm | Stream to output text representation |
Reimplemented from PAbstractArray.
|
virtual |
Standard stream read function.
The PObject class has a >> operator defined that calls this function polymorphically.
strm | Stream to output text representation |
Reimplemented from PAbstractArray.