This class represents a Tango attribute. More...

#include "tango.h"

Inheritance diagram for Tango::Attribute:

Public Member Functions
Constructors
Miscellaneous constructors
	Attribute (vector< AttrProperty > &prop_list, Attr &tmp_attr, string &dev_name, long idx)
	Create a new Attribute object. More...

Destructor
Only one desctructor is defined for this class
virtual	~Attribute ()
	The attribute destructor.

Check attribute methods
Miscellaneous method returning boolean flag according to attribute state
bool	is_writ_associated ()
	Check if the attribute has an associated writable attribute. More...

bool	is_min_alarm ()
	Check if the attribute is in minimum alarm condition . More...

bool	is_max_alarm ()
	Check if the attribute is in maximum alarm condition . More...

bool	is_min_warning ()
	Check if the attribute is in minimum warning condition . More...

bool	is_max_warning ()
	Check if the attribute is in maximum warning condition . More...

bool	is_rds_alarm ()
	Check if the attribute is in RDS alarm condition . More...

bitset< numFlags > &	is_alarmed ()
	Check if the attribute has an alarm defined. More...

bool	is_polled ()
	Check if the attribute is polled . More...

bool	check_alarm ()
	Check if the attribute read value is below/above the alarm level. More...

Get/Set object members.
These methods allow the external world to get/set DeviceImpl instance data members
Tango::AttrWriteType	get_writable ()
	Get the attribute writable type (RO/WO/RW). More...

string &	get_name ()
	Get attribute name. More...

long	get_data_type ()
	Get attribute data type. More...

Tango::AttrDataFormat	get_data_format ()
	Get attribute data format. More...

string &	get_assoc_name ()
	Get name of the associated writable attribute. More...

long	get_assoc_ind ()
	Get index of the associated writable attribute. More...

void	set_assoc_ind (long val)
	Set index of the associated writable attribute. More...

Tango::TimeVal &	get_date ()
	Get attribute date. More...

void	set_date (Tango::TimeVal &new_date)
	Set attribute date. More...

void	set_date (struct timeval &t)
	Set attribute date. More...

void	set_date (time_t new_date)
	Set attribute date. More...

string &	get_label ()
	Get attribute label property. More...

Tango::AttrQuality &	get_quality ()
	Get attribute data quality. More...

void	set_quality (Tango::AttrQuality qua, bool send_event=false)
	Set attribute data quality. More...

long	get_data_size ()
	Get attribute data size. More...

long	get_x ()
	Get attribute data size in x dimension. More...

long	get_max_dim_x ()
	Get attribute maximum data size in x dimension. More...

long	get_y ()
	Get attribute data size in y dimension. More...

long	get_max_dim_y ()
	Get attribute maximum data size in y dimension. More...

long	get_polling_period ()
	Get attribute polling period. More...

template<typename T >
void	get_properties (Tango::MultiAttrProp< T > &props)
	Get all modifiable attribute properties in one call. More...

template<typename T >
void	set_properties (Tango::MultiAttrProp< T > &props)
	Set all modifiable attribute properties in one call. More...

void	set_attr_serial_model (AttrSerialModel ser_model)
	Set attribute serialization model. More...

AttrSerialModel	get_attr_serial_model ()
	Get attribute serialization model. More...

void	set_user_attr_mutex (omni_mutex *mut_ptr)
	Set attribute user mutex. More...

Set attribute value methods.
These methods allows the external world to set attribute object internal value
void	set_value (Tango::DevShort *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevShort attribute data type). More...

void	set_value (Tango::DevLong *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevLong attribute data type). More...

void	set_value (Tango::DevLong64 *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevLong64 attribute data type). More...

void	set_value (Tango::DevFloat *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevFloat attribute data type). More...

void	set_value (Tango::DevDouble *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevDouble attribute data type). More...

void	set_value (Tango::DevString *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevString attribute data type). More...

void	set_value (Tango::DevBoolean *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevBoolean attribute data type). More...

void	set_value (Tango::DevUShort *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevUShort attribute data type). More...

void	set_value (Tango::DevUChar *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevUChar attribute data type). More...

void	set_value (Tango::DevULong *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevULong attribute data type). More...

void	set_value (Tango::DevULong64 *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevULong64 attribute data type). More...

void	set_value (Tango::DevState *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevState attribute data type). More...

void	set_value (Tango::DevEncoded *p_data, long x=1, long y=0, bool release=false)
	Set internal attribute value (for Tango::DevEncoded attribute data type). More...

void	set_value (Tango::DevString p_data_str, Tango::DevUChar p_data, long size, bool release=false)
	Set internal attribute value (for Tango::DevEncoded attribute data type). More...

void	set_value (Tango::EncodedAttribute *attr)
	Set internal attribute value (for Tango::DevEncoded attribute data type). More...

void	set_value_date_quality (Tango::DevShort *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevShort attribute data type). More...

void	set_value_date_quality (Tango::DevShort *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevShort attribute data type). More...

