Function rcl_lifecycle_state_machine_fini

Function Documentation

rcl_ret_t rcl_lifecycle_state_machine_fini(rcl_lifecycle_state_machine_t *state_machine, rcl_node_t *node_handle)

Finalize a rcl_lifecycle_state_machine_t.

Calling this will set the rcl_lifecycle_state_machine_t struct into the an unitialized state that is functionally the same as before rcl_lifecycle_state_machine_init was called. This function make the rcl_lifecycle_state_machine_t invalid.

Attribute

Adherence

Allocates Memory

Yes

Thread-Safe

No

Uses Atomics

No

Lock-Free

Yes

Parameters:
  • state_machine[inout] struct to be finalized

  • node_handle[in] valid (not finalized) handle to the node

Returns:

RCL_RET_OK if the state was finalized successfully, or

Returns:

RCL_RET_INVALID_ARGUMENT if any arguments are invalid, or

Returns:

RCL_RET_ERROR if an unspecified error occurs.