JEEP Namespace Reference

General puprpose classes and methods. More...

Classes
class	JArgs
	Data structure to store command line arguments. More...
struct	JComment
	Auxiliary class for comment. More...
class	JCommunicator
	Auxiliary class to control standard input and output. More...
struct	JFunctionAdaptorHelper
	Auxiliary base class for function adaptor. More...
struct	JFunctionAdaptor
	Function adaptor. More...
struct	JFunctionAdaptor< JReturn_t, JFirst_t, void >
	Function adaptor for function with one argument. More...
struct	JMessage
	Auxiliary class for handling debug parameter within a class. More...
class	JPropertiesElementInterface
	Interface for I/O of properties element. More...
class	JPropertiesTemplateElement
	Template class for I/O of properties element. More...
class	JPropertiesTemplateElement< const T >
	Template specialisation of JPropertiesTemplateElement for const data type. More...
class	JPropertiesElement
	The property value class. More...
class	JProperties
	Utility class to parse parameter values. More...
class	JPropertiesTemplateElement< JProperties::JFileReader >
	Template specialisation for JFileReader. More...
class	JPropertiesTemplateElement< JProperties >
	Template specialisation for JProperties. More...
class	JStatus
	Auxiliary class for status identifier. More...
class	JTimekeeper
	Time keeper. More...
class	JTimer
	Auxiliary class for CPU timing and usage. More...
class	JVersion
	Auxiliary class for version identifier. More...

Enumerations
enum	JMessage_t {   debug_t = 3, status_t = 2, warning_t = 2, notice_t = 1,   error_t = 0, fatal_t = 0 }
	Debug level. More...
enum	JPrintOption_t { SHORT_PRINT = 1, MEDIUM_PRINT = 2, LONG_PRINT = 3 }
	Print options. More...
enum	JScale_t {   femto_t = -15, pico_t = -12, nano_t = -9, micro_t = -6,   milli_t = -3, unit_t = 0, kilo_t = +3, mega_t = +6,   giga_t = +9, tera_t = +12, peta_t = +15, exa_t = +18 }
	Enumeration for scaling of quantity. More...

Functions
template<class T >
bool	compareObjects (const T &first, const T &second, JBool< true >)
	Comparison of comparable objects. More...
template<class T >
bool	compareObjects (const T &first, const T &second, JBool< false >)
	Comparison of uncomparable objects. More...
template<class T >
bool	compareObjects (const T &first, const T &second)
	Comparison of objects. More...
std::string	strip (const std::string &file_name)
	Strip leading and trailing white spaces from file name. More...
std::string	getFilenameExtension (const std::string &file_name)
	Get file name extension, i.e. More...
std::string	getFilename (const std::string &file_name)
	Get file name part, i.e. More...
std::string	getPath (const std::string &file_name)
	Get path, i.e. More...
std::string	getFilename (const std::string &path, const std::string &file_name)
	Compose full file name and introduce JEEP::PATHNAME_SEPARATOR if needed. More...
std::string	getPath (const std::string &variable, const std::string &file_name)
	Get selected path from environment variable for given file name. More...
std::string	getFullFilename (const std::string &variable, const std::string &file_name)
	Get full file name (see JEEP::getPath). More...
std::string	getNamespace (const std::string &type_name)
	Get name space, i.e. More...
std::string	getClassname (const std::string &type_name)
	Get type name, i.e. More...
std::string	getProtocol (const std::string &file_name)
	Get protocol, i.e. More...
template<class T >
T *	open (const std::string &file_name)
	Open file. More...
template<>
std::istream *	open (const std::string &file_name)
	Open file. More...
template<>
std::ostream *	open (const std::string &file_name)
	Open file. More...
void	close (std::istream *pf)
	Close file. More...
void	close (std::ostream *pf)
	Close file. More...
template<class T >
int	sign (const T &value)
	Get sign of value. More...
int	getIndex ()
	Get index for user I/O manipulation. More...
std::ostream &	getOstream ()
	Get output stream for conversion to std::string or C-string. More...
bool	fail (std::istream &in)
	Check for stream state. More...
template<class T >
JProperties &	getProperties (T &object, const JEquationParameters &parameters=JEquationParameters(), const int debug=1)
	Get properties of a given object. More...
template<class T >
JProperties &	getProperties (const T &object, const JEquationParameters &parameters=JEquationParameters(), const int debug=1)
	Get properties of a given object. More...
double	getValue (const JScale_t scale)
	Get numerical value corresponding to scale. More...
const char *	getUnit (const int scale)
	Get textual unit corresponding to scale. More...
JScale_t	getScale (const char unit)
	Get scale corresponding to textual unit. More...
template<class T >
std::istream &	readObject (std::istream &in, T &object)
	Stream input of object. More...
template<class T >
std::ostream &	writeObject (std::ostream &out, const T &object)
	Stream output of object. More...