void	set_value_date_quality (Tango::DevLong *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevLong attribute data type). More...

void	set_value_date_quality (Tango::DevLong *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevLong attribute data type). More...

void	set_value_date_quality (Tango::DevLong64 *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevLong64 attribute data type). More...

void	set_value_date_quality (Tango::DevLong64 *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevLong64 attribute data type). More...

void	set_value_date_quality (Tango::DevFloat *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevFloat attribute data type). More...

void	set_value_date_quality (Tango::DevFloat *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevFloat attribute data type). More...

void	set_value_date_quality (Tango::DevDouble *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevDouble attribute data type). More...

void	set_value_date_quality (Tango::DevDouble *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevDouble attribute data type). More...

void	set_value_date_quality (Tango::DevString *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevString attribute data type). More...

void	set_value_date_quality (Tango::DevString *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevString attribute data type). More...

void	set_value_date_quality (Tango::DevBoolean *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevBoolean attribute data type). More...

void	set_value_date_quality (Tango::DevBoolean *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevBoolean attribute data type). More...

void	set_value_date_quality (Tango::DevUShort *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevUShort attribute data type). More...

void	set_value_date_quality (Tango::DevUShort *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevUShort attribute data type). More...

void	set_value_date_quality (Tango::DevUChar *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevUChar attribute data type). More...

void	set_value_date_quality (Tango::DevUChar *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevUChar attribute data type). More...

void	set_value_date_quality (Tango::DevULong *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevULong attribute data type). More...

void	set_value_date_quality (Tango::DevULong *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevULong attribute data type). More...

void	set_value_date_quality (Tango::DevULong64 *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevULong64 attribute data type). More...

void	set_value_date_quality (Tango::DevULong64 *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevULong64 attribute data type). More...

void	set_value_date_quality (Tango::DevState *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevState attribute data type). More...

void	set_value_date_quality (Tango::DevState *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevState attribute data type). More...

void	set_value_date_quality (Tango::DevEncoded *p_data, time_t t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevEncoded attribute data type). More...

void	set_value_date_quality (Tango::DevString p_data_str, Tango::DevUChar p_data, long size, time_t t, Tango::AttrQuality qual, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevEncoded attribute data type when splitted in format and data). More...

void	set_value_date_quality (Tango::DevEncoded *p_data, struct timeval &t, Tango::AttrQuality qual, long x=1, long y=0, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevEncoded attribute data type). More...

void	set_value_date_quality (Tango::DevString p_data_str, Tango::DevUChar p_data, long size, struct timeval &t, Tango::AttrQuality qual, bool release=false)
	Set internal attribute value, date and quality factor (for Tango::DevEncoded attribute data type when splitted in data format and data themselves). More...

void	fire_change_event (DevFailed *except=NULL)
	Fire a change event for the attribute value. More...

void	set_change_event (bool implemented, bool detect=true)
	Set a flag to indicate that the server fires change events manually, without the polling to be started for the attribute. More...

bool	is_change_event ()
	Check if the change event is fired manually (without polling) for this attribute. More...

bool	is_check_change_criteria ()
	Check if the change event criteria should be checked when firing the event manually. More...

void	fire_archive_event (DevFailed *except=NULL)
	Fire an archive event for the attribute value. More...

void	set_archive_event (bool implemented, bool detect=true)
	Set a flag to indicate that the server fires archive events manually, without the polling to be started for the attribute If the detect parameter is set to true, the criteria specified for the archive event are verified and the event is only pushed if they are fulfilled. More...

bool	is_archive_event ()
	Check if the archive event is fired manually for this attribute. More...

bool	is_check_archive_criteria ()
	Check if the archive event criteria should be checked when firing the event manually. More...

void	set_data_ready_event (bool implemented)
	Set a flag to indicate that the server fires data ready events. More...

bool	is_data_ready_event ()
	Check if the data ready event is fired for this attribute. More...

void	fire_event (vector< string > &filt_names, vector< double > &filt_vals, DevFailed *except=NULL)
	Fire a user event for the attribute value. More...

void	remove_configuration ()
	Remove the attribute configuration from the database. More...

Set/Get attribute ranges (min_alarm, min_warning, max_warning, max_alarm) methods.
These methods allow the external world to set attribute object min_alarm, min_warning, max_warning and max_alarm values
template<typename T >
void	set_min_alarm (const T &new_min_alarm)
	Set attribute minimum alarm. More...

void	set_min_alarm (char *new_min_alarm)
	Set attribute minimum alarm. More...

void	set_min_alarm (const char *new_min_alarm)
	Set attribute minimum alarm. More...

template<typename T >
void	get_min_alarm (T &min_al)
	Get attribute minimum alarm or throw an exception if the attribute does not have the minimum alarm. More...

template<typename T >
void	set_max_alarm (const T &new_max_alarm)
	Set attribute maximum alarm. More...

void	set_max_alarm (char *new_max_alarm)
	Set attribute maximum alarm. More...

void	set_max_alarm (const char *new_max_alarm)
	Set attribute maximum alarm. More...

template<typename T >
void	get_max_alarm (T &max_al)
	Get attribute maximum alarm or throw an exception if the attribute does not have the maximum alarm set. More...

template<typename T >
void	set_min_warning (const T &new_min_warning)
	Set attribute minimum warning. More...

void	set_min_warning (char *new_min_warning)
	Set attribute minimum warning. More...

void	set_min_warning (const char *new_min_warning)
	Set attribute minimum warning. More...

template<typename T >
void	get_min_warning (T &min_war)
	Get attribute minimum warning or throw an exception if the attribute does not have the minimum warning set. More...

template<typename T >
void	set_max_warning (const T &new_max_warning)
	Set attribute maximum warning. More...

void	set_max_warning (char *new_max_warning)
	Set attribute maximum warning. More...

void	set_max_warning (const char *new_max_warning)
	Set attribute maximum warning. More...

template<typename T >
void	get_max_warning (T &max_war)
	Get attribute maximum warning or throw an exception if the attribute does not have the maximum warning set. More...

Protected Attributes
Class data members
bool	value_flag
	A flag set to true if the attribute value has been updated.

Tango::TimeVal	when
	The date when attribute was read.

bool	date
	Flag set to true if the date must be set.

Tango::AttrQuality	quality
	The attribute quality factor.

string	name
	The attribute name.

Tango::AttrWriteType	writable
	The attribute writable flag.

long	data_type
	The attribute data type. More...

Tango::AttrDataFormat	data_format
	The attribute data format. More...

long	max_x
	The attribute maximum x dimension. More...

long	max_y
	The attribute maximum y dimension. More...

string	label
	The attribute label.

string	description
	The attribute description.

string	unit
	The attribute unit.

string	standard_unit
	The attribute standard unit.

string	display_unit
	The attribute display unit.

string	format
	The attribute format. More...

string	writable_attr_name
	The name of the associated writable attribute.

string	min_alarm_str
	The attribute minimum alarm level.

string	max_alarm_str
	The attribute maximun alarm level.

string	min_value_str
	The attribute minimum value.

string	max_value_str
	The attribute maximum value.

string	min_warning_str
	The attribute minimun warning.

string	max_warning_str
	The attribute maximum warning.

string	delta_val_str
	The attribute delta value RDS alarm.

string	delta_t_str
	The attribute delta time RDS alarm.

long	assoc_ind
	Index in the main attribute vector of the associated writable attribute (if any)

Tango::Attr_CheckVal	min_alarm
	The attribute minimum alarm in binary format.

Tango::Attr_CheckVal	max_alarm
	The attribute maximum alarm in binary format.

Tango::Attr_CheckVal	min_warning
	The attribute minimum warning in binary format.

Tango::Attr_CheckVal	max_warning
	The attribute maximum warning in binary format.

Tango::Attr_CheckVal	min_value
	The attribute minimum value in binary format.

Tango::Attr_CheckVal	max_value
	The attribute maximum value in binary format.

Tango::Attr_Value	value
	The attribute value.

long	data_size
	The attribute data size.

bool	check_min_value
	Flag set to true if a minimum value is defined.

bool	check_max_value
	Flag set to true if a maximum alarm is defined.

Tango::Attr_CheckVal	delta_val
	Authorized delta between the last written value and the actual read. More...

long	delta_t
	Delta time after which the read value must be checked again the last written value if the attribute has an alarm on Read Different Than Set (RDS)

vector< string >	enum_labels
	Enumeration labels when the attribute data type is DevEnum.

Detailed Description

This class represents a Tango attribute.

$Author$ $Revision$

Constructor & Destructor Documentation

◆ Attribute()

Tango::Attribute::Attribute	(	vector< AttrProperty > &	prop_list,
		Attr &	tmp_attr,
		string &	dev_name,
		long	idx
	)

Create a new Attribute object.

Parameters

prop_list	The attribute properties list. Each property is an object of the AttrProperty class
tmp_attr	Temporary attribute object built from user parameters
dev_name	The device name
idx	The index of the related Attr object in the MultiClassAttribute vector of Attr object

Member Function Documentation

◆ check_alarm()

bool Tango::Attribute::check_alarm ( )

Check if the attribute read value is below/above the alarm level.

Returns: A boolean set to true if the attribute is in alarm condition.

Exceptions

DevFailed If no alarm level is defined. Click here to read DevFailed exception specification

Referenced by Tango::MultiAttribute::check_alarm().

◆ fire_archive_event()

void Tango::Attribute::fire_archive_event ( DevFailed * except = NULL )

Fire an archive event for the attribute value.

