trek::ExpectedStateAlarmSwitchSet Class Reference

This class switches expected state alarm sets. More...

#include <expected_state_alarm_switch_set.h>

Inherits trek::SwitchSet.

Public Member Functions
int32_t	AddExpectedStateAlarm (ExpectedStateAlarm *input)
	Adds an expected state alarm. More...
int32_t	AddExpectedStateAlarm (ExpectedStateAlarm &input)
	Adds an expected state alarm. More...
int32_t	DeleteExpectedStateAlarm (const char *name)
	Deletes the specified expected state alarm. More...
void	DeleteAllExpectedStateAlarms ()
	Deletes all of the expected state alarms. More...
ExpectedStateAlarm *	GetExpectedStateAlarm (const char *name)
	Returns the expected state alarm with the specified name. More...
int32_t	Check (const char *, ParameterStatus &status)
	Checks the supplied string value for an expected state violation. More...
Constructors, Destructor, and Other Basic Methods
	ExpectedStateAlarmSwitchSet ()
	Default constructor of the class.
	ExpectedStateAlarmSwitchSet (ExpectedStateAlarmSwitchSet &input)
	Copy constructor of the class.
virtual	~ExpectedStateAlarmSwitchSet ()
	Class destructor. More...
virtual SwitchSet *	Clone ()
	Creates and returns an extact copy of the object.
void	operator= (ExpectedStateAlarmSwitchSet &right_side)
	Provides the equal operator.
Serialization Methods
These methods help read and write the class to disk or memory. Most users will not be interested in these. Those that are can continue reading.
int32_t	LoadFile (const char *filename)
	Loads the Packet definition from the specified file. More...
int32_t	SaveFile (const char *filename)
	Saves the Packet definition to the specified file. More...
virtual int32_t	ToXml (XmlElement &element)
virtual int32_t	FromXml (XmlElement &element)
Public Member Functions inherited from trek::SwitchSet
int32_t	SetDefaultSetName (const char *name)
	Sets the default set name. More...
const char *	GetDefaultSetName ()
	Gets the default set name. More...
int32_t	SetSwitchParameterName (const char *name)
	Sets the name of the parameter to use as a switch. More...
const char *	GetSwitchParameterName ()
	Gets the parameter name for the switch. More...
void	SetSwitchType (switch_type input)
	Sets the type of switch to use. More...
switch_type	GetSwitchType ()
	Returns the current switch type. More...
int32_t	SetSwitchParameter (Parameter *input_ptr)
	Sets the parameter to use for switching. More...
int32_t	AddRangeSwitch (double low, double high, const char *name)
	Adds a range switch. More...
int32_t	AddEnumerationSwitch (const char *enum_name, const char *name)
	Adds an enumeration switch. More...
int32_t	DeleteRangeSwitch (double low)
	Deletes the specified range switch. More...
int32_t	DeleteEnumerationSwitch (const char *enum_name)
	Deletes the specified enumeration switch. More...
int32_t	GetRangeSwitches (double **input, uint32_t &array_size)
	Gets the low value for each range switch. More...
void	GetEnumerationSwitches (StringArray &input)
	Gets the enumeration values for the switch. More...
int32_t	GetRangeSwitchInfo (double low, double &high, char **name)
	Gets the high value and name for a range switch based on its low value. More...
int32_t	GetEnumerationInfo (const char *enum_name, char **name)
	Gets the name for a switch based on its enumerated value. More...
int32_t	Validate ()
	Determines if it is safe to use the switch set. More...
const char *	GetValidationErrors ()
	Gets a string of the last validation errors. More...
uint32_t	GetEnumerationInfoLength (const char *enum_name)
	Gets the length for returned info of input parameter. Does not include space for the NULL termination character. More...
int32_t	GetEnumerationInfo (const char *enum_name, char *name, uint16_t &name_size)
	Gets the name for a switch based on its enumerated value. More...
uint32_t	GetRangeSwitchInfoLength (double low)
	Gets the length for returned info of input parameter. Does not include space for the NULL termination character. More...
int32_t	GetRangeSwitchInfo (double low, double &high, char *name, uint16_t &name_size)
	Gets the high value and name for a range switch based on its low value. More...
uint32_t	GetNumberOfRangeSwitches ()
	Returns the number of range switches available. More...
int32_t	GetRangeSwitches (double *low_values, uint32_t low_value_size)
	Gets the low value for each range switch. More...
void	GetItemNames (StringArray &input)
	Retrieves an array of the (e.g., calibrator) names from the set. More...
	SwitchSet ()
	Default constructor of the class.
	SwitchSet (SwitchSet &input)
	Copy constructor of the class.
virtual	~SwitchSet ()
	Class destructor. More...
void	operator= (SwitchSet &right_side)
	Provides the equal operator.
virtual void	Init ()
	Initializes the object.
Public Member Functions inherited from trek::NamedItem
void	SetName (const char *input_ptr)
	Sets the name of the item. More...
void	SetAlias (const char *input)
	Sets the alias of the item. More...
void	SetShortDescription (const char *input_ptr)
	Sets the short description of the item. More...
void	SetLongDescription (const char *input_ptr)
	Sets the long description of the item. More...
void	SetUserDescription (const char *input_ptr)
	Sets the user description of the item. More...
void	SetOwner (const char *input_ptr)
	Sets the owner of the item. More...
const char *	GetName ()
	Returns the name of the item.
const char *	GetAlias ()
	Returns the alias of the item.
const char *	GetShortDescription ()
	Returns the short description of the item.
const char *	GetLongDescription ()
	Returns the long description of the item.
const char *	GetUserDescription ()
	Returns the user description of the item.
const char *	GetOwner ()
	Returns the owner of the item.
	NamedItem ()
	Default constructor of the class.
	NamedItem (NamedItem &input)
	Copy constructor of the class.
