Struct IntegerParameter

pub struct IntegerParameter {
    pub(crate) name: CapeStringImpl,
    description: CapeStringImpl,
    is_input: bool,
    shared_unit_data: Rc<RefCell<SharedUnitData>>,
    pub(crate) value: i32,
    default_value: i32,
    minimum_value: i32,
    maximum_value: i32,
    cobia_object_data: IntegerParameterCobiaObjectData,
}

The IntegerParameter class implements a CAPE-OPEN 1.2 integer parameter.

Parameters must implement the ICapeIdentification and ICapeParameter interfaces. In addition, integer parameters must implement the ICapeIntegerParameter interface.

This implementation can be used for both input and output parameters. Input parameters can be set by the user, while output parameters are set by the unit operation.

Although CAPE-OPEN defines a value for an integer that is not specified (the equivalent of NaN for real values), this value is not widely supported, and unspecified values are not allowed in this implementation.

Any invalid values (outside the bounds of the parameter) will raise an error when set. Therefore, any parameter is valid.

Fields

name: CapeStringImpl

The name of the parameter

description: CapeStringImpl

The description of the parameter

is_input: bool

Indicates whether this parameter is an input (true) or an output (false)

shared_unit_data: Rc<RefCell<SharedUnitData>>

Shared data for the unit, containing unit-specific information

value: i32

The current value of the parameter

default_value: i32

Default value of the parameter

minimum_value: i32

Minimum value of the parameter

maximum_value: i32

Maximum value of the parameter

cobia_object_data: IntegerParameterCobiaObjectData

Cobia object data for this object, which contains generated code to provide the native COBIA interfaces

Implementations

impl IntegerParameter

fn create_instance( _integer_parameter_boxed_ptr: *mut *mut ICapeInterface, name: CapeStringImpl, description: CapeStringImpl, is_input: bool, shared_unit_data: Rc<RefCell<SharedUnitData>>, default_value: i32, minimum_value: i32, maximum_value: i32, ) -> CapeResult

pub(crate) fn create<T: CapeSmartPointer>( name: CapeStringImpl, description: CapeStringImpl, is_input: bool, shared_unit_data: Rc<RefCell<SharedUnitData>>, default_value: i32, minimum_value: i32, maximum_value: i32, ) -> T

Create a new instance of the object and return a smart pointer to it

This function panics if the created object does not implement the interface corresponding to the smart pointer to be returned. For a non-panic version, use the try_create() function.

pub(crate) fn try_create<T: CapeSmartPointer>( name: CapeStringImpl, description: CapeStringImpl, is_input: bool, shared_unit_data: Rc<RefCell<SharedUnitData>>, default_value: i32, minimum_value: i32, maximum_value: i32, ) -> Result<T, COBIAError>

Create a new instance of the object and return a smart pointer to it

This function returns an error if the created object does not implement the interface corresponding to the smart pointer to be returned.

pub(crate) unsafe fn borrow<T: CapeSmartPointer>(smart_pointer: &T) -> &Self

Get a reference to the object

Note that as the reference is created from a smart pointer, the reference is valid only as long as the smart pointer is valid. The reference is not checked for multiple borrows

Safety

The user must ensure that the smart pointer contains a valid object, and that the object is of the type that is being borrowed. It is not possible for the compiler to check this, as the borrow is done through the native object pointer in the interface.

pub(crate) unsafe fn borrow_mut<T: CapeSmartPointer>( smart_pointer: &mut T, ) -> &mut Self

Get a mutable reference to the object

Note that as the reference is created from a smart pointer, the reference is valid only as long as the smart pointer is valid. The reference is not checked for multiple borrows

Safety

This function is unsafe because it allows mutable access to the object. Also the user must ensure that the smart pointer contains a valid object, and that the object is of the type that is being borrowed. It is not possible for the compiler to check this, as the borrow is done through the native object pointer in the interface.

impl IntegerParameter

fn new( name: CapeStringImpl, description: CapeStringImpl, is_input: bool, shared_unit_data: Rc<RefCell<SharedUnitData>>, default_value: i32, minimum_value: i32, maximum_value: i32, ) -> Self

Trait Implementations

impl Display for IntegerParameter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Format the IntegerParameter as a string for display purposes.

The std::fmt::Display interface is used when generating the source name of the object that raises an error.

Arguments:

• f - A mutable reference to a std::fmt::Formatter where the formatted string will be written.

Returns:

• A std::fmt::Result indicating the success or failure of the formatting operation.

impl ICapeIdentification for IntegerParameter

