Common eVaf library. More...

Namespaces
	Internal
	Internal implementation of the common eVaf library.

Classes
class	Event
	Event class for all the eVaf events. More...

class	iApp
	eVaf application interface More...

class	iConfig
	eVaf configuration interface. More...

class	iEventQueue
	The eVaf event queue interface. More...

class	iLogger
	Logger interface for eVaf modules and applications. More...

class	IniFile
	Class for reading and writing parameter values in INI files. More...

class	iProp
	Global properties and variables for eVaf applications. More...

class	iRegistry
	Common registry for interfaces. More...

Typedefs
typedef void(*	FatalMsgHandler) (QString const &msg, QString const &source, QString const &where)
	Prototype for custom fatal message handler. More...

Functions
COMMON_EXPORT QByteArray	binFromEscapedCharArray (QByteArray const &str)
	Converts escaped 7-bit character arrays to binary arrays. More...

COMMON_EXPORT QByteArray	binToEscapedCharArray (QByteArray const &src)
	Converts binary arrays to escaped 7-bit character arrays. More...

bool COMMON_EXPORT	init ()
	eVaf common library initialized More...

bool	isFalse (QString const &str)
	Tests if the string means 'false'. More...

bool	isTrue (QString const &str)
	Tests if the string means 'true'. More...

COMMON_EXPORT QString	strFromEscapedCharArray (QByteArray const &str)
	Converts escaped 7-bit character arrays to unicode string. More...

COMMON_EXPORT QByteArray	strToEscapedCharArray (QString const &str)
	Converts unicode strings to escaped 7-bit character arrays. More...

COMMON_EXPORT QVariant	toVariant (QString const &value, QVariant const &defaultValue)
	Converts strings to variant values. More...

Detailed Description

Common eVaf library.

This library contains interfaces, classes and functions shared by all the eVaf applications and modules. This library is the required dependency for all the other libraries, modules and applications.

The common eVaf library shall be initialized with the eVaf::Common::init() function.

Typedef Documentation

typedef void(* eVaf::Common::FatalMsgHandler) (QString const &msg, QString const &source, QString const &where)

Prototype for custom fatal message handler.

This is a typedef for a pointer to a function with the following signature:

void myFatalMessageHandler(QString const & msg, QString const & source, QString const & where);

See also: iLogger::installFatalMsgHandler()

Definition at line 43 of file ilogger.h.

Function Documentation

COMMON_EXPORT QByteArray eVaf::Common::binFromEscapedCharArray ( QByteArray const & str )

Converts escaped 7-bit character arrays to binary arrays.

Parameters

str	Escaped 7-bit character array

Returns: Binary array

This function converts an escaped 7-bit character array to the binary array. Numeric character references and character entoty references are expanded to characters and binary bytes.

COMMON_EXPORT QByteArray eVaf::Common::binToEscapedCharArray ( QByteArray const & src )

Converts binary arrays to escaped 7-bit character arrays.

Parameters

src	Binary array

Returns: Escaped 7-bit character array

This function converts a binary array to the escaped 7-bit character array. Bytes that cannot be output directly as printable 7-bit characters are output as numeric character references. The result can be directly inserted into XML or HTML documents and later converted back with the eVaf::Common::binFromEscapedCharArray() function.

For example, "Hello\r\n" becomes "Hello
".

bool COMMON_EXPORT eVaf::Common::init ( )

eVaf common library initialized

Returns: True if ok; false if the initialization failed

Call this function to initialize the common eVaf library after creating the Qt application object and before loading any of the modules.

bool eVaf::Common::isFalse ( QString const & str )

inline

Tests if the string means 'false'.

Parameters

str	The string

Returns: True if the string is 'no', 'false', 'off' or '0'.

This function tests if the string means 'false'. Use this function when the default value should be 'true'.

Definition at line 52 of file util.h.

bool eVaf::Common::isTrue ( QString const & str )

inline

Tests if the string means 'true'.

Parameters

str	The string

Returns: True if the string is 'yes', 'true', 'on' or '1'.

This function tests if the string means 'true'. Use this function when the default value should be 'false'.

Definition at line 39 of file util.h.

COMMON_EXPORT QString eVaf::Common::strFromEscapedCharArray ( QByteArray const & str )

Converts escaped 7-bit character arrays to unicode string.

Parameters

str	Escaped 7-bit character array

Returns: Unicode string

This function converts an escaped 7-bit character array to the unicode string. Numeric character references and character entity references are expanded to actual unicode characters.

COMMON_EXPORT QByteArray eVaf::Common::strToEscapedCharArray ( QString const & str )

Converts unicode strings to escaped 7-bit character arrays.

Parameters

str	Unicode string

Returns: Escaped 7-bit character array

This function converts a unicode (or any) string to the escaped 7-bit character array. Characters that cannot be output directly as a printable 7-bit character are output as numeric character references. The result can be directly inserted into XML or HTML documents and later converted back with the eVaf::Common::strFromEscapedCharArray() function.

For example, "Groß" becomes "Groß".

COMMON_EXPORT QVariant eVaf::Common::toVariant	(	QString const &	value,
		QVariant const &	defaultValue
	)

Converts strings to variant values.

Parameters

value	The string
defaultValue	The default value

Returns: value converted from the string or the default if failed

This function converts strings to variant values. The type of the expected value is determined from the default value. If the string fails to convert to the expected type, returns the default value.

If the default value is of one of the following types, then the following conversion rules are applied:

QVariant::UInt - if the string begins with "0x", base 16 is used; if the string begins with "0", base 8 is used; otherwise base 10 is used;
QVariant::Int - base 10 is used;
QVariant::Double - the decimal point is expecte to be '.' regardless which locale is used;
QVariant::Bool - tries to use isTrue() and isFalse() methods; otherwise performs a conversion to QVariant::uint;
QVariant::Char - if the string begins with "\0x", expects it to be a UTF-16 code in hex; if the string begins with "\0", expects it to be a UTF-16 code in oct; if the string begins with "&", expects it to be a numeric character reference ("&#nnnn;" or "&#xhhhh;") or a predefined character entity reference; otherwise uses the first character in the string;

Namespaces

Classes

Typedefs

Functions

Detailed Description

Typedef Documentation

Function Documentation