Class TLibAssoc

class TLibAssoc : public TLibAssocBase;

Description

Associates a dynamically loadable DLL and an instance of a class that, typically, will have been created using the ordinal 1 function of that DLL.

An object of this type is useful when cleanup behaviour requires that a class instance be deleted and the associated DLL be closed.

The DLL is expected to be already open when the TLibAssoc object is created.

Derivation

• TLibAssocBase - This is an implementation base class for TLibAssoc.

• TLibAssoc - ...

Members

Defined in TLibAssoc:

• Ptr()Gets a pointer to the class instance.
• PtrC()constGets a pointer to the const class instance.
• Set(const RLibrary &,T *)Makes an association between the specified DLL and an instance of the specified ...
• TLibAssoc()Default constructor.
• TLibAssoc(const RLibrary &,T *)Constructs the object taking the specified DLL and an instance of the specified ...
• Unload()Deletes the class instance and calls Close() on the associated DLL.
• operator T *()Conversion operator.
• operator TCleanupItem()The TCleanupItem conversion operator.
• operator TLibAssoc *()
• operator const T *()constConst conversion operator.
• operator->()Dereferencing operator.
• operator->()constConst dereferencing operator.

Inherited from TLibAssocBase:

• DoUnload(TAny *)Calls Close() on the associated DLL.
• IsNull()constTests whether the pointer to the class instance is NULL.
• Set(const RLibrary &,TAny *)Implements TLibAssoc::Set(const RLibrary &,T *).
• TLibAssocBase(const RLibrary &,TAny *)Constructs the object taking the specified DLL and a class instance.
• iPtrA Pointer to the class instance.

inline TLibAssoc();

Description

Default constructor.

An association between a DLL and a class instance can be made after construction using the TLibAssoc::Set(const RLibrary &,T *) function.

inline TLibAssoc(const RLibrary &aLib, T *aClass);

Description

Constructs the object taking the specified DLL and an instance of the specified class.

Parameters

const RLibrary &aLib A reference to a DLL that has already been opened. T *aClass A pointer to an object to be associated with the DLL. Typically, this object will have been created using the ordinal 1 function from that DLL.

inline void Set(const RLibrary &aLib, T *aClass);

Description

Makes an association between the specified DLL and an instance of the specified class.

Parameters

const RLibrary &aLib A reference to a DLL that has already been opened. T *aClass A pointer to an object to be associated with the DLL. Typically, this object will have been created using the ordinal 1 function from that DLL.

inline void Unload();

Description

Deletes the class instance and calls Close() on the associated DLL.

See also:

• RLibrary::Close()Closes the DLL.

inline operator TCleanupItem();

Description

The TCleanupItem conversion operator.

Invoked by the compiler when a TLibAssoc<T> type is passed to a function that is prototyped to take a TCleanupItem type.

The most common usage is to put a cleanup item onto the cleanup stack using CleanupStack::PushL(TAny *). The cleanup operation is represented by the private static function TLibAssoc::Cleanup(TAny *).

For example, if we declare

TLibAssoc<A> a;

then we can simply put a cleanup item onto the cleanup stack by calling

CleanupStack::PushL(a);

Return value

See also:

• TCleanupItem...
• CleanupStack::PushL(TAny *)Pushes a pointer to an object onto the cleanup stack.

operator TLibAssoc *();

Description

Return value

inline T* Ptr();

Description

Gets a pointer to the class instance.

Return value

T * A pointer to the class instance.

inline const T* PtrC() const;

Description

Gets a pointer to the const class instance.

Return value

const T * A pointer to the const class instance.

inline operator T *();

Description

Conversion operator.

Invoked by the compiler when a TLibAssoc<T> type is passed to a function that is prototyped to take a T* type.

Return value

inline operator const T *() const;

Description

Const conversion operator.

Invoked by the compiler when a TLibAssoc<T> type is passed to a function that is prototyped to take a const T* type.

Return value

inline T* operator->();

Description

Dereferencing operator.

Return value

T * A pointer to the class instance.

inline const T* operator->() const;

Description

Const dereferencing operator.

Return value

const T * A pointer to the const class instance.