rcl  master
C API providing common ROS client library functionality.
graph.h
Go to the documentation of this file.
1 // Copyright 2016-2017 Open Source Robotics Foundation, Inc.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #ifndef RCL__GRAPH_H_
16 #define RCL__GRAPH_H_
17 
18 #ifdef __cplusplus
19 extern "C"
20 {
21 #endif
22 
23 #include <rmw/names_and_types.h>
25 
26 #include "rcutils/types.h"
27 
28 #include "rosidl_generator_c/service_type_support_struct.h"
29 
30 #include "rcl/macros.h"
31 #include "rcl/client.h"
32 #include "rcl/node.h"
33 #include "rcl/visibility_control.h"
34 
36 
37 #define rcl_get_zero_initialized_names_and_types rmw_get_zero_initialized_names_and_types
38 
40 
87  const rcl_node_t * node,
88  rcl_allocator_t * allocator,
89  bool no_demangle,
90  const char * node_name,
91  const char * node_namespace,
92  rcl_names_and_types_t * topic_names_and_types);
93 
95 
135 rcl_ret_t
137  const rcl_node_t * node,
138  rcl_allocator_t * allocator,
139  bool no_demangle,
140  const char * node_name,
141  const char * node_namespace,
142  rcl_names_and_types_t * topic_names_and_types);
143 
145 
184 rcl_ret_t
186  const rcl_node_t * node,
187  rcl_allocator_t * allocator,
188  const char * node_name,
189  const char * node_namespace,
190  rcl_names_and_types_t * service_names_and_types);
191 
193 
232 rcl_ret_t
234  const rcl_node_t * node,
235  rcl_allocator_t * allocator,
236  const char * node_name,
237  const char * node_namespace,
238  rcl_names_and_types_t * service_names_and_types);
239 
241 
278 rcl_ret_t
280  const rcl_node_t * node,
281  rcl_allocator_t * allocator,
282  bool no_demangle,
283  rcl_names_and_types_t * topic_names_and_types);
284 
286 
318 rcl_ret_t
320  const rcl_node_t * node,
321  rcl_allocator_t * allocator,
322  rcl_names_and_types_t * service_names_and_types);
323 
325 
349 rcl_ret_t
351  rcl_names_and_types_t * names_and_types,
352  size_t size,
353  rcl_allocator_t * allocator);
354 
356 
380 rcl_ret_t
381 rcl_names_and_types_fini(rcl_names_and_types_t * names_and_types);
382 
384 
430 rcl_ret_t
432  const rcl_node_t * node,
433  rcl_allocator_t allocator,
434  rcutils_string_array_t * node_names,
435  rcutils_string_array_t * node_namespaces);
436 
438 
476 rcl_ret_t
478  const rcl_node_t * node,
479  const char * topic_name,
480  size_t * count);
481 
483 
521 rcl_ret_t
523  const rcl_node_t * node,
524  const char * topic_name,
525  size_t * count);
526 
528 
564 rcl_ret_t
566  const rcl_node_t * node,
567  const rcl_client_t * client,
568  bool * is_available);
569 
570 #ifdef __cplusplus
571 }
572 #endif
573 
574 #endif // RCL__GRAPH_H_
rcl_ret_t rcl_get_service_names_and_types_by_node(const rcl_node_t *node, rcl_allocator_t *allocator, const char *node_name, const char *node_namespace, rcl_names_and_types_t *service_names_and_types)
Return a list of service names and types associated with a node.
rmw_ret_t rcl_ret_t
Definition: types.h:20
rcl_ret_t rcl_get_publisher_names_and_types_by_node(const rcl_node_t *node, rcl_allocator_t *allocator, bool no_demangle, const char *node_name, const char *node_namespace, rcl_names_and_types_t *topic_names_and_types)
Return a list of topic names and types for publishers associated with a node.
rcl_ret_t rcl_get_node_names(const rcl_node_t *node, rcl_allocator_t allocator, rcutils_string_array_t *node_names, rcutils_string_array_t *node_namespaces)
Return a list of available nodes in the ROS graph.
rcl_ret_t rcl_get_client_names_and_types_by_node(const rcl_node_t *node, rcl_allocator_t *allocator, const char *node_name, const char *node_namespace, rcl_names_and_types_t *service_names_and_types)
Return a list of service client names and types associated with a node.
rmw_names_and_types_t rcl_names_and_types_t
Definition: graph.h:35
Structure which encapsulates a ROS Client.
Definition: client.h:33
rcl_ret_t rcl_get_subscriber_names_and_types_by_node(const rcl_node_t *node, rcl_allocator_t *allocator, bool no_demangle, const char *node_name, const char *node_namespace, rcl_names_and_types_t *topic_names_and_types)
Return a list of topic names and types for subscriptions associated with a node.
#define RCL_WARN_UNUSED
Ignored return values of functions with this macro will emit a warning.
Definition: macros.h:25
rcl_ret_t rcl_count_publishers(const rcl_node_t *node, const char *topic_name, size_t *count)
Return the number of publishers on a given topic.
#define RCL_PUBLIC
Definition: visibility_control.h:48
rcl_ret_t rcl_names_and_types_init(rcl_names_and_types_t *names_and_types, size_t size, rcl_allocator_t *allocator)
Initialize a rcl_names_and_types_t object.
rcl_ret_t rcl_service_server_is_available(const rcl_node_t *node, const rcl_client_t *client, bool *is_available)
Check if a service server is available for the given service client.
rcl_ret_t rcl_get_topic_names_and_types(const rcl_node_t *node, rcl_allocator_t *allocator, bool no_demangle, rcl_names_and_types_t *topic_names_and_types)
Return a list of topic names and their types.
rcl_ret_t rcl_count_subscribers(const rcl_node_t *node, const char *topic_name, size_t *count)
Return the number of subscriptions on a given topic.
rcl_ret_t rcl_names_and_types_fini(rcl_names_and_types_t *names_and_types)
Finalize a rcl_names_and_types_t object.
Structure which encapsulates a ROS Node.
Definition: node.h:37
rcl_ret_t rcl_get_service_names_and_types(const rcl_node_t *node, rcl_allocator_t *allocator, rcl_names_and_types_t *service_names_and_types)
Return a list of service names and their types.