template<class T >
std::ostream &	writeObject (std::ostream &out, const char *prefix, const T &object, const char postfix)
	Stream output of object. More...
template<class JElement_t , class JAllocator_t >
std::istream &	readObject (std::istream &in, std::vector< JElement_t, JAllocator_t > &object)
	Template specialisation of method readObject() for std::vector. More...
template<class JElement_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const std::vector< JElement_t, JAllocator_t > &object)
	Template specialisation of method writeObject() for std::vector. More...
template<class JElement_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const char *prefix, const std::vector< JElement_t, JAllocator_t > &object, const char postfix)
	Template specialisation of method writeObject() for std::vector. More...
template<class JElement_t , class JAllocator_t >
std::istream &	readObject (std::istream &in, std::list< JElement_t, JAllocator_t > &object)
	Template specialisation of method readObject() for std::list. More...
template<class JElement_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const std::list< JElement_t, JAllocator_t > &object)
	Template specialisation of method writeObject() for std::list. More...
template<class JElement_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const char *prefix, const std::list< JElement_t, JAllocator_t > &object, const char postfix)
	Template specialisation of method writeObject() for std::list. More...
template<class JElement_t , class JComparator_t , class JAllocator_t >
std::istream &	readObject (std::istream &in, std::set< JElement_t, JComparator_t, JAllocator_t > &object)
	Template specialisation of method readObject() for std::set. More...
template<class JElement_t , class JComparator_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const std::set< JElement_t, JComparator_t, JAllocator_t > &object)
	Template specialisation of method writeObject() for std::set. More...
template<class JElement_t , class JComparator_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const char *prefix, const std::set< JElement_t, JComparator_t, JAllocator_t > &object, const char postfix)
	Template specialisation of method writeObject() for std::set. More...
template<class JElement_t , class JComparator_t , class JAllocator_t >
std::istream &	readObject (std::istream &in, std::multiset< JElement_t, JComparator_t, JAllocator_t > &object)
	Template specialisation of method readObject() for std::multiset. More...
template<class JElement_t , class JComparator_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const std::multiset< JElement_t, JComparator_t, JAllocator_t > &object)
	Template specialisation of method writeObject() for std::multiset. More...
template<class JElement_t , class JComparator_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const char *prefix, const std::multiset< JElement_t, JComparator_t, JAllocator_t > &object, const char postfix)
	Template specialisation of method writeObject() for std::multiset. More...
template<class JFirst_t , class JSecond_t >
std::istream &	readObject (std::istream &in, std::pair< JFirst_t, JSecond_t > &object)
	Template specialisation of method readObject() for std::pair. More...
template<class JFirst_t , class JSecond_t >
std::ostream &	writeObject (std::ostream &out, const std::pair< JFirst_t, JSecond_t > &object)
	Template specialisation of method writeObject() for std::pair. More...
template<class JFirst_t , class JSecond_t >
std::ostream &	writeObject (std::ostream &out, const char *prefix, const std::pair< JFirst_t, JSecond_t > &object, const char postfix)
	Template specialisation of method writeObject() for std::pair. More...
template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >
std::istream &	readObject (std::istream &in, std::map< JKey_t, JValue_t, JComparator_t, JAllocator_t > &object)
	Template specialisation of method readObject() for std::map. More...
template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const std::map< JKey_t, JValue_t, JComparator_t, JAllocator_t > &object)
	Template specialisation of method writeObject() for std::map. More...
template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const char *prefix, const std::map< JKey_t, JValue_t, JComparator_t, JAllocator_t > &object, const char postfix)
	Template specialisation of method writeObject() for std::map. More...
template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >
std::istream &	readObject (std::istream &in, std::multimap< JKey_t, JValue_t, JComparator_t, JAllocator_t > &object)
	Template specialisation of method readObject() for std::multimap. More...
template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const std::multimap< JKey_t, JValue_t, JComparator_t, JAllocator_t > &object)
	Template specialisation of method writeObject() for std::multimap. More...
template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >
std::ostream &	writeObject (std::ostream &out, const char *prefix, const std::multimap< JKey_t, JValue_t, JComparator_t, JAllocator_t > &object, const char postfix)
	Template specialisation of method writeObject() for std::multimap. More...
template<class T >
std::ostream &	writeArray (std::ostream &out, const char *left, const char *right, const char *sep, T __begin, T __end)
	Write array of objects. More...
bool	operator< (const JVersion &first, const JVersion &second)
	Less-than operator for versions. More...

Variables
static const char *const	LD_LIBRARY_PATH = "LD_LIBRARY_PATH"
	Nick names of environment variables. More...
static const char *const	PATH = "PATH"
	binary file paths More...
static const char *const	SHELL = "SHELL"
	SHELL. More...
static const char	PATHNAME_SEPARATOR = '/'
	path name separator More...
