| The Gaudi Framework v29r1 (5cd95fa2)

- Main Page
- Related Pages
- Modules
- Namespaces
- Classes
- Files

- Class List
- Class Index
- Class Hierarchy
- Class Members

Public Member Functions | Static Public Member Functions | Private Attributes | List of all members
InterfaceID Class Referencefinal

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.

41 : m_id( id ), m_major_ver( major ), m_minor_ver( minor )
42 {
43 }
InterfaceID::m_id
unsigned long m_id
Definition: IInterface.h:89
InterfaceID::m_minor_ver
unsigned long m_minor_ver
Definition: IInterface.h:91
InterfaceID::m_major_ver
unsigned long m_major_ver
Definition: IInterface.h:90

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

constructor from components

Definition at line 45 of file IInterface.h.

46 : m_id( hash32( name ) ), m_major_ver( major ), m_minor_ver( minor )
47 {
48 }
gaudiComponentHelp.name
name
Definition: gaudiComponentHelp.py:32
InterfaceID::hash32
static unsigned int hash32(const char *key)
Jenkins one-at-time hash function – see https://en.wikipedia.org/wiki/Jenkins_hash_function.
Definition: IInterface.h:74
InterfaceID::m_id
unsigned long m_id
Definition: IInterface.h:89
InterfaceID::m_minor_ver
unsigned long m_minor_ver
Definition: IInterface.h:91
InterfaceID::m_major_ver
unsigned long m_major_ver
Definition: IInterface.h:90

## Member Function Documentation

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

check full compatibility.

Definition at line 67 of file IInterface.h.

68 {
69 return ( id() == iid.id() && majorVersion() == iid.majorVersion() && minorVersion() == iid.minorVersion() );
70 }
InterfaceID::minorVersion
constexpr unsigned long minorVersion() const
get the minor version of the interface
Definition: IInterface.h:58
InterfaceID::id
constexpr unsigned long id() const
get the interface identifier
Definition: IInterface.h:54
InterfaceID::majorVersion
constexpr unsigned long majorVersion() const
get the major version of the interface
Definition: IInterface.h:56

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

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

Definition at line 74 of file IInterface.h.

75 {
76 unsigned int hash = 0;
77 for ( const char* k = key; *k; ++k ) {
78 hash += *k;
79 hash += ( hash << 10 );
80 hash ^= ( hash >> 6 );
81 }
82 hash += ( hash << 3 );
83 hash ^= ( hash >> 11 );
84 hash += ( hash << 15 );
85 return hash;
86 }

constexpr unsigned long InterfaceID::id | ( |  | ) | const
| inline

get the interface identifier

Definition at line 54 of file IInterface.h.

54 { return m_id; }
InterfaceID::m_id
unsigned long m_id
Definition: IInterface.h:89

constexpr unsigned long InterfaceID::majorVersion | ( |  | ) | const
| inline

get the major version of the interface

Definition at line 56 of file IInterface.h.

56 { return m_major_ver; }
InterfaceID::m_major_ver
unsigned long m_major_ver
Definition: IInterface.h:90

constexpr unsigned long InterfaceID::minorVersion | ( |  | ) | const
| inline

get the minor version of the interface

Definition at line 58 of file IInterface.h.

58 { return m_minor_ver; }
InterfaceID::m_minor_ver
unsigned long m_minor_ver
Definition: IInterface.h:91

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

compare operator

Definition at line 72 of file IInterface.h.

72 { return fullMatch( iid ); }
InterfaceID::fullMatch
constexpr bool fullMatch(const InterfaceID &iid) const
check full compatibility.
Definition: IInterface.h:67

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.

63 {
64 return ( id() == iid.id() && majorVersion() == iid.majorVersion() && minorVersion() >= iid.minorVersion() );
65 }
InterfaceID::minorVersion
constexpr unsigned long minorVersion() const
get the minor version of the interface
Definition: IInterface.h:58
InterfaceID::id
constexpr unsigned long id() const
get the interface identifier
Definition: IInterface.h:54
InterfaceID::majorVersion
constexpr unsigned long majorVersion() const
get the major version of the interface
Definition: IInterface.h:56

## 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