Description

FNet AIN operation.

#include <CFNetCtrl.h>

Inherits isys::COptionFNetOp.

Public Member Functions
void	set_sampling_interval (const double dSeconds)

SPOptionFNetAINChannelOp	opt_channel (const uint8_t nChannel)

	COptionController (isys::ConnectionMgrSPtr connectionMgr, const std::string &rstrBaseURL)
	Instantiates object. More...

std::string	URL ()
	Returns full option URL of this instance. More...

SPOptionController	opt (const std::string &rstrOption)
	Returns COptionController based on rstrOption (appended to the base URL). More...

std::string	get (const std::string &rstrOption)
	Returns string value of rstrOption. More...

void	set (const std::string &rstrOption, const std::string &rstrValue)
	Sets rstrValue to rstrOption (appended to the base URL). More...

void	set_multi (const iconnect::StrStrMap &inParams)
	Sets multiple option values with one call. More...

void	set_bool (const std::string &rstrOption, bool bValue)
	Sets bValue to rstrOption. More...

bool	get_bool (const std::string &rstrOption)
	Gets bool value of rstrOption. More...

void	set_int (const std::string &rstrOption, int64_t iValue)
	Sets iValue to rstrOption. More...

int64_t	get_int (const std::string &rstrOption)
	Gets integer value of rstrOption. More...

void	set_uint (const std::string &rstrOption, uint64_t nValue)
	Sets nValue to rstrOption. More...

uint64_t	get_uint (const std::string &rstrOption)
	Gets unsigned integer value of rstrOption. More...

size_t	size ()
	Returns array size of this instance. More...

SPOptionController	at (size_t nIndex)
	Return COptionController for element at nIndex. More...

SPOptionController	add ()
	Adds an element to the array and returns COptionController for it. More...

void	clear ()
	Removes all elements. More...

void	remove (size_t nIndex)
	Removes element at nIndex. More...

int	index_of (const std::string &rstrOption, const std::string &rstrValue)
	Returns index of element whose element rstrOption has value rstrValue, or -1 if element is not found. More...

SPOptionController	find (const std::string &rstrOption, const std::string &rstrValue)
	Returns COptionController for the element whose rstrOption has value rstrValue. More...

Protected Member Functions
std::string	get_option_URL (std::string strBase, std::string_view strvOption) const
	Possible parameters if we want the return string to be for example "/IDE/Info.VerMajor". More...

std::string	get_option_URL (std::string_view strvOption) const
	See `COptionController::get_option_URL(std::string, std::string_view) const` examples for getting the right URL.

Static Protected Member Functions
static std::string	format_index (size_t nIndex)
	returns "[<index dec>]"

Member Function Documentation

◆ add()

SPOptionController isys::COptionController::add ( )

inherited

Adds an element to the array and returns COptionController for it.

Returns: COptionController instance

Exceptions

TException if this is not an array, or the array size is static

Python example: test_add_remove.py

◆ at()

SPOptionController isys::COptionController::at ( size_t nIndex )

inherited

Return COptionController for element at nIndex.

Parameters

nIndex element index

Returns: COptionController for element at index

Python example: test_at.py

◆ clear()

void isys::COptionController::clear ( )

inherited

Removes all elements.

Exceptions

TException if this is not an array, the array size is static

Python example: test_add_remove.py

◆ COptionController()

isys::COptionController::COptionController	(	isys::ConnectionMgrSPtr	connectionMgr,
		const std::string &	rstrBaseURL
	)

inherited

Instantiates object.

Parameters

connectionMgr	class which maintains connection to winIDEA. Connection must be established before this call.
rstrBaseURL	configuration node URL, for example /IDE/Debug.DownloadFiles In winIDEA see Help->Display Option...

◆ find()

SPOptionController isys::COptionController::find	(	const std::string &	rstrOption,
		const std::string &	rstrValue
	)

inherited

Returns COptionController for the element whose rstrOption has value rstrValue.

Parameters

rstrOption	option string which is appended to the base URL
rstrValue	option value

Returns: COptionController for the element found

Exceptions

TException if this is not an array, rstrOption is not a valid option, or the element is not found

Python example: test_find.py

◆ get()

std::string isys::COptionController::get ( const std::string & rstrOption )

inherited

Returns string value of rstrOption.

Parameters

rstrOption option string which is appended to the base URL

Returns: string value

Exceptions

TException if rstrOption is invalid

Python example: test_get_set.py

◆ get_bool()

bool isys::COptionController::get_bool ( const std::string & rstrOption )

inherited

Gets bool value of rstrOption.

Parameters

rstrOption option string which is appended to the base URL

Returns: bool value

Exceptions

TException if rstrOption is invalid, or type is not bool

Python example: test_get_set_bool.py

◆ get_int()

int64_t isys::COptionController::get_int ( const std::string & rstrOption )

inherited

Gets integer value of rstrOption.

Parameters

rstrOption option string which is appended to the base URL

Returns: int64_t value

Exceptions