static const char	PATHLIST_SEPARATOR = ':'
	path list separator More...
static const char	FILENAME_SEPARATOR = '.'
	file name separator More...
static const char *const	TYPENAME_SEPARATOR = "::"
	type name separator More...
static const char	PROTOCOL_SEPARATOR = ':'
	protocol separator More...

Detailed Description

General puprpose classes and methods.

Author

mdejong

Enumeration Type Documentation

enum JEEP::JMessage_t

Debug level.

Enumerator
debug_t	debug
status_t	status
warning_t	warning
notice_t	notice
error_t	error
fatal_t	fatal; exit

Definition at line 25 of file JMessage.hh.

                  {
    
    debug_t   = 3,    //!< debug
    status_t  = 2,    //!< status
    warning_t = 2,    //!< warning
    notice_t  = 1,    //!< notice
    error_t   = 0,    //!< error
    fatal_t   = 0     //!< fatal; exit
  };

enum JEEP::JPrintOption_t

Print options.

Enumerator
SHORT_PRINT	short print
MEDIUM_PRINT	medium print
LONG_PRINT	long print

Definition at line 37 of file JPrint.hh.

                      {
    SHORT_PRINT  = 1,    //!< short  print
    MEDIUM_PRINT = 2,    //!< medium print
    LONG_PRINT   = 3     //!< long   print
  };

enum JEEP::JScale_t

Enumeration for scaling of quantity.

Enumerator
femto_t	femto
pico_t	pico
nano_t	nano
micro_t	micro
milli_t	milli
unit_t	unit
kilo_t	kilo
mega_t	mega
giga_t	giga
tera_t	tera
peta_t	peta
exa_t	exa

Definition at line 24 of file JScale.hh.

                {

    femto_t  =  -15,    //!< femto
    pico_t   =  -12,    //!< pico
    nano_t   =   -9,    //!< nano
    micro_t  =   -6,    //!< micro
    milli_t  =   -3,    //!< milli
    unit_t   =    0,    //!< unit
    kilo_t   =   +3,    //!< kilo
    mega_t   =   +6,    //!< mega
    giga_t   =   +9,    //!< giga
    tera_t   =  +12,    //!< tera
    peta_t   =  +15,    //!< peta
    exa_t    =  +18     //!< exa
  };

Function Documentation

template<class T >

bool JEEP::compareObjects ( const T &  first, const T &  second, JBool< true >    )

inline

Comparison of comparable objects.

Parameters

first	first object
second	second object

Returns

true if objects are equal; else false

Definition at line 30 of file JComparisonToolkit.hh.

  {
    return first == second;
  }

template<class T >

bool JEEP::compareObjects ( const T &  first, const T &  second, JBool< false >    )

inline

Comparison of uncomparable objects.

Parameters

first	first object
second	second object

Returns

false

Definition at line 46 of file JComparisonToolkit.hh.

  {
    return false;
  }

template<class T >

bool JEEP::compareObjects ( const T &  first, const T &  second  )

inline

Comparison of objects.

Parameters

first	first object
second	second object

Returns

true if objects are comparable and equal; else false

Definition at line 62 of file JComparisonToolkit.hh.

  { 
    return compareObjects(first, second, JBool<JComparisonAvailable<T>::has_eq>());
  }

std::string JEEP::strip ( const std::string &  file_name )

inline

Strip leading and trailing white spaces from file name.

Parameters

file_name

file name

Returns

file name

Definition at line 46 of file JeepToolkit.hh.

  {
    using namespace std;

    string::const_iterator         p = file_name. begin();
    string::const_reverse_iterator q = file_name.rbegin();
    
    for ( ; p != file_name.end() && q != file_name.rend() && isspace(*p); ++p) {}
    for ( ; p != file_name.end() && q != file_name.rend() && isspace(*q); ++q) {}
    
    return string(p,q.base());
  }

std::string JEEP::getFilenameExtension ( const std::string &  file_name )

inline

Get file name extension, i.e.

part after last JEEP::FILENAME_SEPARATOR if any.

Parameters

file_name

file name

Returns

extension (excluding separator)

Definition at line 66 of file JeepToolkit.hh.

  {
    using namespace std;

    const size_t pos = file_name.rfind(FILENAME_SEPARATOR);

    if (pos != string::npos)
      return file_name.substr(pos + 1);
    else
      return "";
  }

std::string JEEP::getFilename ( const std::string &  file_name )

inline

Get file name part, i.e.

part after last JEEP::PATHNAME_SEPARATOR if any.

Parameters

file_name

file name

Returns

file name part (excluding separator)

Definition at line 85 of file JeepToolkit.hh.

  {
    using namespace std;

    const string buffer = strip(file_name);
    const size_t pos    = buffer.rfind(PATHNAME_SEPARATOR);

    if (pos != string::npos)
      return buffer.substr(pos + 1);
    else
      return buffer;
  }

