Tango Core Classes Reference  9.3.4
Tango::Attribute Class Reference

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...
 

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_listThe attribute properties list. Each property is an object of the AttrProperty class
tmp_attrTemporary attribute object built from user parameters
dev_nameThe device name
idxThe 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
DevFailedIf 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 attribute 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
exceptA 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 attribute 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
exceptA 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 attribute 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_namesThe filterable fields name
filt_valsThe filterable fields value (as double)
exceptA 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_alReference 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_warReference 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_alReference 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_warReference 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
propsA 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
DevFailedIn 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
implementedTrue when the server fires archive events manually.
detectTriggers 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
valThe 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_modelThe 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
implementedTrue when the server fires change events manually.
detectTriggers 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
implementedTrue when the server fires change events manually.

◆ set_date() [1/3]

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

Set attribute date.

Parameters
tThe attribute date

References when.

◆ set_date() [2/3]

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

Set attribute date.

Parameters
new_dateThe attribute date

References when.

◆ set_date() [3/3]

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

Set attribute date.

Parameters
new_dateThe 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_alarmThe new attribute maximum alarm value
Exceptions
DevFailedIf 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_alarmThe new attribute maximum alarm value
Exceptions
DevFailedIf 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_alarmThe new attribute maximum alarm value
Exceptions
DevFailedIf 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_warningThe new attribute maximum warning value
Exceptions
DevFailedIf 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_warningThe new attribute maximum warning value
Exceptions
DevFailedIf 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_warningThe new attribute maximum warning value
Exceptions
DevFailedIf 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_alarmThe new attribute minimum alarm value
Exceptions
DevFailedIf 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_alarmThe new attribute minimum alarm value
Exceptions
DevFailedIf 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_alarmThe new attribute minimum alarm value
Exceptions
DevFailedIf 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_warningThe new attribute minimum warning value
Exceptions
DevFailedIf 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_warningThe new attribute minimum warning value
Exceptions
DevFailedIf 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_warningThe new attribute minimum warning value
Exceptions
DevFailedIf 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
propsA MultiAttrProp object.

◆ set_quality()

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

Set attribute data quality.

Parameters
quaThe new attribute data quality
send_eventBoolean 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_ptrThe 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_strThe attribute string part read value
p_dataThe attribute raw data part read value
sizeSize of the attribute raw data part
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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
attrHandle to EncodedAttribute object
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_strThe attribute format string
p_dataThe attribute raw data
sizeSize of the attribute raw data part
tThe date
qualThe attribute quality factor
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_strThe attribute coded format string
p_dataThe attribute raw data
sizeSize of the attribute raw data part
tThe date
qualThe attribute quality factor
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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_dataThe attribute read value
tThe date
qualThe attribute quality factor
xThe attribute x length. Default value is 1
yThe attribute y length. Default value is 0
releaseThe release flag. If true, memory pointed to by p_data will be freed after being send to the client. Default value is false.
Exceptions
DevFailedIf 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: