rcl  master
C API providing common ROS client library functionality.
wait.h
Go to the documentation of this file.
1 // Copyright 2015 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__WAIT_H_
16 #define RCL__WAIT_H_
17 
18 #ifdef __cplusplus
19 extern "C"
20 {
21 #endif
22 
23 #include <stdbool.h>
24 #include <stddef.h>
25 
26 #include "rcl/client.h"
27 #include "rcl/guard_condition.h"
28 #include "rcl/macros.h"
29 #include "rcl/service.h"
30 #include "rcl/subscription.h"
31 #include "rcl/timer.h"
32 #include "rcl/types.h"
33 #include "rcl/visibility_control.h"
34 
35 struct rcl_wait_set_impl_t;
36 
38 typedef struct rcl_wait_set_t
39 {
47  const rcl_timer_t ** timers;
56  struct rcl_wait_set_impl_t * impl;
58 
64 
66 
117 rcl_ret_t
119  rcl_wait_set_t * wait_set,
120  size_t number_of_subscriptions,
121  size_t number_of_guard_conditions,
122  size_t number_of_timers,
123  size_t number_of_clients,
124  size_t number_of_services,
125  rcl_allocator_t allocator);
126 
128 
154 rcl_ret_t
156 
158 
178 rcl_ret_t
179 rcl_wait_set_get_allocator(const rcl_wait_set_t * wait_set, rcl_allocator_t * allocator);
180 
182 
209 rcl_ret_t
211  rcl_wait_set_t * wait_set,
212  const rcl_subscription_t * subscription,
213  size_t * index);
214 
216 
240 rcl_ret_t
242 
244 
282 rcl_ret_t
284  rcl_wait_set_t * wait_set,
285  size_t subscriptions_size,
286  size_t guard_conditions_size,
287  size_t timers_size,
288  size_t clients_size,
289  size_t services_size);
290 
292 
298 rcl_ret_t
300  rcl_wait_set_t * wait_set,
301  const rcl_guard_condition_t * guard_condition,
302  size_t * index);
303 
305 
311 rcl_ret_t
313  rcl_wait_set_t * wait_set,
314  const rcl_timer_t * timer,
315  size_t * index);
316 
318 
324 rcl_ret_t
326  rcl_wait_set_t * wait_set,
327  const rcl_client_t * client,
328  size_t * index);
329 
331 
337 rcl_ret_t
339  rcl_wait_set_t * wait_set,
340  const rcl_service_t * service,
341  size_t * index);
342 
344 
437 rcl_ret_t
438 rcl_wait(rcl_wait_set_t * wait_set, int64_t timeout);
439 
440 #ifdef __cplusplus
441 }
442 #endif
443 
444 #endif // RCL__WAIT_H_
Container for subscription&#39;s, guard condition&#39;s, etc to be waited on.
Definition: wait.h:38
const rcl_service_t ** services
Storage for service pointers.
Definition: wait.h:53
rmw_ret_t rcl_ret_t
Definition: types.h:20
size_t size_of_clients
Definition: wait.h:51
size_t size_of_guard_conditions
Definition: wait.h:45
rcl_ret_t rcl_wait_set_get_allocator(const rcl_wait_set_t *wait_set, rcl_allocator_t *allocator)
Retrieve the wait set&#39;s allocator.
size_t size_of_subscriptions
Definition: wait.h:42
size_t size_of_services
Definition: wait.h:54
const rcl_client_t ** clients
Storage for client pointers.
Definition: wait.h:50
Structure which encapsulates a ROS Client.
Definition: client.h:33
rcl_wait_set_t rcl_get_zero_initialized_wait_set(void)
Return a rcl_wait_set_t struct with members set to NULL.
const rcl_timer_t ** timers
Storage for timer pointers.
Definition: wait.h:47
#define RCL_WARN_UNUSED
Ignored return values of functions with this macro will emit a warning.
Definition: macros.h:25
size_t size_of_timers
Definition: wait.h:48
#define RCL_PUBLIC
Definition: visibility_control.h:48
rcl_ret_t rcl_wait_set_fini(rcl_wait_set_t *wait_set)
Finalize a rcl wait set.
rcl_ret_t rcl_wait_set_resize(rcl_wait_set_t *wait_set, size_t subscriptions_size, size_t guard_conditions_size, size_t timers_size, size_t clients_size, size_t services_size)
Reallocate space for entities in the wait set.
struct rcl_wait_set_impl_t * impl
Implementation specific storage.
Definition: wait.h:56
Structure which encapsulates a ROS Service.
Definition: service.h:33
rcl_ret_t rcl_wait_set_add_timer(rcl_wait_set_t *wait_set, const rcl_timer_t *timer, size_t *index)
Store a pointer to the timer in the next empty spot in the set.
struct rcl_wait_set_t rcl_wait_set_t
Container for subscription&#39;s, guard condition&#39;s, etc to be waited on.
rcl_ret_t rcl_wait_set_add_service(rcl_wait_set_t *wait_set, const rcl_service_t *service, size_t *index)
Store a pointer to the service in the next empty spot in the set.
rcl_ret_t rcl_wait_set_clear(rcl_wait_set_t *wait_set)
Remove (sets to NULL) all entities in the wait set.
Structure which encapsulates a ROS Subscription.
Definition: subscription.h:33
rcl_ret_t rcl_wait(rcl_wait_set_t *wait_set, int64_t timeout)
Block until the wait set is ready or until the timeout has been exceeded.
rcl_ret_t rcl_wait_set_add_subscription(rcl_wait_set_t *wait_set, const rcl_subscription_t *subscription, size_t *index)
Store a pointer to the given subscription in the next empty spot in the set.
Structure which encapsulates a ROS Timer.
Definition: timer.h:37
rcl_ret_t rcl_wait_set_add_client(rcl_wait_set_t *wait_set, const rcl_client_t *client, size_t *index)
Store a pointer to the client in the next empty spot in the set.
rcl_ret_t rcl_wait_set_init(rcl_wait_set_t *wait_set, size_t number_of_subscriptions, size_t number_of_guard_conditions, size_t number_of_timers, size_t number_of_clients, size_t number_of_services, rcl_allocator_t allocator)
Initialize a rcl wait set with space for items to be waited on.
Handle for a rcl guard condition.
Definition: guard_condition.h:33
const rcl_guard_condition_t ** guard_conditions
Storage for guard condition pointers.
Definition: wait.h:44
const rcl_subscription_t ** subscriptions
Storage for subscription pointers.
Definition: wait.h:41
rcl_ret_t rcl_wait_set_add_guard_condition(rcl_wait_set_t *wait_set, const rcl_guard_condition_t *guard_condition, size_t *index)
Store a pointer to the guard condition in the next empty spot in the set.