fn get_component_name( &mut self, name: &mut CapeStringOut<'_>, ) -> Result<(), COBIAError>

Get the name of the component.

Arguments:

• name - A mutable reference to a CapeStringOut where the name will be set.

Returns:

• A Result indicating success or failure. If successful, the name is set in name.

fn get_component_description( &mut self, description: &mut CapeStringOut<'_>, ) -> Result<(), COBIAError>

Get the description of the component.

Arguments:

• description - A mutable reference to a CapeStringOut where the description will be set.

Returns:

• A Result indicating success or failure. If successful, the description is set in description.

fn set_component_name( &mut self, _name: &CapeStringIn<'_>, ) -> Result<(), COBIAError>

Set the name of the component.

This method is not allowed for this parameter implementation and will return an error.

fn set_component_description( &mut self, _desc: &CapeStringIn<'_>, ) -> Result<(), COBIAError>

Set the description of the component.

This method is not allowed for this parameter implementation and will return an error.

impl ICapeIdentificationImpl for IntegerParameter

type T = IntegerParameter

fn as_interface_pointer(&mut self) -> *mut ICapeInterface

fn init_interface() -> _ICapeInterface

prepare CAPEOPEN_1_2_ICapeIdentification interface and return as generic ICapeInterface pointer

fn init<Timpl>(u: &mut Timpl)

where Timpl: ICapeIdentificationImpl + ICapeInterfaceImpl,

extern "C" fn raw_get_component_name( me: *mut c_void, name: *mut _ICapeString, ) -> u32

extern "C" fn raw_set_component_name( me: *mut c_void, name: *mut _ICapeString, ) -> u32

extern "C" fn raw_get_component_description( me: *mut c_void, desc: *mut _ICapeString, ) -> u32

extern "C" fn raw_set_component_description( me: *mut c_void, desc: *mut _ICapeString, ) -> u32

const VTABLE: CAPEOPEN_1_2_ICapeIdentification_VTable = _

impl ICapeIntegerParameter for IntegerParameter

fn get_value(&mut self) -> Result<CapeInteger, COBIAError>

Get the value of the parameter.

This method retrieves the current value of the parameter.

Returns:

• A Result containing the current value of the parameter as CapeInteger.

fn set_value(&mut self, value: CapeInteger) -> Result<(), COBIAError>

Set the value of the parameter.

This implementation accepts a blank value for the parameters, but it does not allow an invalid value to be set.

Only input parameters can be set.

If the value is set, it marks the unit as dirty and not validated.

Arguments:

• value - The value to set for the parameter, which should be a CapeInteger.

Returns:

• A Result indicating success or failure.

fn get_default_value(&mut self) -> Result<CapeInteger, COBIAError>

Get the default value of the parameter.

This method retrieves the default value of the parameter.

Returns:

• A Result containing the default value of the parameter as CapeInteger, or an error.

fn get_lower_bound(&mut self) -> Result<CapeInteger, COBIAError>

Get the lower bound of the parameter.

This method retrieves the lower bound of the parameter.

Returns:

• A Result containing the lower bound of the parameter as CapeInteger, or an error.

fn get_upper_bound(&mut self) -> Result<CapeInteger, COBIAError>

Get the upper bound of the parameter.

This method retrieves the upper bound of the parameter.

Returns:

• A Result containing the upper bound of the parameter as CapeInteger, or an error.

fn validate( &mut self, value: CapeInteger, message: &mut CapeStringOut<'_>, ) -> Result<CapeBoolean, COBIAError>

Validate whether a given value is valid for this parameter.

This method checks if the provided value is within the bounds of the parameter and meets the dimensionality requirements.

Output parameters are not validated, as they are set by the unit operation and not by the user.

Arguments:

• value - The value to validate, which should be a CapeInteger.
• message - A mutable reference to a CapeStringOut where any validation error messages will be set.

Returns:

• A Result containing a CapeBoolean indicating whether the value is valid or not. If the value is not valid, it sets an error message in message.

impl ICapeIntegerParameterImpl for IntegerParameter

type T = IntegerParameter

fn as_interface_pointer(&mut self) -> *mut ICapeInterface

fn init_interface() -> _ICapeInterface

prepare CAPEOPEN_1_2_ICapeIntegerParameter interface and return as generic ICapeInterface pointer

fn init<Timpl>(u: &mut Timpl)

where Timpl: ICapeIntegerParameterImpl + ICapeInterfaceImpl,

extern "C" fn raw_get_value(me: *mut c_void, value: *mut i32) -> u32

extern "C" fn raw_set_value(me: *mut c_void, value: i32) -> u32

extern "C" fn raw_get_default_value( me: *mut c_void, default_value: *mut i32, ) -> u32

extern "C" fn raw_get_lower_bound( me: *mut c_void, l_bound: *mut i32, ) -> u32

extern "C" fn raw_get_upper_bound( me: *mut c_void, u_bound: *mut i32, ) -> u32

extern "C" fn raw_validate( me: *mut c_void, value: i32, message: *mut _ICapeString, is_ok: *mut u32, ) -> u32

const VTABLE: CAPEOPEN_1_2_ICapeIntegerParameter_VTable = _

impl ICapeInterfaceImpl for IntegerParameter

type T = IntegerParameter

fn get_object_data(&mut self) -> &mut CapeObjectData

Returns a mutable reference to the internal CapeObjectData structure.

fn get_self(&mut self) -> *mut IntegerParameter

Returns a pointer to the implementing object.

const CAPEINTERFACE_VTABLE: ICapeInterface_VTable = _

the V-table for the ICapeInterface implementation.

fn init(&mut self) -> *mut _ICapeInterface

Initializes the object, setting up the interface pointer and adding it to the interface map.

fn create_object_data<Timpl>() -> CapeObjectData

where Timpl: ICapeInterfaceImpl,

Utility function for internal object setup

extern "C" fn raw_add_reference(me: *mut c_void)

extern "C" fn raw_release(me: *mut c_void)

extern "C" fn raw_query_interface( me: *mut c_void, uuid: *const _CapeUUID, interface: *mut *mut _ICapeInterface, ) -> u32

extern "C" fn raw_get_last_error( me: *mut c_void, error: *mut *mut _ICapeError, ) -> u32

fn add_interface( &mut self, uuid: *const _CapeUUID, interface: *mut _ICapeInterface, )

Utility function to add an interface to the interface map.

fn set_last_error(&mut self, error: COBIAError, scope: &str) -> u32

Utility function to set the last error and scope.

fn clear_last_error(&mut self)

Utility function to clear the last error and scope.

fn as_icapeinterface(&mut self) -> *mut _ICapeInterface

Returns a unique pointer to the ICapeInterface implementation of the object.

impl ICapeParameter for IntegerParameter

fn get_val_status(&mut self) -> Result<CapeValidationStatus, COBIAError>

Get the validation status of the parameter.

As this parameter does not accept any values that are not valid, the parameter is always valid.

Returns:

• A Result containing the validation status, which is always CapeValid for this implementation.

fn get_mode(&mut self) -> Result<CapeParamMode, COBIAError>

Get the mode of the parameter.

Returns:

• A Result containing the mode of the parameter, which is either CapeInput or CapeOutput based on the is_input field.

fn get_type(&mut self) -> Result<CapeParamType, COBIAError>

Get the type of the parameter.

Returns:

• A Result containing the type of the parameter, which is always CapeParameterInteger for this implementation.

fn validate( &mut self, _message: &mut CapeStringOut<'_>, ) -> Result<CapeBoolean, COBIAError>

Validate the parameter.

As this parameter does not accept any values that are not valid, the parameter is always valid.

Arguments:

• message - A mutable reference to a CapeStringOut where any validation error messages will be set.

Returns:

• A Result containing a CapeBoolean indicating whether the parameter is valid or not.

fn reset(&mut self) -> Result<(), COBIAError>

Reset the parameter to its default value.

This method sets the value of the parameter back to its default value and marks the unit as dirty. It also resets the validation status to CapeNotValidated.

Returns:

• A Result indicating success or failure. If successful, the value is reset to the default value.

impl ICapeParameterImpl for IntegerParameter

type T = IntegerParameter

fn as_interface_pointer(&mut self) -> *mut ICapeInterface

fn init_interface() -> _ICapeInterface

prepare CAPEOPEN_1_2_ICapeParameter interface and return as generic ICapeInterface pointer

fn init<Timpl>(u: &mut Timpl)

where Timpl: ICapeParameterImpl + ICapeInterfaceImpl,

extern "C" fn raw_get_val_status( me: *mut c_void, val_status: *mut i32, ) -> u32

extern "C" fn raw_get_mode(me: *mut c_void, mode: *mut i32) -> u32

extern "C" fn raw_get_type( me: *mut c_void, parameter_type: *mut i32, ) -> u32

extern "C" fn raw_validate( me: *mut c_void, message: *mut _ICapeString, is_ok: *mut u32, ) -> u32

extern "C" fn raw_reset(me: *mut c_void) -> u32

const VTABLE: CAPEOPEN_1_2_ICapeParameter_VTable = _