TException if rstrOption is invalid, or type is not integer

Python example: test_get_set_int_uint.py

◆ get_option_URL()

std::string isys::COptionController::get_option_URL	(	std::string	strBase,
		std::string_view	strvOption
	)		const

protectedinherited

Possible parameters if we want the return string to be for example "/IDE/Info.VerMajor".

("" , "IDE/Info.VerMajor")
("/IDE/" , "Info.VerMajor")
("/IDE/Info", "VerMajor")

◆ get_uint()

uint64_t isys::COptionController::get_uint ( const std::string & rstrOption )

inherited

Gets unsigned integer value of rstrOption.

Parameters

rstrOption option string which is appended to the base URL

Returns: uint64_t value

Exceptions

TException if rstrOption is invalid, or type is not a positive integer

Python example: test_get_set_int_uint.py

◆ index_of()

int isys::COptionController::index_of	(	const std::string &	rstrOption,
		const std::string &	rstrValue
	)

inherited

Returns index of element whose element rstrOption has value rstrValue, or -1 if element is not found.

Parameters

rstrOption	option string which is appended to the base URL
rstrValue	option value

Returns: index if element exists, -1 otherwise

Exceptions

TException if this is not an array, or rstrOption is not an element name

Python example: test_index_of.py

◆ opt()

SPOptionController isys::COptionController::opt ( const std::string & rstrOption )

inherited

Returns COptionController based on rstrOption (appended to the base URL).

Parameters

rstrOption option string which is appended to the base URL

Returns: COptionController instance

Python example: test_opt.py

◆ opt_channel()

SPOptionFNetAINChannelOp isys::COptionFNetAINOp::opt_channel ( const uint8_t nChannel )

Parameters

nChannel channel index

Returns: COptionFNetAINChannelOp option controller through which the channel components are accessed

◆ remove()

void isys::COptionController::remove ( size_t nIndex )

inherited

Removes element at nIndex.

Parameters

nIndex element index

Exceptions

TException if this is not an array, the array size is static, or nIndex is out of array range

Python example: test_add_remove.py

◆ set()

void isys::COptionController::set	(	const std::string &	rstrOption,
		const std::string &	rstrValue
	)

inherited

Sets rstrValue to rstrOption (appended to the base URL).

Parameters

rstrOption	option string which is appended to the base URL
rstrValue	string value

Exceptions

TException if rstrOption is invalid

Python example: test_get_set.py

◆ set_bool()

void isys::COptionController::set_bool	(	const std::string &	rstrOption,
		bool	bValue
	)

inherited

Sets bValue to rstrOption.

Parameters

rstrOption	option string which is appended to the base URL
bValue	bool value

Exceptions

TException if rstrOption is invalid

Python example: test_get_set_bool.py

◆ set_int()

void isys::COptionController::set_int	(	const std::string &	rstrOption,
		int64_t	iValue
	)

inherited

Sets iValue to rstrOption.

Parameters

rstrOption	option string which is appended to the base URL
iValue	int64_t value

Exceptions

TException if rstrOption is invalid

Python example: test_get_set_int_uint.py

◆ set_multi()

void isys::COptionController::set_multi ( const iconnect::StrStrMap & inParams )

inherited

Sets multiple option values with one call.

Parameters

inParams map of string option value pairs

Note: Python and Java support Python mapping and Java Map as input type in addition to isystem.connect.StrStrMap. Examples:

Python: optCtrlApp0.set_multi({"Name": "MyApp", "SymbolFiles.DefaultFile": "0"});

Java:   optCtrlApp0.set_multi(Map.of("Name", "MyApp", "SymbolFiles.DefaultFile", "0"));

Python example: test_set_multi.py

◆ set_sampling_interval()

void isys::COptionFNetAINOp::set_sampling_interval ( const double dSeconds )

Parameters

dSeconds time interval to sample the AIN channel

◆ set_uint()

void isys::COptionController::set_uint	(	const std::string &	rstrOption,
		uint64_t	nValue
	)

inherited

Sets nValue to rstrOption.

Parameters

rstrOption	option string which is appended to the base URL
nValue	uint64_t value

Exceptions

TException if rstrOption is invalid

Python example: test_get_set_int_uint.py

◆ size()

size_t isys::COptionController::size ( )

inherited

Returns array size of this instance.

Returns: size of array

Exceptions

TException if this is not an array

Python example: test_size.py

◆ URL()

std::string isys::COptionController::URL ( )

inherited

Returns full option URL of this instance.

Returns: full option URL

Python example: test_url.py

Description

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Member Function Documentation

◆ add()

◆ at()

◆ clear()

◆ COptionController()

◆ find()

◆ get()

◆ get_bool()

◆ get_int()

◆ get_option_URL()

◆ get_uint()

◆ index_of()

◆ opt()

◆ opt_channel()

◆ remove()

◆ set()

◆ set_bool()

◆ set_int()

◆ set_multi()

◆ set_sampling_interval()

◆ set_uint()

◆ size()

◆ URL()