IInterface Class Reference

Definition of the basic interface. More...

#include <GaudiKernel/IInterface.h>

Inheritance diagram for IInterface:

Public Types
enum class	Status : StatusCode::code_t {   FAILURE = 0 , SUCCESS = 1 , NO_INTERFACE , VERSMISMATCH ,   LAST_ERROR }
	Return status. More...
using	iid = Gaudi::InterfaceId<IInterface, 0, 0>
	Interface ID.
using	ext_iids = Gaudi::interface_list<iid>
	Extra interfaces.

Public Member Functions
template<Gaudi::IsInterface TARGET>
TARGET *	cast ()
template<Gaudi::IsInterface TARGET>
TARGET const *	cast () const
template<typename TARGET> requires ( !Gaudi::IsInterface<TARGET> )
TARGET *	cast ()
template<typename TARGET> requires ( !Gaudi::IsInterface<TARGET> )
TARGET const *	cast () const
virtual std::vector< std::string >	getInterfaceNames () const =0
	Returns a vector of strings containing the names of all the implemented interfaces.
virtual unsigned long	addRef () const =0
	Increment the reference count of Interface instance.
virtual unsigned long	release () const =0
	Release Interface instance.
virtual unsigned long	refCount () const =0
	Current reference count.
virtual StatusCode	queryInterface (const InterfaceID &ti, void **pp)=0
	Set the void** to the pointer to the requested interface of the instance.
virtual	~IInterface ()=default
	Virtual destructor.
virtual void const *	i_cast (const InterfaceID &) const =0
void *	i_cast (const InterfaceID &iid)

Static Public Member Functions
static const InterfaceID &	interfaceID ()
	Return an instance of InterfaceID identifying the interface.

Protected Member Functions
virtual unsigned long	decRef () const =0
	Decrement reference count and return the new reference count.

Detailed Description

Definition of the basic interface.

Author

Pere Mato

Markus Frank

Marco Clemencic

Definition at line 225 of file IInterface.h.

Member Typedef Documentation

ext_iids

using IInterface::ext_iids = Gaudi::interface_list<iid>

Extra interfaces.

Definition at line 231 of file IInterface.h.

iid

using IInterface::iid = Gaudi::InterfaceId<IInterface, 0, 0>

Interface ID.

Definition at line 228 of file IInterface.h.

Member Enumeration Documentation

Status

enum class IInterface::Status : StatusCode::code_t

strong

Return status.

Enumerator
FAILURE	Failure.
SUCCESS	Normal successful completion.
NO_INTERFACE	Requested interface is not available.
VERSMISMATCH	Requested interface version is incompatible.
LAST_ERROR	Last error.

Definition at line 300 of file IInterface.h.

                    : StatusCode::code_t {
    FAILURE = 0,
    SUCCESS = 1,
    NO_INTERFACE,
    VERSMISMATCH,
    LAST_ERROR
  };

Constructor & Destructor Documentation

~IInterface()

virtual IInterface::~IInterface ( )

virtualdefault

Virtual destructor.

Member Function Documentation

addRef()

virtual unsigned long IInterface::addRef ( ) const

pure virtual

Increment the reference count of Interface instance.

cast() [1/4]

template<Gaudi::IsInterface TARGET>

TARGET * IInterface::cast ( )

inline

Definition at line 237 of file IInterface.h.

                 {
    if ( auto output = i_cast( TARGET::interfaceID() ) ) { return reinterpret_cast<TARGET*>( output ); }
    if constexpr ( Gaudi::IsInterface<TARGET> ) {
      void* tgt = nullptr;
      queryInterface( TARGET::interfaceID(), &tgt ).ignore();
      if ( tgt ) {
        // queryInterface bumps the reference count of the target object, but we should not
        auto* target = reinterpret_cast<TARGET*>( tgt );
        // we cannot use release() because we may be called with an object with initial reference count of 0 and that
        // would delete the object
        static_cast<const IInterface*>( target )->decRef();
        return target;
      }
    }
    return nullptr;
  }

cast() [2/4]

template<typename TARGET>
requires ( !Gaudi::IsInterface<TARGET> )

TARGET * IInterface::cast ( )

inline

Definition at line 274 of file IInterface.h.

                 {
    return dynamic_cast<TARGET*>( this );
  }

cast() [3/4]

template<Gaudi::IsInterface TARGET>

TARGET const * IInterface::cast ( ) const

inline

Definition at line 255 of file IInterface.h.

                             {
    if ( auto output = i_cast( TARGET::interfaceID() ) ) { return reinterpret_cast<TARGET const*>( output ); }
    if constexpr ( Gaudi::IsInterface<TARGET> ) {
      void* tgt = nullptr;
      const_cast<IInterface*>( this )->queryInterface( TARGET::interfaceID(), &tgt ).ignore();
      if ( tgt ) {
        // queryInterface bumps the reference count of the target object, but we should not
        auto* target = reinterpret_cast<const TARGET*>( tgt );
        // we cannot use release() because we may be called with an object with initial reference count of 0 and that
        // would delete the object
        static_cast<const IInterface*>( target )->decRef();
        return target;
      }
    }
    return nullptr;
  }

cast() [4/4]

template<typename TARGET>
requires ( !Gaudi::IsInterface<TARGET> )

TARGET const * IInterface::cast ( ) const

inline

Definition at line 280 of file IInterface.h.

                             {
    return dynamic_cast<TARGET const*>( this );
  }

decRef()

virtual unsigned long IInterface::decRef ( ) const

protectedpure virtual

Decrement reference count and return the new reference count.

getInterfaceNames()

virtual std::vector< std::string > IInterface::getInterfaceNames ( ) const

pure virtual

Returns a vector of strings containing the names of all the implemented interfaces.

i_cast() [1/2]

virtual void const * IInterface::i_cast ( const InterfaceID & ) const

pure virtual

i_cast() [2/2]

void * IInterface::i_cast ( const InterfaceID & iid )

inline

Definition at line 320 of file IInterface.h.

                                         {
    return const_cast<void*>( const_cast<const IInterface*>( this )->i_cast( iid ) );
  }

interfaceID()

static const InterfaceID & IInterface::interfaceID ( )

inlinestatic

Return an instance of InterfaceID identifying the interface.

Definition at line 234 of file IInterface.h.

{ return iid::interfaceID(); }

queryInterface()

virtual StatusCode IInterface::queryInterface ( const InterfaceID & ti, void ** pp )

pure virtual

Set the void** to the pointer to the requested interface of the instance.

refCount()

virtual unsigned long IInterface::refCount ( ) const

pure virtual

Current reference count.

release()

virtual unsigned long IInterface::release ( ) const

pure virtual

Release Interface instance.

---

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

• GaudiKernel/include/GaudiKernel/IInterface.h