NDS3  1.0.0
API reference manual
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
nds::PVDelegateOut< T > Class Template Reference

Detailed Description

template<typename T>
class nds::PVDelegateOut< T >

An output PV that delegates the read and write operations to two external functions.

Calling PVDelegateOut::read() or PVDelegate::write() will result in a call to the delegated functions.

Warning
for all the vector data types and for std::string remember to call setMaxElements() to specify the maximum size of the vector or string.
Template Parameters
Tthe PV data type. The following data types are supported:
  • std::int32_t
  • std::double
  • std::vector<std::int8_t>
  • std::vector<std::uint8_t>
  • std::vector<std::int32_t>
  • std::vector<double>
  • std::string

#include <pvDelegateOut.h>

Inheritance diagram for nds::PVDelegateOut< T >:
nds::PVBaseOut nds::PVBase nds::Base

Public Types

typedef std::function< void(timespec
*, T *)> 
initValue_t
 Definition of the method used to read the initial PV value. More...
 
typedef std::function< void(const
timespec &, const T &)> 
write_t
 Definition of the method used to write.
 

Public Member Functions

 PVDelegateOut (const std::string &name, write_t writeFunction, initValue_t initValueFunction)
 Construct the PVDelegateOut object and specifies the external functions that must be called to write the data and to retrieve the initial value. More...
 
 PVDelegateOut (const std::string &name, write_t writeFunction)
 Construct the PVDelegateOut object and specifies the external function that must be called to write the data. More...
 
- Public Member Functions inherited from nds::PVBaseOut
 PVBaseOut ()
 Construct an empty PVBaseOut. More...
 
template<typename T >
void read (timespec *pTimestamp, T *pValue) const
 Call to read the value of the PV. More...
 
template<typename T >
void write (const timespec &timestamp, const T &value)
 Call to write the value into the PV. More...
 
void subscribeTo (const std::string &inputPVName)
 Subscribe the PV to an input PV which may be located on any other device running in the same NDS process. More...
 
- Public Member Functions inherited from nds::PVBase
void setDescription (const std::string &description)
 Set a human readable description of the PV. More...
 
void setUnits (const std::string &units)
 Set the engineering units of the PV. More...
 
void setInterfaceName (const std::string &interfaceName)
 Set the name of the PV as seen by the control system. More...
 
void setScanType (const scanType_t scanType, const double periodSeconds=1)
 Set how the PV value is retrieved by the control system. More...
 
void setMaxElements (const size_t maxElements)
 If the data type of the PV is a vector then set the maximum number of elements that the vector will contain. More...
 
void setEnumeration (const enumerationStrings_t &enumerations)
 If the data type is an integer then assigns a list of strings that enumerate the values (starting from zero). More...
 
void processAtInit (const bool bProcessAtInit)
 Specifies if the read() function of the PV should be called during the device initialization. More...
 
- Public Member Functions inherited from nds::Base
 Base (const Base &right)
 Copy constructor. The copy will refer to the same implementation object referenced in the copied object. More...
 
Baseoperator= (const Base &right)
 Copy operator. The copy will refer to the same implementation object referenced in the copied object. More...
 
void setExternalName (const std::string &externalName)
 Set the string to pass to the naming rules in order to build the full node name as seen by the control system. More...
 
virtual Port getPort ()
 Get the Node that communicate with the device (ASYN port on EPICS, Device on Tango). Query the parent nodes if necessary. More...
 
const std::string & getComponentName () const
 Return the node's name. More...
 
const std::string & getFullName () const
 Return the full node's name, prepending the parents' names if necessary (e.g. "ROOT-CHANNEL1-THISNODE") More...
 
const std::string & getFullExternalName () const
 Return the full node's name as seen by the control system clients. More...
 
const std::string & getFullNameFromPort () const
 Return the node's name as seen by the parent Port node (the node that communicates with the device). More...
 
timespec getTimestamp () const
 Get the current time. More...
 
void setTimestampDelegate (getTimestampPlugin_t timestampDelegate)
 Specify the delegate function to call to get the timestamp. More...
 
std::ostream & getLogger (const logLevel_t logLevel)
 Retrieve a logging stream for the specified log level. More...
 
bool isLogLevelEnabled (const logLevel_t logLevel) const
 Returns true if the logging for a particular severity level has been enabled. More...
 
void setLogLevel (const logLevel_t logLevel)
 Enable the logging for a particular severity level. More...
 
void defineCommand (const std::string &command, const std::string &usage, const size_t numParameters, const command_t function)
 Define a command specific for the node. More...
 
Thread runInThread (const std::string &name, threadFunction_t function)
 Create and run a thread using the control system facilities. More...
 
Thread runInThread (threadFunction_t function)
 Create and run a thread using the control system facilities. The created thread will have the node's name. More...
 

Additional Inherited Members

- Protected Member Functions inherited from nds::Base
 Base ()
 Initializes an empty base class.
 

Constructor & Destructor Documentation

template<typename T >
nds::PVDelegateOut< T >::PVDelegateOut ( const std::string &  name,
write_t  writeFunction,
initValue_t  initValueFunction 
)

Construct the PVDelegateOut object and specifies the external functions that must be called to write the data and to retrieve the initial value.

The constructor also call processAtInit(true) in order to cause the call to the initValueFunction during the initialization.

Parameters
namename of the PV
writeFunctionfunction to be used to write the value
initValueFunctionfunction to be used for reading the initial value
template<typename T >
nds::PVDelegateOut< T >::PVDelegateOut ( const std::string &  name,
write_t  writeFunction 
)

Construct the PVDelegateOut object and specifies the external function that must be called to write the data.

Parameters
namename of the PV
writeFunctionfunction to be used to write the value

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