std::string JEEP::getPath ( const std::string &  file_name )

inline

Get path, i.e.

part before last JEEP::PATHNAME_SEPARATOR if any.

Parameters

file_name

file name

Returns

path (including separator)

Definition at line 105 of file JeepToolkit.hh.

  {
    using namespace std;

    const string buffer = strip(file_name);
    const size_t pos    = buffer.rfind(PATHNAME_SEPARATOR);

    if (pos != string::npos)
      return buffer.substr(0, pos + 1);
    else
      return "";
  }

std::string JEEP::getFilename ( const std::string &  path, const std::string &  file_name  )

inline

Compose full file name and introduce JEEP::PATHNAME_SEPARATOR if needed.

Parameters

path	path
file_name	file name

Returns

file name

Definition at line 126 of file JeepToolkit.hh.

  {
    using namespace std;

    const string buffer = strip(path);

    if        (buffer.empty()) {

      return strip(file_name);

    } else if (*buffer.rbegin() == PATHNAME_SEPARATOR) {

      return buffer + strip(file_name);

    } else {

      return buffer + PATHNAME_SEPARATOR + strip(file_name);
    }
  }

std::string JEEP::getPath ( const std::string &  variable, const std::string &  file_name  )

inline

Get selected path from environment variable for given file name.

The environment variable is parsed according character JEEP::PATHLIST_SEPARATOR. The first path in which a file exists with the given file name is returned. If no existing file is found, an empty path is returned.

Parameters

variable	environment variable
file_name	file name

Returns

path

Definition at line 158 of file JeepToolkit.hh.

  {
    using namespace std;

    string path = "";

    if (!file_name.empty() && file_name[0] != PATHNAME_SEPARATOR) {

      const string buffer(getenv(variable.c_str()));
        
      if (!buffer.empty()) {
          
        size_t pos = 0, len;
          
        do { 
          
          len  = buffer.substr(pos).find(PATHLIST_SEPARATOR);
          path = buffer.substr(pos,len);

        } while (!ifstream(getFilename(path, file_name).c_str()).good() && len != string::npos && (pos += len + 1) != buffer.length());
      }
    }

    if (ifstream(getFilename(path, file_name).c_str()).good())
      return path;
    else
      return "";
  }  

std::string JEEP::getFullFilename ( const std::string &  variable, const std::string &  file_name  )

inline

Get full file name (see JEEP::getPath).

Parameters

variable	environment variable
file_name	file name

Returns

file name

Definition at line 195 of file JeepToolkit.hh.

  {
    return getFilename(getPath(variable, file_name), file_name);
  }

std::string JEEP::getNamespace ( const std::string &  type_name )

inline

Get name space, i.e.

part before JEEP::TYPENAME_SEPARATOR.

Parameters

type_name

type name

Returns

name space (possibly empty)

Definition at line 207 of file JeepToolkit.hh.

  {
    using namespace std;

    const size_t pos = type_name.rfind(TYPENAME_SEPARATOR);

    if (pos != string::npos)
      return type_name.substr(0, pos);
    else
      return "";
  }

std::string JEEP::getClassname ( const std::string &  type_name )

inline

Get type name, i.e.

part after JEEP::TYPENAME_SEPARATOR.

Parameters

type_name

type name

Returns

class name

Definition at line 226 of file JeepToolkit.hh.

  {
    using namespace std;

    const size_t pos = type_name.rfind(TYPENAME_SEPARATOR);

    if (pos != string::npos)
      return type_name.substr(pos + 2);
    else
      return type_name;
  }

std::string JEEP::getProtocol ( const std::string &  file_name )

inline

Get protocol, i.e.

part before first JEEP::PROTOCOL_SEPARATOR if any.

Parameters

file_name

file name

Returns

protocol (excluding separator)

Definition at line 245 of file JeepToolkit.hh.

  {
    using namespace std;

    const size_t pos = file_name.find(PROTOCOL_SEPARATOR);

    if (pos != string::npos)
      return file_name.substr(0, pos);
    else
      return "";
  }

template<class T >

T* JEEP::open ( const std::string &  file_name )

inline

Open file.

Parameters

file_name

file name

Returns

pointer to input stream

Parameters

file_name

file name

Returns

pointer to output stream

Definition at line 275 of file JeepToolkit.hh.

  {
    using namespace std;
    using namespace JPP;

    if      (getFilenameExtension(file_name) == "gz") 
      return new igzstream(file_name.c_str());
    else if (getFilenameExtension(file_name) == "txt") 
      return new ifstream (file_name.c_str());
    else
      return NULL;
  }

template<>

std::istream* JEEP::open ( const std::string &  file_name )

inline

Open file.

Parameters

file_name

file name

Returns

pointer to input stream

