xronos::sdk::Element Class Reference

Base class for all reactor elements. More...

#include <xronos/sdk/element.hh>

Inheritance diagram for xronos::sdk::Element:

Public Member Functions
auto	name () const noexcept -> const std::string &
	Get the element's name.
auto	fqn () const noexcept -> const std::string &
	Get the element's fully qualified name.
auto	uid () const noexcept -> std::uint64_t
	Get the element's unique ID.
auto	add_attribute (std::string_view key, const AttributeValue &value) noexcept -> bool
	Annotate an element with an attribute.
template<std::ranges::input_range R> requires requires(std::ranges::range_value_t<R> pair) { { pair.first } -> std::convertible_to<std::string_view>; { pair.second } -> std::convertible_to<AttributeValue>; }
auto	add_attributes (const R &range) noexcept -> bool
	Annotate an element with multiple attributes.
auto	add_attributes (std::initializer_list< std::pair< std::string_view, AttributeValue > > attributes) -> bool
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
virtual	~Element ()=default
	Virtual destructor.
	Element (Element &&)=default
	Move constructor.
auto	operator= (Element &&) -> Element &=default
	Move assignment operator.

Detailed Description

Base class for all reactor elements.

Reactor elements are objects that can be contained by reactors and that have special meaning to the Xronos SDK.

Member Function Documentation

name()

auto xronos::sdk::Element::name ( ) const -> const std::string &

nodiscardnoexcept

Get the element's name.

Returns

The element's name.

fqn()

auto xronos::sdk::Element::fqn ( ) const -> const std::string &

nodiscardnoexcept

Get the element's fully qualified name.

The fully qualified name (FQN) represents the containment hierarchy. It consists of the containing reactor's FQN plus the element's name separated by a .. For top-level reactors (those owned by the Environment), the FQN is equal to the name.

Returns

The element's fully qualified name.

uid()

auto xronos::sdk::Element::uid ( ) const -> std::uint64_t

nodiscardnoexcept

Get the element's unique ID.

Returns an integer ID that is unique within an environment.

add_attribute()

auto xronos::sdk::Element::add_attribute ( std::string_view key, const AttributeValue & value ) -> bool

noexcept

Annotate an element with an attribute.

Adding the attribute only succeeds, if the given key has not been set before on the same element.

See Attributes for more information.

Parameters

key	The name of the attribute to add.
value	The value of the attribute to add.

Returns

true if the attribute was successfully added.

See also

add_attributes()

add_attributes() [1/2]

template<std::ranges::input_range R>
requires requires(std::ranges::range_value_t<R> pair) { { pair.first } -> std::convertible_to<std::string_view>; { pair.second } -> std::convertible_to<AttributeValue>; }

auto xronos::sdk::Element::add_attributes ( const R & range ) -> bool

noexcept

Annotate an element with multiple attributes.

Adding the attributes only succeeds, if the given key has not been set before on the same element.

See Attributes for more information.

Template Parameters

R	Type of the range.

Parameters

range

Range of key-value-pairs to be added as attributes.

Returns

true if all attributes were successfully added.

See also

add_attribute()

add_attributes() [2/2]

auto xronos::sdk::Element::add_attributes

(

std::initializer_list< std::pair< std::string_view, AttributeValue > >

attributes

)

-> bool

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Accepts an initializer list of key value pairs.

---

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

• sdk/element.hh