#include <RangeIssue.h>

Inheritance diagram for ers::RangeIssue:

Public Member Functions
	RangeIssue ()

	RangeIssue (const ers::Context &c, ers::severity_t s, int64_t min_index, int64_t index, int64_t max_index, const char *entity_name=0)

virtual const char *	get_class_name () const throw ()
	Get key for class (used for serialisation)

Public Member Functions inherited from ers::InvalidReferenceIssue
	InvalidReferenceIssue ()

	InvalidReferenceIssue (const Context &context, severity_t s, const void *pointer, const std::string &message, responsibility_t r=resp_unknown)

virtual const char *	get_class_name () const throw ()
	Get key for class (used for serialisation)

Public Member Functions inherited from ers::Issue
	Issue ()

	Issue (const Issue &issue)

	Issue (const string_map_type &values)

	Issue (const Context &context, severity_t s, const std::string &message)

	Issue (const Context &context, severity_t s, const std::exception *cause)

virtual	~Issue () throw ()

Issue *	clone () const

const Issue *	cause () const throw ()
	return the cause Issue of this Issue

void	cause (const std::exception *cause=0)
	Initialises the cause field.

	operator std::string () const
	Converts the issue into a string.

Issue	operator= (const Issue &issue)
	Affectation operator.

bool	operator== (const Issue &other) const throw ()
	Equality operator.

const std::string &	operator[] (const std::string &key) const throw ()

const std::string &	get_value (const std::string &key, const std::string &def) const throw ()
	Reads the property list.

const std::string &	get_value (const std::string &key) const throw ()

int	get_int_value (const std::string &key, int def=0) const throw ()
	Get a value of the table as an integer.

long	get_long_value (const std::string &key, long def=0) const throw ()
	Get a value of the table as a long integer.

double	get_double_value (const std::string key, double def) const throw ()
	Get a value of the table as double.

void	set_value (const std::string &key, uint8_t value) throw ()
	Sets a value 8 bit unsigned.

void	set_value (const std::string &key, uint16_t value) throw ()

void	set_value (const std::string &key, uint32_t value) throw ()

void	set_value (const std::string &key, uint64_t value) throw ()

void	set_value (const std::string &key, int8_t value) throw ()

void	set_value (const std::string &key, int16_t value) throw ()

void	set_value (const std::string &key, int32_t value) throw ()

void	set_value (const std::string &key, int64_t value) throw ()

void	set_value (const std::string &key, double value) throw ()
	Sets a value (double float)

void	set_value (const std::string &key, const std::string &value) throw ()
	Sets a value (string)

void	set_value (const std::string &key, const char *value) throw ()
	Sets a value (c-string)

void	set_value (const std::string &key, const void *ptr) throw ()

int	values_number () const
	How many key / values.

virtual const char *	get_class_name () const throw ()
	Get key for class (used for serialisation)

const string_map_type *	get_value_table () const
	extract value table

severity_t	severity () const throw ()
	severity_t of the issue

void	severity (severity_t s)
	sets the severity_t of the issue

bool	is_error ()
	is the issue an error (or fatal).

std::string	severity_message () const
	message associated with the severity_t of the issue

void	responsibility (responsibility_t r)
	set the responsability of the issue

responsibility_t	responsibility () const throw ()
	get the responsability level of the issue

void	transience (bool tr)
	sets if the issue is transient

int	transience () const throw ()
	is the issue transient

const std::string &	human_description () const throw ()
	Human description message.

const char *	what () const throw ()
	Human description message.

const std::string &	message () const throw ()
	Message.

virtual int	exit_value () const throw ()
	value to pass to exit

void	add_qualifier (const std::string &qualif)
	adds a qualifier to the issue

std::vector< std::string >	qualifiers () const
	return array of qualifiers

Static Public Member Functions
static void	set_range (ers::Issue &issue, int64_t index, int64_t min_index, int64_t max_index, const char *entity_name=0)

static void	check_range (const ers::Context &c, int64_t min, int64_t value, int64_t max, const char *entity_name=0)

Static Public Member Functions inherited from ers::InvalidReferenceIssue
static void	check_reference (const Context &context, severity_t s, const void pointer, const char ptr_name, responsibility_t r)

Static Public Attributes
static const char *const	CLASS_NAME = "ers::RangeIssue"

static const char *const	INDEX_REFERENCE_TYPE = "scalar"

static const char *const	RANGE_MIN_KEY = "REFERENCE_RANGE_MIN"

static const char *const	RANGE_MAX_KEY = "REFERENCE_RANGE_MAX"

Static Public Attributes inherited from ers::InvalidReferenceIssue
static const char *const	CLASS_NAME = "ers::InvalidReferenceIssue"

static const char *const	REFERENCE_VALUE_KEY = "REFERENCE_VALUE"

static const char *const	REFERENCE_TYPE_KEY = "REFERENCE_TYPE"

static const char *const	REFERENCE_NAME_KEY = "REFERENCE_NAME"

static const char *const	REFERENCE_C_PTR_TYPE = "C Pointer"

Static Public Attributes inherited from ers::Issue
static const char *const	CLASS_KEY = "ISSUE_CLASS"
	key for class information

static const char *const	COMPILATION_TIME_KEY = "COMPILATION_TIME"
	key for compilation time

static const char *const	COMPILATION_TARGET_KEY = "COMPILATION_TARGET"
	key for compilation target

static const char *const	COMPILER_KEY = "COMPILER"
	key for compilator type

static const char *const	COMPILATION_DEBUG_LVL_KEY = "COMPILATION_DEBUG_LVL"

static const char *const	CPP_CLASS_KEY = "ISSUE_CPP_CLASS"
	key for c++ class (might be mangled)

static const char *const	ERS_VERSION_KEY = "ERS_VERSION"
	key for ERS version

static const char *const	HOST_NAME_KEY = "HOST_NAME"
	key for hostname

static const char *const	HOST_TYPE_KEY = "HOST_TYPE"
	key for host type (architecture / os)

static const char *const	HOST_IP_ADDR_KEY = "HOST_IP"
	key for host ip address

static const char *const	MESSAGE_KEY = "MESSAGE"
	key for human readable

static const char *const	PROCESS_ID_KEY = "PROCESS_ID"
	key for the process id (number)

static const char *const	PROCESS_PWD_KEY = "PROCESS_PWD"
	key for the process working directory

static const char *const	PROGRAM_NAME_KEY = "PROGRAM_NAME"
	key for the name of the program

static const char *const	RESPONSIBILITY_KEY = "RESPONSIBILITY"
	key for the responsibility of the issue (text)

static const char *const	SEVERITY_KEY = "SEVERITY"
	key for the severity_t of the issue

static const char *const	SOURCE_POSITION_KEY = "SOURCE_POSITION"
	key for position in the source code

static const char *const	SOURCE_PACKAGE_KEY = "SOURCE_PACKAGE"
	package name associated with source code

static const char *const	TIME_KEY = "TIME"
	key for the time of the issue (text)

static const char *const	TRANSIENCE_KEY = "TRANSIENCE"
	key for the transience of the issue (text)

static const char *const	USER_ID_KEY = "USER_ID"
	key for the user-id of the owner of the process

static const char *const	USER_NAME_KEY = "USER_NAME"
	key for the user-name of the owner of the process

static const char *const	CAUSE_PSEUDO_KEY = "CAUSE"
	key used when serializing the cause issue, this key is not used in the value table

static const char *const	CAUSE_TEXT_KEY = "CAUSE_TEXT"
	key used to store the cause issue's message

static const char *const	QUALIFIER_LIST_KEY = "QUALIFIERS"
	key used to store the qualifier list

static const char *const	EXIT_VALUE_KEY = "EXIT_VALUE"
	key used to store the exit value

static const char *const	ISSUE_CLASS_NAME = "ers::issue"
	name of the class, used for serialisation

Protected Member Functions
	RangeIssue (const ers::Context &c, ers::severity_t s)

Protected Member Functions inherited from ers::InvalidReferenceIssue
void	pointer (const void *p)

	InvalidReferenceIssue (const Context &context, severity_t s)

Protected Member Functions inherited from ers::Issue
void	insert (const Context *context) throw ()
	Inserts the context.

void	insert_time () throw ()
	Inserts current time.

void	setup_common (const Context *context) throw ()
	Sets up the common fields.

void	finish_setup (const std::string &message) throw ()
	Finishes the setup of the Issue.

	Issue (const Context &context, severity_t s)
	Constructor for subclasses.

void	set_values (const string_map_type &values) throw ()
	sets the value table

Additional Inherited Members
Protected Attributes inherited from ers::Issue
Issue *	m_cause
	Issue that caused the current issue.

std::string	m_class_name
	class name

std::string	m_human_description
	Human readable description (cache)

string_map_type	m_value_table
	Optional properties.

Detailed Description

Definition at line 15 of file RangeIssue.h.

Constructor & Destructor Documentation

◆ RangeIssue() [1/3]