Definition at line 275 of file JeepToolkit.hh.

  {
    using namespace std;
    using namespace JPP;

    if      (getFilenameExtension(file_name) == "gz") 
      return new igzstream(file_name.c_str());
    else if (getFilenameExtension(file_name) == "txt") 
      return new ifstream (file_name.c_str());
    else
      return NULL;
  }

template<>

std::ostream* JEEP::open ( const std::string &  file_name )

inline

Open file.

Parameters

file_name

file name

Returns

pointer to output stream

Definition at line 296 of file JeepToolkit.hh.

  {
    using namespace std;
    using namespace JPP;

    if      (getFilenameExtension(file_name) == "gz") 
      return new ogzstream(file_name.c_str());
    else if (getFilenameExtension(file_name) == "txt") 
      return new ofstream (file_name.c_str());
    else
      return NULL;
  }

void JEEP::close ( std::istream *  pf )

inline

Close file.

Parameters

pf	pointer to file stream

Definition at line 315 of file JeepToolkit.hh.

  {
    using namespace std;
    using namespace JPP;

    if (dynamic_cast<ifstream*> (pf) != NULL) { dynamic_cast<ifstream*> (pf)->close(); return; }
    if (dynamic_cast<igzstream*>(pf) != NULL) { dynamic_cast<igzstream*>(pf)->close(); return; }
  }

void JEEP::close ( std::ostream *  pf )

inline

Close file.

Parameters

pf	pointer to file stream

Definition at line 330 of file JeepToolkit.hh.

  {
    using namespace std;
    using namespace JPP;

    if (dynamic_cast<ofstream*> (pf) != NULL) { dynamic_cast<ofstream*> (pf)->close(); return; }
    if (dynamic_cast<ogzstream*>(pf) != NULL) { dynamic_cast<ogzstream*>(pf)->close(); return; }
  }

template<class T >

int JEEP::sign ( const T &  value )

inline

Get sign of value.

Parameters

value

value

Returns

-1 if value < 0; 0 if value == 0; +1 if value > 0

Definition at line 20 of file JLib.hh.

  {
    return (value > T(0)) - (value < T(0));
  }

int JEEP::getIndex ( )

inline

Get index for user I/O manipulation.

Returns

index

Definition at line 26 of file JPrint.hh.

  {
    static const int index = std::ios_base::xalloc();

    return index;
  }

std::ostream& JEEP::getOstream ( )

inline

Get output stream for conversion to std::string or C-string.

Note that the ostream is emptied before use.

Returns

ostream

Definition at line 51 of file JPrint.hh.

  {
    static std::ostringstream buffer;

    buffer.str("");

    return buffer;
  }

bool JEEP::fail ( std::istream &  in )

inline

Check for stream state.

Note that end-of-file is not defined as an error so to normally process e.g. std::string and std::vector.

Parameters

in	input stream

Returns

true if failure; else false

Definition at line 57 of file JProperties.hh.

  {
    return in.bad() || (in.fail() && !in.eof());
  }

template<class T >

JProperties& JEEP::getProperties ( T &  object, const JEquationParameters &  parameters = JEquationParameters(), const int  debug = 1  )

inline

Get properties of a given object.

This method transfers the making of the property object to the corresponding class whilst preserving the constness of the argument.
The corresponding class should implement the method:

  template<bool is_const>
  static JProperties getProperties(typename JCategory<T, is_const>::reference_type object,
                                const JEquationParameters& equation,
                                const int debug)

Parameters

object	object
parameters	equation parameters
debug	debug level

Definition at line 1255 of file JProperties.hh.

  {
    static JProperties properties;

    properties = T::template getProperties<true>(object, parameters, debug);
    
    return properties; 
  }

template<class T >

JProperties& JEEP::getProperties ( const T &  object, const JEquationParameters &  parameters = JEquationParameters(), const int  debug = 1  )

inline

Get properties of a given object.

This method transfers the making of the property object to the corresponding class whilst preserving the constness of the argument.
The corresponding class should implement the method:

  template<bool is_const>
  static JProperties getProperties(typename JCategory<T, is_const>::reference_type object,
                                const JEquationParameters& equation,
                                const int debug)

Parameters

object	object
parameters	equation parameters
debug	debug level

Definition at line 1285 of file JProperties.hh.

  {
    static JProperties properties;

    properties = T::template getProperties<false>(object, parameters, debug);
    
    return properties; 
  }

double JEEP::getValue ( const JScale_t  scale )

inline

Get numerical value corresponding to scale.

Parameters

scale

scale

Returns

value

Definition at line 47 of file JScale.hh.

  {
    return pow(10.0, scale);
  }

const char* JEEP::getUnit ( const int  scale )

inline

Get textual unit corresponding to scale.

Parameters

scale

scale

Returns

textual unit