The event is pushed to the notification daemon. The attibute data must be set with one of the Attribute::set_value or Attribute::setvalue_date_quality methods before fireing the event. The event is triggered with or without the archive event criteria depending on the configuration choosen with set_archive_event(). ATTENTION: The couple set_value() and fire_archive_event() needs to be protected against concurrent accesses to the same attribute. Such an access might happen during a synchronous read or by a reading from the polling thread. Inside all methods reading or writing commands and attributes this protection is automatically done by the Tango serialisation monitor. When fireing archive events in your own code, you should use the push_archive_event methods of the DeviceImpl class or protect your code with the Tango::AutoTangoMonitor on your device. Example:

{ Tango::AutoTangoMonitor synch(this); att_temp_seq.set_value (temp_seq, 100); att_temp_seq.fire_archive_event (); }

Parameters

except A pointer to a DevFailed exception to be thrown as archive event.

◆ fire_change_event()

void Tango::Attribute::fire_change_event ( DevFailed * except = NULL )

Fire a change event for the attribute value.

The event is pushed to the notification daemon. The attibute data must be set with one of the Attribute::set_value or Attribute::setvalue_date_quality methods before fireing the event. The event is triggered with or without the change event criteria depending on the configuration choosen with set_change_event(). ATTENTION: The couple set_value() and fire_change_event() needs to be protected against concurrent accesses to the same attribute. Such an access might happen during a synchronous read or by a reading from the polling thread. Inside all methods reading or writing commands and attributes this protection is automatically done by the Tango serialisation monitor. When fireing change events in your own code, you should use the push_change_event methods of the DeviceImpl class or protect your code with the Tango::AutoTangoMonitor on your device. Example:

{ Tango::AutoTangoMonitor synch(this); att_temp_seq.set_value (temp_seq, 100); att_temp_seq.fire_archive_event (); }

Parameters

except A pointer to a DevFailed exception to be thrown as archive event.

◆ fire_event()

void Tango::Attribute::fire_event	(	vector< string > &	filt_names,
		vector< double > &	filt_vals,
		DevFailed *	except = `NULL`
	)

Fire a user event for the attribute value.

The event is pushed to the notification daemon. The attibute data must be set with one of the Attribute::set_value or Attribute::setvalue_date_quality methods before fireing the event. ATTENTION: The couple set_value() and fire_event() needs to be protected against concurrent accesses to the same attribute. Such an access might happen during a synchronous read or by a reading from the polling thread. Inside all methods reading or writing commands and attributes this protection is automatically done by the Tango serialisation monitor. When fireing archive events in your own code, you should use the push_event methods of the DeviceImpl class or protect your code with the Tango::AutoTangoMonitor on your device. Example:

{ Tango::AutoTangoMonitor synch(this); att_temp_seq.set_value (temp_seq, 100); att_temp_seq.fire_event (); }

Parameters

filt_names	The filterable fields name
filt_vals	The filterable fields value (as double)
except	A pointer to a DevFailed exception to be thrown as archive event.

◆ get_assoc_ind()

long Tango::Attribute::get_assoc_ind ( )

inline

Get index of the associated writable attribute.

Returns: The index in the main attribute vector of the associated writable attribute

References assoc_ind.

◆ get_assoc_name()

string& Tango::Attribute::get_assoc_name ( )

inline

Get name of the associated writable attribute.

Returns: The associated writable attribute name

References writable_attr_name.

◆ get_attr_serial_model()

AttrSerialModel Tango::Attribute::get_attr_serial_model ( )

inline

Get attribute serialization model.

Get the attribute serialization model

Returns: The attribute serialization model

◆ get_data_format()

Tango::AttrDataFormat Tango::Attribute::get_data_format ( )

inline

Get attribute data format.

Returns: The attribute data format

References data_format.

◆ get_data_size()

long Tango::Attribute::get_data_size ( )

inline

Get attribute data size.

Returns: The attribute data size

References data_size.

◆ get_data_type()

long Tango::Attribute::get_data_type ( )

inline

Get attribute data type.

Returns: The attribute data type

References data_type.

◆ get_date()

Tango::TimeVal& Tango::Attribute::get_date ( )

inline

Get attribute date.

Returns: The attribute date

References when.

◆ get_label()

string& Tango::Attribute::get_label ( )

inline

Get attribute label property.

Returns: The attribute label

References label.

◆ get_max_alarm()

template<typename T >

void Tango::Attribute::get_max_alarm ( T & max_al )

Get attribute maximum alarm or throw an exception if the attribute does not have the maximum alarm set.

Parameters

max_al Reference to a variable which value will be set to the attribute's maximum alarm

◆ get_max_dim_x()

long Tango::Attribute::get_max_dim_x ( )

inline

Get attribute maximum data size in x dimension.

Returns: The attribute maximum data size in x dimension. Set to 1 for scalar attribute

References max_x.

◆ get_max_dim_y()

long Tango::Attribute::get_max_dim_y ( )

inline

Get attribute maximum data size in y dimension.

Returns: The attribute maximum data size in y dimension. Set to 0 for scalar and spectrum attribute

References max_y.

◆ get_max_warning()

template<typename T >

