JEEP::JFunctionAdaptor< JReturn_t, JFirst_t, JSecond_t > Struct Template Reference

Function adaptor. More...

#include <JFunctionAdaptor.hh>

Inheritance diagram for JEEP::JFunctionAdaptor< JReturn_t, JFirst_t, JSecond_t >:

Public Types
typedef JReturn_t(*	pF )(JFirst_t, JSecond_t)
	Type definition of method. More...

Public Member Functions
	JFunctionAdaptor ()
	Default constructor. More...
	JFunctionAdaptor (pF pf)
	Constructor. More...
	JFunctionAdaptor (const std::string &file_name, const std::string &symbol)
	Constructor. More...
JReturn_t	operator() (JFirst_t first, JSecond_t second) const
	Function operation. More...
bool	is_valid () const
	Check validity of function. More...
void	reset ()
	Reset function adaptor helper. More...
void	set (JReturn_t(*)(JFirst_t, JSecond_t)pf)
	Set function. More...
void	get (const char *symbol)
	Get function with given name according to specific protocol. More...
bool	is_open () const
	Check if shared library file is open. More...
void	open (const char *file_name)
	Open file. More...
void	close ()
	Close file. More...
void	load (const std::string &file_name, const std::string &symbol)
	Load function from shared library. More...
void	load (const std::string &buffer)
	Load function from shared library. More...
void	initialise ()
	Initialise counter. More...
void	attach (const JSharedCounter &object)
	Attach this counter to given shared counter object. More...
bool	detach ()
	Detach. More...
const int	getCount ()
	Get count. More...

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

Protected Attributes
void *	handle
JReturn_t(*)(JFirst_t, JSecond_t)	function
int *	counter

Detailed Description

template<class JReturn_t = void, class JFirst_t = void, class JSecond_t = void>
struct JEEP::JFunctionAdaptor< JReturn_t, JFirst_t, JSecond_t >

Function adaptor.

Function adaptor for function with two arguments.

Definition at line 292 of file JFunctionAdaptor.hh.

Member Typedef Documentation

template<class JReturn_t = void, class JFirst_t = void, class JSecond_t = void>

typedef JReturn_t(* JEEP::JFunctionAdaptor< JReturn_t, JFirst_t, JSecond_t >::pF)(JFirst_t, JSecond_t)

Type definition of method.

Definition at line 361 of file JFunctionAdaptor.hh.

Constructor & Destructor Documentation

template<class JReturn_t = void, class JFirst_t = void, class JSecond_t = void>

JEEP::JFunctionAdaptor< JReturn_t, JFirst_t, JSecond_t >::JFunctionAdaptor ( )

inline

Default constructor.

Definition at line 367 of file JFunctionAdaptor.hh.

                       :
      JFunctionAdaptorHelper<pF>()
    {}

template<class JReturn_t = void, class JFirst_t = void, class JSecond_t = void>

JEEP::JFunctionAdaptor< JReturn_t, JFirst_t, JSecond_t >::JFunctionAdaptor ( pF  pf )

inline

Constructor.

Parameters

pf	pointer to function

Definition at line 377 of file JFunctionAdaptor.hh.

                            :
      JFunctionAdaptorHelper<pF>(pf)
    {}

template<class JReturn_t = void, class JFirst_t = void, class JSecond_t = void>

JEEP::JFunctionAdaptor< JReturn_t, JFirst_t, JSecond_t >::JFunctionAdaptor ( const std::string &  file_name, const std::string &  symbol  )

inline

Constructor.

Parameters

file_name	file name
symbol	function name

Definition at line 388 of file JFunctionAdaptor.hh.

                                              :
      JFunctionAdaptorHelper<pF>(file_name, symbol)
    {}

Member Function Documentation

template<class JReturn_t = void, class JFirst_t = void, class JSecond_t = void>

JReturn_t JEEP::JFunctionAdaptor< JReturn_t, JFirst_t, JSecond_t >::operator() ( JFirst_t  first, JSecond_t  second  ) const

inline

Function operation.

Parameters

first	first argument
second	second argument

Returns

return value

Definition at line 401 of file JFunctionAdaptor.hh.

    {
      return this->function(first, second);
    }

bool JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::is_valid ( ) const

inlineinherited

Check validity of function.

Returns

true if valid function; else false

Definition at line 56 of file JFunctionAdaptor.hh.

    {
      return (function != NULL);
    }

void JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::reset ( )

inlineinherited

Reset function adaptor helper.

Definition at line 65 of file JFunctionAdaptor.hh.

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

void JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::set ( JReturn_t(*)(JFirst_t, JSecond_t)  pf )

inlineinherited

Set function.

Parameters

pf	pointer to function

Definition at line 80 of file JFunctionAdaptor.hh.

    {
      close();
      
      function = pf;
    }

void JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::get ( const char *  symbol )

inlineinherited

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.");
      }
    }

bool JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::is_open ( ) const

inlineinherited

Check if shared library file is open.

Returns

true if open; else false

Definition at line 121 of file JFunctionAdaptor.hh.

    {
      return (handle != NULL);
    }

void JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::open ( const char *  file_name )

inlineinherited

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();
    }

void JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::close ( )

inlineinherited

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;
    }

void JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::load ( const std::string &  file_name, const std::string &  symbol  )

inlineinherited

Load function from shared library.

Parameters

file_name	file name
symbol	function name

Definition at line 168 of file JFunctionAdaptor.hh.

    {
      open(file_name.c_str());

      get(symbol.c_str());
    }

void JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::load ( const std::string &  buffer )

inlineinherited

Load function from shared library.

The input buffer should consist of <file name>SEPARATOR<symbol>.

Parameters

buffer

input

Definition at line 183 of file JFunctionAdaptor.hh.

    {
      using namespace std;

      const string::size_type pos = buffer.rfind(SEPARATOR);

      if (pos != string::npos) {

        load(buffer.substr(0,pos).c_str(), buffer.substr(pos+1).c_str());

      } else {

        THROW(JParseError, "Missing separator " << SEPARATOR << " in " << buffer);
      }
    }

void JLANG::JSharedCounter::initialise ( )

inlineinherited

Initialise counter.

Definition at line 33 of file JSharedCounter.hh.

    {
      detach();

      counter = new int(1);
    }

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);
      }
    }

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;
    }

const int JLANG::JSharedCounter::getCount ( )

inlineinherited

Get count.

Returns

count

Definition at line 88 of file JSharedCounter.hh.

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

Member Data Documentation

const char JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::SEPARATOR

staticinherited

Separation character between library file name and function name.

Definition at line 39 of file JFunctionAdaptor.hh.

void* JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::handle

protectedinherited

Definition at line 283 of file JFunctionAdaptor.hh.

JReturn_t(*)(JFirst_t, JSecond_t) JEEP::JFunctionAdaptorHelper< JReturn_t(*)(JFirst_t, JSecond_t) >::function

protectedinherited

Definition at line 284 of file JFunctionAdaptor.hh.

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