Auxiliary base class for function adaptor. More...

#include <JFunctionAdaptor.hh>

Inheritance diagram for JEEP::JFunctionAdaptorHelper< __pF__ >:

Public Member Functions
virtual	~JFunctionAdaptorHelper ()
	Virtual destructor.

bool	is_valid () const
	Check validity of function.

void	reset ()
	Reset function adaptor helper.

void	set (__pF__ pf)
	Set function.

void	get (const char *symbol)
	Get function with given name according to specific protocol.

bool	is_open () const
	Check if shared library file is open.

void	open (const char *file_name)
	Open file.

void	close ()
	Close file.

void	load (const std::string &libso, const std::string &symbol)
	Load function from shared library.

void	reload ()
	Reload function from shared library.

void	initialise ()
	Initialise counter.

void	attach (const JSharedCounter &object)
	Attach this counter to given shared counter object.

bool	detach ()
	Detach.

const int	getCount ()
	Get count.

Static Public Attributes
static const char	SEPARATOR = ':'
	Separation character between library file name and function name.

Protected Member Functions
	JFunctionAdaptorHelper ()
	Default constructor.

	JFunctionAdaptorHelper (__pF__ pf)
	Constructor.

	JFunctionAdaptorHelper (const std::string &libso, const std::string &symbol)
	Constructor.

	JFunctionAdaptorHelper (const JFunctionAdaptorHelper &helper)
	Copy constructor.

Protected Attributes
void *	handle

__pF__	function

std::string	libso

std::string	symbol

int *	counter

Friends
std::istream &	operator>> (std::istream &in, JFunctionAdaptorHelper &object)
	Read function adaptor helper from input stream.

std::ostream &	operator<< (std::ostream &out, const JFunctionAdaptorHelper &object)
	Write function adaptor helper to output stream.

Detailed Description

template<class __pF__>
struct JEEP::JFunctionAdaptorHelper< __pF__ >

Auxiliary base class for function adaptor.

Note that the dynamic load library internally maintains link counts for the file handles.

Definition at line 33 of file JFunctionAdaptor.hh.

Constructor & Destructor Documentation

◆ ~JFunctionAdaptorHelper()

template<class __pF__ >

virtual JEEP::JFunctionAdaptorHelper< __pF__ >::~JFunctionAdaptorHelper ( )

inlinevirtual

Virtual destructor.

Definition at line 45 of file JFunctionAdaptor.hh.

    {
      reset();
    }

◆ JFunctionAdaptorHelper() [1/4]

template<class __pF__ >

JEEP::JFunctionAdaptorHelper< __pF__ >::JFunctionAdaptorHelper ( )

inlineprotected

Default constructor.

Definition at line 242 of file JFunctionAdaptor.hh.

                             :
      handle  (NULL),
      function(NULL)
    {}

◆ JFunctionAdaptorHelper() [2/4]

template<class __pF__ >

JEEP::JFunctionAdaptorHelper< __pF__ >::JFunctionAdaptorHelper ( __pF__ pf )

inlineprotected

Constructor.

Parameters

pf	pointer to function

Definition at line 253 of file JFunctionAdaptor.hh.

                                      :
      handle  (NULL),
      function(pf)
    {}

◆ JFunctionAdaptorHelper() [3/4]

template<class __pF__ >

JEEP::JFunctionAdaptorHelper< __pF__ >::JFunctionAdaptorHelper	(	const std::string &	libso,
		const std::string &	symbol )

inlineprotected

Constructor.

Parameters

libso	file name
symbol	function name

Definition at line 265 of file JFunctionAdaptor.hh.

                                                    :
      handle  (NULL),
      function(NULL)
    {
      this->load(libso, symbol);
    }

◆ JFunctionAdaptorHelper() [4/4]

template<class __pF__ >

JEEP::JFunctionAdaptorHelper< __pF__ >::JFunctionAdaptorHelper ( const JFunctionAdaptorHelper< __pF__ > & helper )

inlineprotected

Copy constructor.

Parameters

helper helper