Definition at line 59 of file JScale.hh.

  {
    switch (scale) {

    case femto_t:
      return "f";

    case pico_t:
      return "p";

    case nano_t:
      return "n";

    case micro_t:
      return "u";

    case milli_t:
      return "m";

    case unit_t:
      return "";

    case kilo_t:
      return "k";

    case mega_t:
      return "M";

    case giga_t:
      return "G";

    case tera_t:
      return "T";

    case peta_t:
      return "P";

    case exa_t:
      return "E";

    default:
      THROW(JValueOutOfRange, "getUnit(): invalid scale " << scale);
    };
  }

JScale_t JEEP::getScale ( const char  unit )

inline

Get scale corresponding to textual unit.

Parameters

unit	textual unit

Returns

scale

Definition at line 111 of file JScale.hh.

  {
    switch (unit) {

    case 'f':
      return femto_t;

    case 'p':
      return pico_t;

    case 'n':
      return nano_t;

    case 'u':
      return micro_t;

    case 'm':
      return milli_t;

    case ' ':
      return unit_t;

    case 'k':
      return kilo_t;

    case 'M':
      return mega_t;

    case 'G':
      return giga_t;

    case 'T':
      return tera_t;

    case 'P':
      return peta_t;

    case 'E':
      return exa_t;

    default:
      THROW(JValueOutOfRange, "getScale(): invalid unit " << unit);
    };
  }

template<class T >

std::istream& JEEP::readObject ( std::istream &  in, T &  object  )

inline

Stream input of object.

Parameters

in	input stream
object	object

Returns

input stream

Definition at line 28 of file JStreamToolkit.hh.

  {
    return in >> object;
  }

template<class T >

std::ostream& JEEP::writeObject ( std::ostream &  out, const T &  object  )

inline

Stream output of object.

Parameters

out	output stream
object	object

Returns

output stream

Definition at line 42 of file JStreamToolkit.hh.

  { 
    return out << object;
  }

template<class T >

std::ostream& JEEP::writeObject ( std::ostream &  out, const char *  prefix, const T &  object, const char  postfix  )

inline

Stream output of object.

Parameters

out	output stream
prefix	prefix
object	object
postfix	postfix

Returns

output stream

Definition at line 58 of file JStreamToolkit.hh.

  { 
    return out << prefix << object << postfix;
  }

template<class JElement_t , class JAllocator_t >

std::istream& JEEP::readObject ( std::istream &  in, std::vector< JElement_t, JAllocator_t > &  object  )

inline

Template specialisation of method readObject() for std::vector.

Parameters

in	input stream
object	object

Returns

input stream

Definition at line 75 of file JStreamToolkit.hh.

  {
    for (JElement_t element; readObject(in, element); ) {
      object.push_back(element);
    }
    
    return in;
  }

template<class JElement_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const std::vector< JElement_t, JAllocator_t > &  object  )

inline

Template specialisation of method writeObject() for std::vector.

Parameters

out	output stream
object	object

Returns

output stream

Definition at line 93 of file JStreamToolkit.hh.

  { 
    for (typename std::vector<JElement_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, ' ');
      writeObject(out, *i);
    }
    
    return out;
  }

template<class JElement_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const char *  prefix, const std::vector< JElement_t, JAllocator_t > &  object, const char  postfix  )

inline

Template specialisation of method writeObject() for std::vector.

Parameters

out	output stream
prefix	prefix
object	object
postfix	postfix

Returns

output stream

Definition at line 114 of file JStreamToolkit.hh.

  { 
    for (typename std::vector<JElement_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, prefix, *i, postfix);
    }
    
    return out;
  }

template<class JElement_t , class JAllocator_t >

std::istream& JEEP::readObject ( std::istream &  in, std::list< JElement_t, JAllocator_t > &  object  )

inline

Template specialisation of method readObject() for std::list.

Parameters

in	input stream
object	object

Returns

input stream

Definition at line 135 of file JStreamToolkit.hh.

  {
    for (JElement_t element; readObject(in, element); ) {
      object.push_back(element);
    }
    
    return in;
  }

template<class JElement_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const std::list< JElement_t, JAllocator_t > &  object  )

inline

Template specialisation of method writeObject() for std::list.

Parameters

out	output stream
object	object

Returns

output stream

Definition at line 153 of file JStreamToolkit.hh.

  { 
    for (typename std::list<JElement_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, ' ');
      writeObject(out, *i);
    }
    
    return out;
  }

template<class JElement_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const char *  prefix, const std::list< JElement_t, JAllocator_t > &  object, const char  postfix  )

inline

Template specialisation of method writeObject() for std::list.

Parameters

out	output stream
prefix	prefix
object	object
postfix	postfix

Returns

output stream

Definition at line 174 of file JStreamToolkit.hh.

  { 
    for (typename std::list<JElement_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, prefix, *i, postfix);
    }
    
    return out;
  }

template<class JElement_t , class JComparator_t , class JAllocator_t >

std::istream& JEEP::readObject ( std::istream &  in, std::set< JElement_t, JComparator_t, JAllocator_t > &  object  )