void Tango::Attribute::get_max_warning ( T & max_war )

Get attribute maximum warning or throw an exception if the attribute does not have the maximum warning set.

Parameters

max_war Reference to a variable which value will be set to the attribute's maximum warning

◆ get_min_alarm()

template<typename T >

void Tango::Attribute::get_min_alarm ( T & min_al )

Get attribute minimum alarm or throw an exception if the attribute does not have the minimum alarm.

Parameters

min_al Reference to a variable which value will be set to the attribute's minimum alarm

◆ get_min_warning()

template<typename T >

void Tango::Attribute::get_min_warning ( T & min_war )

Get attribute minimum warning or throw an exception if the attribute does not have the minimum warning set.

Parameters

min_war Reference to a variable which value will be set to the attribute's minimum warning

◆ get_name()

string& Tango::Attribute::get_name ( )

inline

Get attribute name.

Returns: The attribute name

References name.

◆ get_polling_period()

long Tango::Attribute::get_polling_period ( )

inline

Get attribute polling period.

Returns: The attribute polling period in mS. Set to 0 when the attribute is not polled

◆ get_properties()

template<typename T >

void Tango::Attribute::get_properties ( Tango::MultiAttrProp< T > & props )

Get all modifiable attribute properties in one call.

This method initializes the members of a MultiAttrProp object with the modifiable attribute properties values

Parameters

props A MultiAttrProp object.

◆ get_quality()

Tango::AttrQuality& Tango::Attribute::get_quality ( )

inline

Get attribute data quality.

Returns: The attribute data quality

References quality.

◆ get_writable()

Tango::AttrWriteType Tango::Attribute::get_writable ( )

inline

Get the attribute writable type (RO/WO/RW).

Returns: The attribute write type.

References writable.

◆ get_x()

long Tango::Attribute::get_x ( )

inline

Get attribute data size in x dimension.

Returns: The attribute data size in x dimension. Set to 1 for scalar attribute

◆ get_y()

long Tango::Attribute::get_y ( )

inline

Get attribute data size in y dimension.

Returns: The attribute data size in y dimension. Set to 0 for scalar and spectrum attribute

◆ is_alarmed()

bitset<numFlags>& Tango::Attribute::is_alarmed ( )

inline

Check if the attribute has an alarm defined.

This method returns a set of bits. Each alarm type is defined by one bit.

Returns: A bitset. Each bit is set if the coresponding alarm is on

◆ is_archive_event()

bool Tango::Attribute::is_archive_event ( )

inline

Check if the archive event is fired manually for this attribute.

Returns: A boolean set to true if a manual fire archive event is implemented.

◆ is_change_event()

bool Tango::Attribute::is_change_event ( )

inline

Check if the change event is fired manually (without polling) for this attribute.

Returns: A boolean set to true if a manual fire change event is implemented.

◆ is_check_archive_criteria()

bool Tango::Attribute::is_check_archive_criteria ( )

inline

Check if the archive event criteria should be checked when firing the event manually.

Returns: A boolean set to true if a archive event criteria will be checked.

◆ is_check_change_criteria()

bool Tango::Attribute::is_check_change_criteria ( )

inline

Check if the change event criteria should be checked when firing the event manually.

Returns: A boolean set to true if a change event criteria will be checked.

◆ is_data_ready_event()

bool Tango::Attribute::is_data_ready_event ( )

inline

Check if the data ready event is fired for this attribute.

Returns: A boolean set to true if a fire data ready event is implemented.

◆ is_max_alarm()

bool Tango::Attribute::is_max_alarm ( )

inline

Check if the attribute is in maximum alarm condition .

Returns: A boolean set to true if the attribute is in alarm condition (read value above the max. alarm).

◆ is_max_warning()

bool Tango::Attribute::is_max_warning ( )

inline

Check if the attribute is in maximum warning condition .

Returns: A boolean set to true if the attribute is in warning condition (read value above the max. warning).

◆ is_min_alarm()

bool Tango::Attribute::is_min_alarm ( )

inline

Check if the attribute is in minimum alarm condition .

Returns: A boolean set to true if the attribute is in alarm condition (read value below the min. alarm).

◆ is_min_warning()

bool Tango::Attribute::is_min_warning ( )

inline

Check if the attribute is in minimum warning condition .

Returns: A boolean set to true if the attribute is in warning condition (read value below the min. warning).

◆ is_polled()

bool Tango::Attribute::is_polled ( )

Check if the attribute is polled .

Returns: A boolean set to true if the attribute is polled.

◆ is_rds_alarm()

bool Tango::Attribute::is_rds_alarm ( )

inline

Check if the attribute is in RDS alarm condition .

Returns: A boolean set to true if the attribute is in RDS condition (Read Different than Set).

◆ is_writ_associated()

bool Tango::Attribute::is_writ_associated ( )

Check if the attribute has an associated writable attribute.

This method returns a boolean set to true if the attribute has a writable attribute associated to it.

