Function rcl_lifecycle_transition_fini

Function Documentation

rcl_ret_t rcl_lifecycle_transition_fini(rcl_lifecycle_transition_t *transition, const rcl_allocator_t *allocator)

Finalize a rcl_lifecycle_transition_t.

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

Attribute

Adherence

Allocates Memory

Yes

Thread-Safe

No

Uses Atomics

No

Lock-Free

Yes

Parameters:
  • transition[inout] struct to be finalized

  • allocator[in] a valid allocator used to finalize the transition

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.