ers::RangeIssue::RangeIssue	(	const ers::Context &	c,
		ers::severity_t	s
	)

protected

Definition at line 44 of file RangeIssue.cxx.

                                                              : ers::InvalidReferenceIssue(c,s) {
    set_value(REFERENCE_TYPE_KEY,INDEX_REFERENCE_TYPE) ;
} // RangeIssue

◆ RangeIssue() [2/3]

ers::RangeIssue::RangeIssue ( )

Definition at line 42 of file RangeIssue.cxx.

42: ers::InvalidReferenceIssue() {}

Referenced by check_range().

◆ RangeIssue() [3/3]

ers::RangeIssue::RangeIssue	(	const ers::Context &	c,
		ers::severity_t	s,
		int64_t	min_index,
		int64_t	index,
		int64_t	max_index,
		const char *	entity_name = `0`
	)

Definition at line 48 of file RangeIssue.cxx.

                                                                                                                                            : ers::InvalidReferenceIssue(c,s) {
    set_range(*this,index,min_index,max_index,entity_name) ; 
    std::ostringstream message_stream ;
    message_stream << "invalid index: " ; 
    if (entity_name) {
    message_stream << entity_name << '='; 
    } // entity
    message_stream  << index << " is not in range " << min_index << '-' << max_index ;  
    finish_setup(message_stream.str()); 
} // RangeIssue

Member Function Documentation

◆ check_range()

void ers::RangeIssue::check_range	(	const ers::Context &	c,
		int64_t	min,
		int64_t	value,
		int64_t	max,
		const char *	entity_name = `0`
	)

static

Definition at line 25 of file RangeIssue.cxx.

                                                                                                                     {
    if ((value>max) || (value<min)) throw RangeIssue(c,ers::error,min,value,max,entity_name); 
} // check_range

◆ get_class_name()

const char * ers::RangeIssue::get_class_name	(	)	const
throw	(
	)

virtual

Get key for class (used for serialisation)

Returns the key used to describe this particular class when serializing This method tries to build a meaningfull class name out of C++ RTTI. This depends on the compiler providing information in a format similar to gcc. For more safety. If the gcc unmangling fails the default (ers::Issue) is used.

Reimplemented from ers::InvalidReferenceIssue.

Definition at line 59 of file RangeIssue.cxx.

59{ return CLASS_NAME ; }

ers::RangeIssue::CLASS_NAME

static const char *const CLASS_NAME

Definition: RangeIssue.h:21

◆ set_range()

void ers::RangeIssue::set_range	(	ers::Issue &	issue,
		int64_t	index,
		int64_t	min_index,
		int64_t	max_index,
		const char *	entity_name = `0`
	)

static

Definition at line 30 of file RangeIssue.cxx.

                                                                                                                           {
    issue.set_value(REFERENCE_VALUE_KEY,index) ; 
    issue.set_value(RANGE_MIN_KEY,min_index);
    issue.set_value(RANGE_MAX_KEY,max_index);
    std::ostringstream reference_stream ;
    reference_stream << INDEX_REFERENCE_TYPE ; 
    if (entity_name) {
    reference_stream << "(name=" << entity_name << ')' ; 
    } 
    issue.set_value(REFERENCE_TYPE_KEY,reference_stream.str()) ; 
} // set_range

Referenced by RangeIssue().

Member Data Documentation

◆ CLASS_NAME

const char *const ers::RangeIssue::CLASS_NAME = "ers::RangeIssue"

static

Definition at line 21 of file RangeIssue.h.

◆ INDEX_REFERENCE_TYPE

const char *const ers::RangeIssue::INDEX_REFERENCE_TYPE = "scalar"

static

Definition at line 22 of file RangeIssue.h.

Referenced by RangeIssue().

◆ RANGE_MAX_KEY

const char *const ers::RangeIssue::RANGE_MAX_KEY = "REFERENCE_RANGE_MAX"

static

Definition at line 24 of file RangeIssue.h.

◆ RANGE_MIN_KEY

const char *const ers::RangeIssue::RANGE_MIN_KEY = "REFERENCE_RANGE_MIN"

static

Definition at line 23 of file RangeIssue.h.

The documentation for this class was generated from the following files:

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ RangeIssue() [1/3]

◆ RangeIssue() [2/3]

◆ RangeIssue() [3/3]

Member Function Documentation

◆ check_range()

◆ get_class_name()

◆ set_range()

Member Data Documentation

◆ CLASS_NAME

◆ INDEX_REFERENCE_TYPE

◆ RANGE_MAX_KEY

◆ RANGE_MIN_KEY