gzGuid.h

Go to the documentation of this file.

//*****************************************************************************
// File         : gzGuid.h
// Module       : gzBase
// Description  : Class definition of GUID types
// Author       : Anders Modén      
// Product      : GizmoBase 2.1.1
//      
// Copyright © 2003- Saab Training Systems AB, Sweden
//          
// NOTE:    GizmoBase is a platform abstraction utility layer for C++. It contains 
//          design patterns and C++ solutions for the advanced programmer.
//
//
// Revision History...                          
//                                  
// Who  Date    Description                     
//                                  
// AMO  980819  Created file    
//
//******************************************************************************

#ifndef __GZ_GUID_H__
#define __GZ_GUID_H__

#include "gzBasicTypes.h"
#include "gzTime.h"

class gzString; // Forward decl
class gzMutex;

//*********************************** GUID *************************************

class GZ_BASE_EXPORT gzGUIDBytes
{
public:

    gzGUIDBytes(gzUByte b1=0,gzUByte b2=0,gzUByte b3=0,gzUByte b4=0,gzUByte b5=0,gzUByte b6=0,gzUByte b7=0,gzUByte b8=0);

    gzUByte b1,b2,b3,b4,b5,b6,b7,b8;
};

#ifndef WIN32   // We don't have any built in GUID definition

    typedef struct _GUID
    {
        gzULong  Data1;
        gzUShort Data2;
        gzUShort Data3;
        gzUByte  Data4[8];
    } GUID;

#endif

class GZ_BASE_EXPORT gzGUID
{
public:

    // Creation

    gzGUID();
    gzGUID(const GUID & guid);
    gzGUID(const gzULong data1, const gzUShort data2 = 0, const gzUShort data3 = 0, const gzGUIDBytes & data4 = 0);
    gzGUID(const gzString &format);
    gzGUID(const gzWideChar *ustring, gzULong len=0);
    gzGUID(const gzChar *cstring, gzULong len=0);
    gzGUID(const gzULongLong& val1, const gzULongLong& val2);


    // Casts & Tests

    gzBool operator==(const gzGUID &right) const;
    gzBool operator!=(const gzGUID &right) const;
    gzBool operator<(const gzGUID &right) const;

    gzBool operator==(const GUID &right) const;
    gzBool operator!=(const GUID &right) const;

    operator GUID & ();

    gzGUID &operator=(const GUID &right);

    // Methods

    GUID &      getGUID();
    const GUID &getConstGUID() const;
    gzVoid      generate(); // Generate a new GUID
    gzVoid      reset();    // Generate NULL guid

    gzBool      isNull() const;
    gzBool      isStandardDCE() const;
    gzBool      isRandomBased() const;
    gzBool      isTimeBased() const;
    gzBool      isNameBased() const;

    gzTime      getGenerationTime() const;
    gzString    asString() const;
    gzVoid      getGUID(gzULong& val1, gzULong& val2, gzULong& val3, gzULong& val4) const;
    gzVoid      getGUID(gzULongLong& val1, gzULongLong& val2) const;
    
    gzULong     hash() const;   // If the GUID value <= 32bits (gzULong), the value is returned unchanged.

    static gzGUID   generateGUID(); // Generate a new GUID

private:

    union
    {
        GUID guid;

        struct
        {
            gzULongLong data1;
            gzULongLong data2;
        } lldata;

        struct
        {
            gzULong data1;
            gzULong data2;
            gzULong data3;
            gzULong data4;
        } ldata;

    } data;
};

#endif // __GZ_GUID_H__

---