Returns: A boolean set to true if there is an associated writable attribute

◆ remove_configuration()

void Tango::Attribute::remove_configuration ( )

Remove the attribute configuration from the database.

This method can be used to clean-up all the configuration of an attribute to come back to its default values or the remove all configuration of a dynamic attribute before deleting it.

The method removes all configured attribute properties and removes the attribute from the list of polled attributes.

Exceptions

DevFailed In case of database access problems. Click here to read DevFailed exception specification

◆ set_archive_event()

void Tango::Attribute::set_archive_event	(	bool	implemented,
		bool	detect = `true`
	)

inline

Set a flag to indicate that the server fires archive events manually, without the polling to be started for the attribute If the detect parameter is set to true, the criteria specified for the archive event are verified and the event is only pushed if they are fulfilled.

If detect is set to false the event is fired without any value checking!

Parameters

implemented	True when the server fires archive events manually.
detect	Triggers the verification of the archive event properties when set to true.

◆ set_assoc_ind()

void Tango::Attribute::set_assoc_ind ( long val )

inline

Set index of the associated writable attribute.

Parameters

val	The new index in the main attribute vector of the associated writable attribute

References assoc_ind.

◆ set_attr_serial_model()

void Tango::Attribute::set_attr_serial_model ( AttrSerialModel ser_model )

Set attribute serialization model.

This method allows the user to choose the attribute serialization model.

Parameters

ser_model The new serialisation model. The serialization model must be one of ATTR_BY_KERNEL, ATTR_BY_USER or ATTR_NO_SYNC

◆ set_change_event()

void Tango::Attribute::set_change_event	(	bool	implemented,
		bool	detect = `true`
	)

inline

Set a flag to indicate that the server fires change events manually, without the polling to be started for the attribute.

If the detect parameter is set to true, the criteria specified for the change event are verified and the event is only pushed if they are fulfilled. If detect is set to false the event is fired without any value checking!

Parameters

implemented	True when the server fires change events manually.
detect	Triggers the verification of the change event properties when set to true.

◆ set_data_ready_event()

void Tango::Attribute::set_data_ready_event ( bool implemented )

inline

Set a flag to indicate that the server fires data ready events.

Parameters

implemented True when the server fires change events manually.

◆ set_date() [1/3]

void Tango::Attribute::set_date ( struct timeval & t )

inline

Set attribute date.

Parameters

t	The attribute date

References when.

◆ set_date() [2/3]

void Tango::Attribute::set_date ( Tango::TimeVal & new_date )

inline

Set attribute date.

Parameters

new_date The attribute date

References when.

◆ set_date() [3/3]

void Tango::Attribute::set_date ( time_t new_date )

inline

Set attribute date.

Parameters

new_date The attribute date

References when.

◆ set_max_alarm() [1/3]

void Tango::Attribute::set_max_alarm ( char * new_max_alarm )

Set attribute maximum alarm.

This method sets the attribute maximum alarm.

Parameters

new_max_alarm The new attribute maximum alarm value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_max_alarm() [2/3]

void Tango::Attribute::set_max_alarm ( const char * new_max_alarm )

Set attribute maximum alarm.

This method sets the attribute maximum alarm.

Parameters

new_max_alarm The new attribute maximum alarm value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_max_alarm() [3/3]

template<typename T >

void Tango::Attribute::set_max_alarm ( const T & new_max_alarm )

Set attribute maximum alarm.

This method sets the attribute maximum alarm.

Parameters

new_max_alarm The new attribute maximum alarm value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_max_warning() [1/3]

void Tango::Attribute::set_max_warning ( char * new_max_warning )

Set attribute maximum warning.

This method sets the attribute maximum warning.

Parameters

new_max_warning The new attribute maximum warning value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_max_warning() [2/3]

void Tango::Attribute::set_max_warning ( const char * new_max_warning )

Set attribute maximum warning.

This method sets the attribute maximum warning.

Parameters

new_max_warning The new attribute maximum warning value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_max_warning() [3/3]

template<typename T >

void Tango::Attribute::set_max_warning ( const T & new_max_warning )

Set attribute maximum warning.

This method sets the attribute maximum warning.

Parameters

new_max_warning The new attribute maximum warning value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_min_alarm() [1/3]

void Tango::Attribute::set_min_alarm ( char * new_min_alarm )

Set attribute minimum alarm.

This method sets the attribute minimum alarm.

Parameters

new_min_alarm The new attribute minimum alarm value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_min_alarm() [2/3]

void Tango::Attribute::set_min_alarm ( const char * new_min_alarm )

Set attribute minimum alarm.

This method sets the attribute minimum alarm.

Parameters

new_min_alarm The new attribute minimum alarm value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_min_alarm() [3/3]

template<typename T >

void Tango::Attribute::set_min_alarm ( const T & new_min_alarm )

Set attribute minimum alarm.

This method sets the attribute minimum alarm.

Parameters

new_min_alarm The new attribute minimum alarm value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_min_warning() [1/3]