virtual	~NamedItem ()
	Class destructor. More...
void	operator= (NamedItem &right_side)
	Provides the equal operator.
bool	operator== (NamedItem &right_side)
	Provides the == operator.

Detailed Description

This class switches expected state alarm sets.

The details of switching are defined in SwitchSet. This class limits the type of information that is in the set and provides the serialization of the data.

Constructor & Destructor Documentation

~ExpectedStateAlarmSwitchSet()

trek::ExpectedStateAlarmSwitchSet::~ExpectedStateAlarmSwitchSet ( )

virtual

Class destructor.

Removes all resources created with this instance of the class.

Member Function Documentation

AddExpectedStateAlarm() [1/2]

int32_t trek::ExpectedStateAlarmSwitchSet::AddExpectedStateAlarm

(

ExpectedStateAlarm &

input

)

Adds an expected state alarm.

Adds the expected state alarm that can be referenced by a switch. The name of the expected state alarm is used for the reference.

Parameters

[in]

input

A copy is made for this class.

Returns

SUCCESS

TREK_DATA_NULL_PTR

TREK_DATA_ALREADY_EXISTS

Example:

ExpectedStateAlarmSwitchSet esss;
ExpectedStateAlarm esa;
 
esa.SetExpectedState( "On" );
 
ret_value = esss.AddExpectedStateAlarm( esa );

AddExpectedStateAlarm() [2/2]

int32_t trek::ExpectedStateAlarmSwitchSet::AddExpectedStateAlarm

(

ExpectedStateAlarm *

input

)

Adds an expected state alarm.

Adds the expected state alarm that can be referenced by a switch. The name of the expected state alarm is used for the reference.

Parameters

[in]

input

A pointer to a valid expected state alarm. A copy is made for this class.

Returns

SUCCESS

TREK_DATA_NULL_PTR

TREK_DATA_ALREADY_EXISTS

Example:

ExpectedStateAlarmSwitchSet esss;
ExpectedStateAlarm esa;
 
esa.SetExpectedState( "On" );
 
ret_value = esss.AddExpectedStateAlarm( &esa );

Check()

int32_t trek::ExpectedStateAlarmSwitchSet::Check	(	const char *	enum_str,
		ParameterStatus &	status
	)

Checks the supplied string value for an expected state violation.

Determines the correct expected state alarm to use based on the switching and checks the input value.

Parameters

[in]	enum_str	The value to check for violations.
[out]	status	Status to record violations.

Returns

SUCCESS

TREK_DATA_SWITCH_ERROR

other errors

Note

This method is typically only called by internal TReK code. Example:

ExpectedStateAlarmSwitchSet esss;
ParameterStatus status;
int ret_value;
 
ret_value = esss.Check( "On", status );
 
if( ret_value == SUCCESS )
{
    printf( "Status string is %s\n", status.GetStatusString() );
}

DeleteAllExpectedStateAlarms()

void trek::ExpectedStateAlarmSwitchSet::DeleteAllExpectedStateAlarms

(

)

Deletes all of the expected state alarms.

Example:

ExpectedStateAlarmSwitchSet esss;
ExpectedStateAlarm esa;
 
esa.SetName( "whatever" );
esa.SetExpectedState( "On" );
 
ret_value = esss.AddExpectedStateAlarm( esa );
esss.DeleteAllExpectedStateAlarms();

DeleteExpectedStateAlarm()

int32_t trek::ExpectedStateAlarmSwitchSet::DeleteExpectedStateAlarm

(

const char *

name

)

Deletes the specified expected state alarm.

Parameters

[in]

name

The name of the expected state alarm to delete.

Returns

SUCCESS

TREK_DATA_NULL_PTR

TREK_DATA_DOES_NOT_EXIST

Example:

ExpectedStateAlarmSwitchSet esss;
ExpectedStateAlarm esa;
 
esa.SetName( "whatever" );
esa.SetExpectedState( "On" );
 
ret_value = esss.AddExpectedStateAlarm( esa );
ret_value = esss.DeleteExpectedStateAlarm( "whatever" );

GetExpectedStateAlarm()

ExpectedStateAlarm * trek::ExpectedStateAlarmSwitchSet::GetExpectedStateAlarm

(

const char *

name

)

Returns the expected state alarm with the specified name.

The returned copy is owned by the class. Don't go deleting it.

Parameters

[in]

name

The name of the expected state alarm to find.

Returns

A pointer to the expected state alarm if found and NULL otherwise.

Example:

ExpectedStateAlarmSwitchSet esss;
ExpectedStateAlarm *es_ptr;
 
es_ptr = esss.GetCalibrator( "whatever" );
 
if( es_ptr )
{
    // safe to use
}

LoadFile()

int32_t trek::ExpectedStateAlarmSwitchSet::LoadFile

(

const char *

filename

)

Loads the Packet definition from the specified file.

Reads an XML format for the Packet. It can be written in with SaveFile.

Parameters

[in]

filename

The file to load the parameter object from.

Returns

SUCCESS

TREK_DATA_NULL_PTR

Other return codes

Example:

ExpectedStateAlarmSwitchSet esass;
 
ret_value = esass.LoadFile( "my_file.xml" );

SaveFile()

int32_t trek::ExpectedStateAlarmSwitchSet::SaveFile

(

const char *

filename

)

Saves the Packet definition to the specified file.

Writes an XML format for the Packet. It can be read in with LoadFile.

Parameters

[in]

filename

The file to save the parameter object to.

Returns

SUCCESS

TREK_DATA_NULL_PTR

Other return codes

Example:

ExpectedStateAlarmSwitchSet esass;
 
ret_value = esass.SaveFile( "my_file.xml" );