inline

Template specialisation of method readObject() for std::set.

Parameters

in	input stream
object	object

Returns

input stream

Definition at line 195 of file JStreamToolkit.hh.

  {
    for (JElement_t element; readObject(in, element); ) {

      const std::pair<typename std::set<JElement_t, JComparator_t, JAllocator_t>::iterator, bool> result = object.insert(element);

      if (!result.second) {
        object.erase (result.first);
        object.insert(element);
      }
    }
    
    return in;
  }

template<class JElement_t , class JComparator_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const std::set< JElement_t, JComparator_t, JAllocator_t > &  object  )

inline

Template specialisation of method writeObject() for std::set.

Parameters

out	output stream
object	object

Returns

output stream

Definition at line 219 of file JStreamToolkit.hh.

  { 
    for (typename std::set<JElement_t, JComparator_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, ' ');
      writeObject(out, *i);
    }
    
    return out;
  }

template<class JElement_t , class JComparator_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const char *  prefix, const std::set< JElement_t, JComparator_t, JAllocator_t > &  object, const char  postfix  )

inline

Template specialisation of method writeObject() for std::set.

Parameters

out	output stream
prefix	prefix
object	object
postfix	postfix

Returns

output stream

Definition at line 240 of file JStreamToolkit.hh.

  { 
    for (typename std::set<JElement_t, JComparator_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, prefix, *i, postfix);
    }
    
    return out;
  }

template<class JElement_t , class JComparator_t , class JAllocator_t >

std::istream& JEEP::readObject ( std::istream &  in, std::multiset< JElement_t, JComparator_t, JAllocator_t > &  object  )

inline

Template specialisation of method readObject() for std::multiset.

Parameters

in	input stream
object	object

Returns

input stream

Definition at line 261 of file JStreamToolkit.hh.

  {
    for (JElement_t element; readObject(in, element); ) {
      object.insert(element);
    }
    
    return in;
  }

template<class JElement_t , class JComparator_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const std::multiset< JElement_t, JComparator_t, JAllocator_t > &  object  )

inline

Template specialisation of method writeObject() for std::multiset.

Parameters

out	output stream
object	object

Returns

output stream

Definition at line 279 of file JStreamToolkit.hh.

  { 
    for (typename std::multiset<JElement_t, JComparator_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, ' ');
      writeObject(out, *i);
    }
    
    return out;
  }

template<class JElement_t , class JComparator_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const char *  prefix, const std::multiset< JElement_t, JComparator_t, JAllocator_t > &  object, const char  postfix  )

inline

Template specialisation of method writeObject() for std::multiset.

Parameters

out	output stream
prefix	prefix
object	object
postfix	postfix

Returns

output stream

Definition at line 300 of file JStreamToolkit.hh.

  { 
    for (typename std::multiset<JElement_t, JComparator_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, prefix, *i, postfix);
    }
    
    return out;
  }

template<class JFirst_t , class JSecond_t >

std::istream& JEEP::readObject ( std::istream &  in, std::pair< JFirst_t, JSecond_t > &  object  )

inline

Template specialisation of method readObject() for std::pair.

Parameters

in	input stream
object	object

Returns

input stream

Definition at line 321 of file JStreamToolkit.hh.

  {
    readObject(in, object.first);
    readObject(in, object.second);

    return in;
  }

template<class JFirst_t , class JSecond_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const std::pair< JFirst_t, JSecond_t > &  object  )

inline

Template specialisation of method writeObject() for std::pair.

Parameters

out	output stream
object	object

Returns

output stream

Definition at line 338 of file JStreamToolkit.hh.

  { 
    writeObject(out, object.first);
    writeObject(out, ' ');
    writeObject(out, object.second);

    return out;
  }

template<class JFirst_t , class JSecond_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const char *  prefix, const std::pair< JFirst_t, JSecond_t > &  object, const char  postfix  )

inline

Template specialisation of method writeObject() for std::pair.

Parameters

out	output stream
prefix	prefix
object	object
postfix	postfix

Returns

output stream

Definition at line 358 of file JStreamToolkit.hh.

  { 
    writeObject(out, prefix);
    writeObject(out, object.first);
    writeObject(out, ' ');
    writeObject(out, object.second);
    writeObject(out, postfix);
      
    return out;
  }

template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >

std::istream& JEEP::readObject ( std::istream &  in, std::map< JKey_t, JValue_t, JComparator_t, JAllocator_t > &  object  )

inline

Template specialisation of method readObject() for std::map.

Parameters

in	input stream
object	object

Returns

input stream

Definition at line 381 of file JStreamToolkit.hh.

  {
    for (std::pair<JKey_t, JValue_t> element; readObject(in, element); ) {

      const std::pair<typename std::map<JKey_t, JValue_t, JComparator_t, JAllocator_t>::iterator, bool> result = object.insert(element);

      if (!result.second) {
        result.first->second = element.second;
      }
    }

    return in;
  }