void Tango::Attribute::set_min_warning ( char * new_min_warning )

Set attribute minimum warning.

This method sets the attribute minimum warning.

Parameters

new_min_warning The new attribute minimum warning value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_min_warning() [2/3]

void Tango::Attribute::set_min_warning ( const char * new_min_warning )

Set attribute minimum warning.

This method sets the attribute minimum warning.

Parameters

new_min_warning The new attribute minimum warning value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_min_warning() [3/3]

template<typename T >

void Tango::Attribute::set_min_warning ( const T & new_min_warning )

Set attribute minimum warning.

This method sets the attribute minimum warning.

Parameters

new_min_warning The new attribute minimum warning value

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_properties()

template<typename T >

void Tango::Attribute::set_properties ( Tango::MultiAttrProp< T > & props )

Set all modifiable attribute properties in one call.

This method sets the modifiable attribute properties with the values provided as members of MultiAttrProps object

Parameters

props A MultiAttrProp object.

◆ set_quality()

void Tango::Attribute::set_quality	(	Tango::AttrQuality	qua,
		bool	send_event = `false`
	)

Set attribute data quality.

Parameters

qua	The new attribute data quality
send_event	Boolean set to true if a change event should be sent

◆ set_user_attr_mutex()

void Tango::Attribute::set_user_attr_mutex ( omni_mutex * mut_ptr )

inline

Set attribute user mutex.

This method allows the user to give to the attribute object the pointer to the omni_mutex used to protect its buffer. The mutex has to be locked when passed to this method. The Tango kernel will unlock it when the data will be transferred to the client.

Parameters

mut_ptr The user mutex pointer

◆ set_value() [1/15]