Definition at line 279 of file JFunctionAdaptor.hh.

                                                                 :
      handle  (helper.handle),
      function(helper.function),
      libso   (helper.libso),
      symbol  (helper.symbol)
    {
      if (is_open()) {
        attach(helper);
      }
    }

Member Function Documentation

◆ is_valid()

template<class __pF__ >

bool JEEP::JFunctionAdaptorHelper< __pF__ >::is_valid ( ) const

inline

Check validity of function.

Returns: true if valid function; else false

Definition at line 56 of file JFunctionAdaptor.hh.

    {
      return (function != NULL);
    }

◆ reset()

template<class __pF__ >

void JEEP::JFunctionAdaptorHelper< __pF__ >::reset ( )

inline

Reset function adaptor helper.

Definition at line 65 of file JFunctionAdaptor.hh.

    {
      if (detach()) {
        close();
      }
      
      function = NULL;
    }

◆ set()

template<class __pF__ >

void JEEP::JFunctionAdaptorHelper< __pF__ >::set ( __pF__ pf )

inline

Set function.

Parameters

pf	pointer to function

Definition at line 80 of file JFunctionAdaptor.hh.

    {
      reset();
      
      function = pf;
    }

◆ get()

template<class __pF__ >

void JEEP::JFunctionAdaptorHelper< __pF__ >::get ( const char * symbol )

inline

Get function with given name according to specific protocol.

Parameters

symbol function name

Definition at line 93 of file JFunctionAdaptor.hh.

    {
      function = NULL;
 
      if (handle != NULL) {
 
        dlerror();                 // reset errors
 
        function = (__pF__) dlsym(handle, symbol);
 
        const char* error = dlerror();
 
        if (error != NULL) {
          THROW(JFileReadException, error);
        }
 
      } else {
 
        THROW(JFileReadException, "Invalid handle.");
      }
    }

◆ is_open()

template<class __pF__ >

bool JEEP::JFunctionAdaptorHelper< __pF__ >::is_open ( ) const

inline

Check if shared library file is open.

Returns: true if open; else false

Definition at line 121 of file JFunctionAdaptor.hh.

    {
      return (handle != NULL);
    }

◆ open()

template<class __pF__ >

void JEEP::JFunctionAdaptorHelper< __pF__ >::open ( const char * file_name )

inline

Open file.

Parameters

file_name file name

Definition at line 132 of file JFunctionAdaptor.hh.

    {
      reset();
      
      handle = dlopen(file_name, RTLD_LOCAL | RTLD_LAZY);
 
      if (!handle) {
        THROW(JFileOpenException, dlerror());
      }
 
      initialise();
    }

◆ close()

template<class __pF__ >

void JEEP::JFunctionAdaptorHelper< __pF__ >::close ( )

inline

Close file.

Note that the file should remain open as long as the library function is used.

Definition at line 151 of file JFunctionAdaptor.hh.

    {
      if (handle != NULL) {
        dlclose(handle);
        dlclose(handle);
      }
 
      handle = NULL;
    }

◆ load()

template<class __pF__ >

void JEEP::JFunctionAdaptorHelper< __pF__ >::load	(	const std::string &	libso,
		const std::string &	symbol )

inline

Load function from shared library.

Parameters

libso	file name
symbol	function name

Definition at line 168 of file JFunctionAdaptor.hh.

    {
      this->libso  = libso;
      this->symbol = symbol;
 
      reload();
    }

◆ reload()

template<class __pF__ >

void JEEP::JFunctionAdaptorHelper< __pF__ >::reload ( )

inline

Reload function from shared library.

Definition at line 180 of file JFunctionAdaptor.hh.

    {
      open(libso.c_str());
 
      get(symbol.c_str());
    }

◆ initialise()

void JLANG::JSharedCounter::initialise ( )

inlineinherited

Initialise counter.

Definition at line 33 of file JSharedCounter.hh.

    {
      detach();
 
      counter = new int(1);
    }

◆ attach()

void JLANG::JSharedCounter::attach ( const JSharedCounter & object )

inlineinherited

Attach this counter to given shared counter object.

Parameters

