InterfaceID Class Reference

Interface ID class. More...

#include <GaudiKernel/Kernel.h>

Public Member Functions
constexpr	InterfaceID (unsigned long id, unsigned long major, unsigned long minor=0)
	constructor from components More...
	InterfaceID (const char *name, unsigned long major, unsigned long minor=0)
	constructor from components More...
constexpr unsigned long	id () const
	get the interface identifier More...
constexpr unsigned long	majorVersion () const
	get the major version of the interface More...
constexpr unsigned long	minorVersion () const
	get the minor version of the interface More...
constexpr bool	versionMatch (const InterfaceID &iid) const
	check compatibility. More...
constexpr bool	fullMatch (const InterfaceID &iid) const
	check full compatibility. More...
constexpr bool	operator== (const InterfaceID &iid) const
	compare operator More...

Static Public Member Functions
static unsigned int	hash32 (const char *key)
	Jenkins one-at-time hash function – see https://en.wikipedia.org/wiki/Jenkins_hash_function. More...

Private Attributes
unsigned long	m_id
unsigned long	m_major_ver
unsigned long	m_minor_ver

Detailed Description

Interface ID class.

It consists of several fields: interface number, major version number and minor version number. Interface number should be allocated globally. The major and minor version numbers are used for checking compatibility between interface versions.

Author

Pere Mato

Sebastien Ponce

Definition at line 29 of file IInterface.h.

Constructor & Destructor Documentation

constexpr InterfaceID::InterfaceID ( unsigned long  id, unsigned long  major, unsigned long  minor = 0  )

inline

constructor from components

Definition at line 40 of file IInterface.h.

      : m_id( id ), m_major_ver( major ), m_minor_ver( minor )
  {
  }

InterfaceID::InterfaceID ( const char *  name, unsigned long  major, unsigned long  minor = 0  )

inline

constructor from components

Definition at line 45 of file IInterface.h.

      : m_id( hash32( name ) ), m_major_ver( major ), m_minor_ver( minor )
  {
  }

Member Function Documentation

constexpr bool InterfaceID::fullMatch ( const InterfaceID &  iid ) const

inline

check full compatibility.

Definition at line 67 of file IInterface.h.

  {
    return ( id() == iid.id() && majorVersion() == iid.majorVersion() && minorVersion() == iid.minorVersion() );
  }

static unsigned int InterfaceID::hash32 ( const char *  key )

inlinestatic

Jenkins one-at-time hash function – see https://en.wikipedia.org/wiki/Jenkins_hash_function.

Definition at line 74 of file IInterface.h.

  {
    unsigned int hash = 0;
    for ( const char* k = key; *k; ++k ) {
      hash += *k;
      hash += ( hash << 10 );
      hash ^= ( hash >> 6 );
    }
    hash += ( hash << 3 );
    hash ^= ( hash >> 11 );
    hash += ( hash << 15 );
    return hash;
  }

constexpr unsigned long InterfaceID::id ( ) const

inline

get the interface identifier

Definition at line 54 of file IInterface.h.

{ return m_id; }

constexpr unsigned long InterfaceID::majorVersion ( ) const

inline

get the major version of the interface

Definition at line 56 of file IInterface.h.

{ return m_major_ver; }

constexpr unsigned long InterfaceID::minorVersion ( ) const

inline

get the minor version of the interface

Definition at line 58 of file IInterface.h.

{ return m_minor_ver; }

constexpr bool InterfaceID::operator== ( const InterfaceID &  iid ) const

inline

compare operator

Definition at line 72 of file IInterface.h.

{ return fullMatch( iid ); }

constexpr bool InterfaceID::versionMatch ( const InterfaceID &  iid ) const

inline

check compatibility.

The major version is check and the minor one should be bigger or equal

Definition at line 62 of file IInterface.h.

  {
    return ( id() == iid.id() && majorVersion() == iid.majorVersion() && minorVersion() >= iid.minorVersion() );
  }

Member Data Documentation

unsigned long InterfaceID::m_id

private

Definition at line 89 of file IInterface.h.

unsigned long InterfaceID::m_major_ver

private

Definition at line 90 of file IInterface.h.

unsigned long InterfaceID::m_minor_ver

private

Definition at line 91 of file IInterface.h.

---

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

• GaudiKernel/GaudiKernel/IInterface.h