void Tango::Attribute::set_value	(	Tango::DevBoolean *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevBoolean attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [2/15]

void Tango::Attribute::set_value	(	Tango::DevDouble *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevDouble attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [3/15]

void Tango::Attribute::set_value	(	Tango::DevEncoded *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevEncoded attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [4/15]

void Tango::Attribute::set_value	(	Tango::DevFloat *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevFloat attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [5/15]

void Tango::Attribute::set_value	(	Tango::DevLong *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevLong attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [6/15]

void Tango::Attribute::set_value	(	Tango::DevLong64 *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevLong64 attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [7/15]

void Tango::Attribute::set_value	(	Tango::DevShort *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevShort attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [8/15]

void Tango::Attribute::set_value	(	Tango::DevState *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevState attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [9/15]

void Tango::Attribute::set_value	(	Tango::DevString *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevString attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [10/15]

void Tango::Attribute::set_value	(	Tango::DevString *	p_data_str,
		Tango::DevUChar *	p_data,
		long	size,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevEncoded attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data_str	The attribute string part read value
p_data	The attribute raw data part read value
size	Size of the attribute raw data part
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [11/15]

void Tango::Attribute::set_value	(	Tango::DevUChar *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevUChar attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [12/15]

void Tango::Attribute::set_value	(	Tango::DevULong *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevULong attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [13/15]

void Tango::Attribute::set_value	(	Tango::DevULong64 *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevULong64 attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [14/15]

void Tango::Attribute::set_value	(	Tango::DevUShort *	p_data,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value (for Tango::DevUShort attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

p_data	The attribute read value
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value() [15/15]

void Tango::Attribute::set_value ( Tango::EncodedAttribute * attr )

Set internal attribute value (for Tango::DevEncoded attribute data type).

This method stores the attribute read value inside the object. This data will be returned to the caller. This method also stores the date when it is called and initialise the attribute quality factor.

Parameters

attr	Handle to EncodedAttribute object

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [1/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevBoolean *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevBoolean attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [2/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevBoolean *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevBoolean attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [3/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevDouble *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevDouble attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [4/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevDouble *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevDouble attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [5/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevEncoded *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevEncoded attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [6/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevEncoded *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevEncoded attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [7/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevFloat *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevFloat attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [8/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevFloat *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevFloat attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [9/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevLong *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevLong attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [10/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevLong *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevLong attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [11/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevLong64 *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevLong64 attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [12/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevLong64 *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevLong64 attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [13/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevShort *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevShort attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [14/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevShort *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevShort attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [15/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevState *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevState attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [16/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevState *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevState attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [17/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevString *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevString attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [18/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevString *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevString attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [19/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevString *	p_data_str,
		Tango::DevUChar *	p_data,
		long	size,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevEncoded attribute data type when splitted in data format and data themselves).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data_str	The attribute format string
p_data	The attribute raw data
size	Size of the attribute raw data part
t	The date
qual	The attribute quality factor
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [20/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevString *	p_data_str,
		Tango::DevUChar *	p_data,
		long	size,
		time_t	t,
		Tango::AttrQuality	qual,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevEncoded attribute data type when splitted in format and data).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data_str	The attribute coded format string
p_data	The attribute raw data
size	Size of the attribute raw data part
t	The date
qual	The attribute quality factor
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [21/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevUChar *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevUChar attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [22/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevUChar *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevUChar attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [23/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevULong *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevULong attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [24/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevULong *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevULong attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [25/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevULong64 *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevULong64 attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [26/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevULong64 *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevULong64 attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [27/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevUShort *	p_data,
		struct timeval &	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevUShort attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Please note that for Win32 user, the same method is defined using a "_timeb" structure instead of a "timeval" structure to set date.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

◆ set_value_date_quality() [28/28]

void Tango::Attribute::set_value_date_quality	(	Tango::DevUShort *	p_data,
		time_t	t,
		Tango::AttrQuality	qual,
		long	x = `1`,
		long	y = `0`,
		bool	release = `false`
	)

Set internal attribute value, date and quality factor (for Tango::DevUShort attribute data type).

This method stores the attribute read value, the date and the attribute quality factor inside the object. This data will be returned to the caller.

Parameters

p_data	The attribute read value
t	The date
qual	The attribute quality factor
x	The attribute x length. Default value is 1
y	The attribute y length. Default value is 0
release	The release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.

Exceptions

DevFailed If the attribute data type is not coherent. Click here to read DevFailed exception specification

Member Data Documentation

◆ data_format

Tango::AttrDataFormat Tango::Attribute::data_format

protected

The attribute data format.

Three data formats are supported. They are SCALAR, SPECTRUM and IMAGE

Referenced by get_data_format().

◆ data_type

long Tango::Attribute::data_type

protected

The attribute data type.

Forteen types are suported. They are Tango::DevShort, Tango::DevUShort, Tango::DevLong, Tango::DevULong, Tango::DevLong64, Tango::DevULong64, Tango::DevDouble, Tango::DevString, , Tango::DevUChar, Tango::DevFloat, Tango::DevBoolean, Tango::DevState, Tango::DevEncoded and Tango::DevEnum

Referenced by get_data_type().

◆ delta_val

Tango::Attr_CheckVal Tango::Attribute::delta_val

protected

Authorized delta between the last written value and the actual read.

Used if the attribute has an alarm on Read Different Than Set (RDS)

◆ format

string Tango::Attribute::format

protected

The attribute format.

This string specifies how an attribute value must be printed

◆ max_x

long Tango::Attribute::max_x

protected

The attribute maximum x dimension.

It is needed for SPECTRUM or IMAGE data format

Referenced by get_max_dim_x().

◆ max_y

long Tango::Attribute::max_y

protected

The attribute maximum y dimension.

It is necessary only for IMAGE data format

Referenced by get_max_dim_y().

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

attribute.h

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Attribute()

Member Function Documentation

◆ check_alarm()

◆ fire_archive_event()

◆ fire_change_event()

◆ fire_event()

◆ get_assoc_ind()

◆ get_assoc_name()

◆ get_attr_serial_model()

◆ get_data_format()

◆ get_data_size()

◆ get_data_type()

◆ get_date()

◆ get_label()

◆ get_max_alarm()

◆ get_max_dim_x()

◆ get_max_dim_y()

◆ get_max_warning()

◆ get_min_alarm()

◆ get_min_warning()

◆ get_name()

◆ get_polling_period()

◆ get_properties()

◆ get_quality()

◆ get_writable()

◆ get_x()

◆ get_y()

◆ is_alarmed()

◆ is_archive_event()

◆ is_change_event()

◆ is_check_archive_criteria()

◆ is_check_change_criteria()

◆ is_data_ready_event()

◆ is_max_alarm()

◆ is_max_warning()

◆ is_min_alarm()

◆ is_min_warning()

◆ is_polled()

◆ is_rds_alarm()

◆ is_writ_associated()

◆ remove_configuration()

◆ set_archive_event()

◆ set_assoc_ind()

◆ set_attr_serial_model()

◆ set_change_event()

◆ set_data_ready_event()

◆ set_date() [1/3]

◆ set_date() [2/3]

◆ set_date() [3/3]

◆ set_max_alarm() [1/3]

◆ set_max_alarm() [2/3]

◆ set_max_alarm() [3/3]

◆ set_max_warning() [1/3]

◆ set_max_warning() [2/3]

◆ set_max_warning() [3/3]

◆ set_min_alarm() [1/3]

◆ set_min_alarm() [2/3]

◆ set_min_alarm() [3/3]

◆ set_min_warning() [1/3]

◆ set_min_warning() [2/3]

◆ set_min_warning() [3/3]

◆ set_properties()

◆ set_quality()

◆ set_user_attr_mutex()

◆ set_value() [1/15]

◆ set_value() [2/15]

◆ set_value() [3/15]

◆ set_value() [4/15]

◆ set_value() [5/15]

◆ set_value() [6/15]

◆ set_value() [7/15]

◆ set_value() [8/15]

◆ set_value() [9/15]

◆ set_value() [10/15]

◆ set_value() [11/15]

◆ set_value() [12/15]