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 
84  const rcl_node_t * node,
85  rcl_allocator_t * allocator,
86  bool no_demangle,
87  const char * node_name,
88  const char * node_namespace,
89  rcl_names_and_types_t * topic_names_and_types);
90 
92 
129 rcl_ret_t
131  const rcl_node_t * node,
132  rcl_allocator_t * allocator,
133  bool no_demangle,
134  const char * node_name,
135  const char * node_namespace,
136  rcl_names_and_types_t * topic_names_and_types);
137 
139 
175 rcl_ret_t
177  const rcl_node_t * node,
178  rcl_allocator_t * allocator,
179  const char * node_name,
180  const char * node_namespace,
181  rcl_names_and_types_t * service_names_and_types);
182 
184 
219 rcl_ret_t
221  const rcl_node_t * node,
222  rcl_allocator_t * allocator,
223  bool no_demangle,
224  rcl_names_and_types_t * topic_names_and_types);
225 
227 
259 rcl_ret_t
261  const rcl_node_t * node,
262  rcl_allocator_t * allocator,
263  rcl_names_and_types_t * service_names_and_types);
264 
266 
290 rcl_ret_t
292  rcl_names_and_types_t * names_and_types,
293  size_t size,
294  rcl_allocator_t * allocator);
295 
297 
321 rcl_ret_t
322 rcl_names_and_types_fini(rcl_names_and_types_t * names_and_types);
323 
325 
371 rcl_ret_t
373  const rcl_node_t * node,
374  rcl_allocator_t allocator,
375  rcutils_string_array_t * node_names,
376  rcutils_string_array_t * node_namespaces);
377 
379 
417 rcl_ret_t
419  const rcl_node_t * node,
420  const char * topic_name,
421  size_t * count);
422 
424 
462 rcl_ret_t
464  const rcl_node_t * node,
465  const char * topic_name,
466  size_t * count);
467 
469 
505 rcl_ret_t
507  const rcl_node_t * node,
508  const rcl_client_t * client,
509  bool * is_available);
510 
511 #ifdef __cplusplus
512 }
513 #endif
514 
515 #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 for 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.
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.