Uuid.h

Go to the documentation of this file.

/*------------------------------------------------------------------------------
 
    Copyright (c) 2004 Media Development Loan Fund
  
    This file is part of the Campcaster project.
    https://www.campware.org/
    To report bugs, send an e-mail to [email protected]
  
    Campcaster is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
   
    Campcaster is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
  
    You should have received a copy of the GNU General Public License
    along with Campcaster; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  
 
    This code is based upon the Leach working draft for UUIDs,
    http://www.opengroup.org/dce/info/draft-leach-uuids-guids-01.txt
    and the sample code therein.
    The original copyright message of the sample code is the following:
 
** Copyright (c) 1990- 1993, 1996 Open Software Foundation, Inc.
** Copyright (c) 1989 by Hewlett-Packard Company, Palo Alto, Ca. &
** Digital Equipment Corporation, Maynard, Mass.
** Copyright (c) 1998 Microsoft.
** To anyone who acknowledges that this file is provided "AS IS"
** without any express or implied warranty: permission to use, copy,
** modify, and distribute this file for any purpose is hereby
** granted without fee, provided that the above copyright notices and
** this notice appears in all source code copies, and that none of
** the names of Open Software Foundation, Inc., Hewlett-Packard
** Company, or Digital Equipment Corporation be used in advertising
** or publicity pertaining to distribution of the software without
** specific, written prior permission.  Neither Open Software
** Foundation, Inc., Hewlett-Packard Company, Microsoft, nor Digital Equipment
** Corporation makes any representations about the suitability of
** this software for any purpose.
 
  
    Author   : $Author: fgerlits $
    Version  : $Revision: 2329 $
    Location : $URL: svn://code.campware.org/campcaster/trunk/campcaster/src/modules/core/include/LiveSupport/Core/Uuid.h $
 
------------------------------------------------------------------------------*/
#ifndef LiveSupport_Core_Uuid_h
 #define LiveSupport_Core_Uuid_h
 
#ifndef __cplusplus
 #error This is a C++ include file
 #endif
 

/* ============================================================ include files */

#ifdef HAVE_CONFIG_H
 #include "configure.h"
#endif
 
#ifdef HAVE_STDINT_H
 #include <stdint.h>
#else
 #error need stdint.h
 #endif
 

#include <string>
#include "LiveSupport/Core/Ptr.h"

namespace LiveSupport {
namespace Core {

/* ================================================================ constants */


/* =================================================================== macros */


/* =============================================================== data types */

class Uuid
{
    private:
        typedef uint64_t        UuidTime;

        typedef struct {
            char            nodeId[6];
        } UuidNode;

        long long int   id;

        std::string     idAsString;

        uint32_t        timeLow;

        uint16_t        timeMid;

        uint16_t        timeHiAndVersion;

        uint8_t         clockSeqHiAndReserved;

        uint8_t         clockSeqLow;

        uint8_t         node[6];

        Uuid(void)                          throw ()
        {
        }

        static bool
        compare(const Uuid    & id1,
                const Uuid    & id2)                                throw ();

        static void
        getCurrentTime(UuidTime   * timestamp)              throw ();

        static uint16_t
        trueRandom(void)                                    throw ();

        int
        readState(uint16_t    * clockSeq,
                  UuidTime    * timestamp,
                  UuidNode    * node)                       throw ();

        void
        writeState(uint16_t     clockSeq,
                   UuidTime     timestamp,
                   UuidNode     node)                       throw ();

        void
        format(uint16_t     clockSeq,
               UuidTime     timestamp,
               UuidNode     node)                           throw ();

        static void
        getSystemTime(UuidTime * uuidTime)                          throw ();

        static void
        getIeeeNodeIdentifier(UuidNode    * node)                   throw ();

        void
        representAsString(void)                                     throw ();


    public:
        static Ptr<Uuid>::Ref
        generateId(void)                        throw ();

        bool
        operator==(const Uuid & otherId) const              throw ()
        {
            return compare(*this, otherId);
        }

        bool
        operator!=(const Uuid & otherId) const              throw ()
        {
            return !compare(*this, otherId);
        }

        operator std::string() const            throw ()
        {
            return idAsString;
        }
};


/* ================================================= external data structures */


/* ====================================================== function prototypes */

inline std::ostream &
operator<< (std::ostream      & os,
            const Uuid        & id)
{
    os << (std::string) id;

    return os;
}


} // namespace Core
} // namespace LiveSupport

#endif // LiveSupport_Core_Uuid_h
 

---