object shared counter

Definition at line 46 of file JSharedCounter.hh.

    {
      detach();
 
      counter = object.counter;
 
      if (counter != NULL) {
        ++(*counter);
      }
    }

◆ detach()

bool JLANG::JSharedCounter::detach ( )

inlineinherited

Detach.

Returns: true if counter at zero; else false

Definition at line 63 of file JSharedCounter.hh.

    {
      if (counter != NULL) {
 
        if (--(*counter) == 0) {
 
          delete counter;
 
          counter = NULL;
 
          return true;
        }
 
        counter = NULL;
      }
 
      return false;
    }

◆ getCount()

const int JLANG::JSharedCounter::getCount ( )

inlineinherited

Get count.

Returns: count

Definition at line 88 of file JSharedCounter.hh.

    {
      return (counter != NULL ? *counter : 0);
    }

Friends And Related Symbol Documentation

◆ operator>>

template<class __pF__ >

std::istream & operator>>	(	std::istream &	in,
		JFunctionAdaptorHelper< __pF__ > &	object )

friend

Read function adaptor helper from input stream.

The input format should be conform <file name>[SEPARATOR<symbol>].

Parameters

in	input stream
object	function adaptor helper

Returns: input stream

Definition at line 197 of file JFunctionAdaptor.hh.

    {
      using namespace std;
 
      object.reset();
 
      string buffer;
 
      if (in >> buffer) {
      
        const string::size_type pos = buffer.rfind(SEPARATOR);
 
        if (pos != string::npos) {
 
          object.libso  = buffer.substr(0,pos);
          object.symbol = buffer.substr(pos+1);
 
        } else {
 
          object.libso  = buffer;
        }
 
        object.reload();
      }
      
      return in;
    }

◆ operator<<

template<class __pF__ >

std::ostream & operator<<	(	std::ostream &	out,
		const JFunctionAdaptorHelper< __pF__ > &	object )

friend

Write function adaptor helper to output stream.

Parameters

out	output stream
object	function adaptor helper

Returns: output stream

Definition at line 233 of file JFunctionAdaptor.hh.

    {
      return out;
    }

Member Data Documentation

◆ SEPARATOR

template<class __pF__ >

const char JEEP::JFunctionAdaptorHelper< __pF__ >::SEPARATOR = ':'

static

Separation character between library file name and function name.

Definition at line 39 of file JFunctionAdaptor.hh.

◆ handle

template<class __pF__ >

void* JEEP::JFunctionAdaptorHelper< __pF__ >::handle

protected

Definition at line 290 of file JFunctionAdaptor.hh.

◆ function

template<class __pF__ >

__pF__ JEEP::JFunctionAdaptorHelper< __pF__ >::function

protected

Definition at line 291 of file JFunctionAdaptor.hh.

◆ libso

template<class __pF__ >

std::string JEEP::JFunctionAdaptorHelper< __pF__ >::libso

protected

Definition at line 292 of file JFunctionAdaptor.hh.

◆ symbol

template<class __pF__ >

std::string JEEP::JFunctionAdaptorHelper< __pF__ >::symbol

protected

Definition at line 293 of file JFunctionAdaptor.hh.

◆ counter

int* JLANG::JSharedCounter::counter

protectedinherited

Definition at line 94 of file JSharedCounter.hh.

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

JFunctionAdaptor.hh

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ ~JFunctionAdaptorHelper()

◆ JFunctionAdaptorHelper() [1/4]

◆ JFunctionAdaptorHelper() [2/4]

◆ JFunctionAdaptorHelper() [3/4]

◆ JFunctionAdaptorHelper() [4/4]

Member Function Documentation

◆ is_valid()

◆ reset()

◆ set()

◆ get()

◆ is_open()

◆ open()

◆ close()

◆ load()

◆ reload()

◆ initialise()

◆ attach()

◆ detach()

◆ getCount()

Friends And Related Symbol Documentation

◆ operator>>

◆ operator<<

Member Data Documentation

◆ SEPARATOR

◆ handle

◆ function

◆ libso

◆ symbol

◆ counter