Function rmw_create_node

Function Documentation

rmw_node_t *rmw_create_node(rmw_context_t *context, const char *name, const char *namespace_)

Create a node and return a handle to that node.

This function can fail, and therefore return NULL, if:

  • name is not a valid non-null node name

  • namespace_ is not a valid non-null namespace

  • context is not valid i.e. it is zero-initialized, or its implementation identifier does not match that of this API implementation, or has been invalidated by rmw_shutdown()

  • memory allocation fails during node creation

  • an unspecified error occurs

Attribute

Adherence

Allocates Memory

Yes

Thread-Safe

No

Uses Atomics

No [1]

Lock-Free

No [1]

[1] rmw implementation defined, check the implementation documentation

This should be defined by the rmw implementation.

Parameters:

  • context – [in] init context that this node should be associated with

  • name – [in] the node name

  • namespace_ – [in] the node namespace

Returns:

rmw node handle, or NULL if there was an error