template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const std::map< JKey_t, JValue_t, JComparator_t, JAllocator_t > &  object  )

inline

Template specialisation of method writeObject() for std::map.

Parameters

out	output stream
object	object

Returns

output stream

Definition at line 404 of file JStreamToolkit.hh.

  { 
    for (typename std::map<JKey_t, JValue_t, JComparator_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, ' ');
      writeObject(out, *i);
    }

    return out;
  }

template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const char *  prefix, const std::map< JKey_t, JValue_t, JComparator_t, JAllocator_t > &  object, const char  postfix  )

inline

Template specialisation of method writeObject() for std::map.

Parameters

out	output stream
prefix	prefix
object	object
postfix	postfix

Returns

output stream

Definition at line 425 of file JStreamToolkit.hh.

  { 
    for (typename std::map<JKey_t, JValue_t, JComparator_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, prefix, *i, postfix);
    }

    return out;
  }

template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >

std::istream& JEEP::readObject ( std::istream &  in, std::multimap< JKey_t, JValue_t, JComparator_t, JAllocator_t > &  object  )

inline

Template specialisation of method readObject() for std::multimap.

Parameters

in	input stream
object	object

Returns

input stream

Definition at line 446 of file JStreamToolkit.hh.

  {
    for (std::pair<JKey_t, JValue_t> element; readObject(in, element); ) {
      object.insert(element);
    }

    return in;
  }

template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const std::multimap< JKey_t, JValue_t, JComparator_t, JAllocator_t > &  object  )

inline

Template specialisation of method writeObject() for std::multimap.

Parameters

out	output stream
object	object

Returns

output stream

Definition at line 464 of file JStreamToolkit.hh.

  { 
    for (typename std::multimap<JKey_t, JValue_t, JComparator_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, ' ');
      writeObject(out, *i);
    }

    return out;
  }

template<class JKey_t , class JValue_t , class JComparator_t , class JAllocator_t >

std::ostream& JEEP::writeObject ( std::ostream &  out, const char *  prefix, const std::multimap< JKey_t, JValue_t, JComparator_t, JAllocator_t > &  object, const char  postfix  )

inline

Template specialisation of method writeObject() for std::multimap.

Parameters

out	output stream
prefix	prefix
object	object
postfix	postfix

Returns

output stream

Definition at line 485 of file JStreamToolkit.hh.

  { 
    for (typename std::multimap<JKey_t, JValue_t, JComparator_t, JAllocator_t>::const_iterator i = object.begin(); i != object.end(); ++i) {
      writeObject(out, prefix, *i, postfix);
    }

    return out;
  }

template<class T >

std::ostream& JEEP::writeArray ( std::ostream &  out, const char *  left, const char *  right, const char *  sep, T  __begin, T  __end  )

inline

Write array of objects.

Parameters

out	output stream
left	left bracket
right	right bracket
sep	separator
__begin	begin of data
__end	end of data

Returns

output stream

Definition at line 510 of file JStreamToolkit.hh.

  { 
    if (std::distance(__begin, __end) != 0) {

      out << left;

      T i = __begin;
      
      writeObject(out, *i); 
      
      while (++i != __end) {
        
        out << sep;
        
        JEEP::writeObject(out, *i); 
      }
      
      out << right;
    }

    return out;
  }

bool JEEP::operator< ( const JVersion &  first, const JVersion &  second  )

inline

Less-than operator for versions.

Parameters

first	first version
second	second version

Returns

true if first version before second; else false

Definition at line 182 of file JVersion.hh.

  {
    return first.getVariant() < second.getVariant();
  }

Variable Documentation

const char* const JEEP::LD_LIBRARY_PATH = "LD_LIBRARY_PATH"

static

Nick names of environment variables.

library file paths

Definition at line 29 of file JeepToolkit.hh.

const char* const JEEP::PATH = "PATH"

static

binary file paths

Definition at line 30 of file JeepToolkit.hh.

const char* const JEEP::SHELL = "SHELL"

static

SHELL.

Definition at line 31 of file JeepToolkit.hh.

const char JEEP::PATHNAME_SEPARATOR = '/'

static

path name separator

Definition at line 33 of file JeepToolkit.hh.

const char JEEP::PATHLIST_SEPARATOR = ':'

static

path list separator

Definition at line 34 of file JeepToolkit.hh.

const char JEEP::FILENAME_SEPARATOR = '.'

static

file name separator

Definition at line 35 of file JeepToolkit.hh.

const char* const JEEP::TYPENAME_SEPARATOR = "::"

static

type name separator

Definition at line 36 of file JeepToolkit.hh.

const char JEEP::PROTOCOL_SEPARATOR = ':'

static

protocol separator

Definition at line 37 of file JeepToolkit.hh.