timer.cpp
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2009, Willow Garage, Inc.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are met:
6  * * Redistributions of source code must retain the above copyright notice,
7  * this list of conditions and the following disclaimer.
8  * * Redistributions in binary form must reproduce the above copyright
9  * notice, this list of conditions and the following disclaimer in the
10  * documentation and/or other materials provided with the distribution.
11  * * Neither the names of Stanford University or Willow Garage, Inc. nor the names of its
12  * contributors may be used to endorse or promote products derived from
13  * this software without specific prior written permission.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
16  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
19  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25  * POSSIBILITY OF SUCH DAMAGE.
26  */
27 
28 #include "ros/timer.h"
29 #include "ros/timer_manager.h"
30 
31 namespace ros
32 {
33 
35  : started_(false)
36  , timer_handle_(-1)
37 { }
38 
40 {
41  ROS_DEBUG("Timer deregistering callbacks.");
42  stop();
43 }
44 
46 {
47  return started_;
48 }
49 
51 {
52  return !period_.isZero();
53 }
54 
55 bool Timer::Impl::isValid() const
56 {
57  return !period_.isZero();
58 }
59 
61 {
62  if (!started_)
63  {
64  VoidConstPtr tracked_object;
65  if (has_tracked_object_)
66  {
67  tracked_object = tracked_object_.lock();
68  }
69 
70  timer_handle_ = TimerManager<Time, Duration, TimerEvent>::global().add(period_, callback_, callback_queue_, tracked_object, oneshot_);
71  started_ = true;
72  }
73 }
74 
76 {
77  if (started_)
78  {
79  started_ = false;
81  timer_handle_ = -1;
82  }
83 }
84 
86 {
87  if (!isValid() || timer_handle_ == -1)
88  {
89  return false;
90  }
91 
93 }
94 
95 void Timer::Impl::setPeriod(const Duration& period, bool reset)
96 {
97  period_ = period;
98  TimerManager<Time, Duration, TimerEvent>::global().setPeriod(timer_handle_, period, reset);
99 }
100 
102 : impl_(new Impl)
103 {
104  impl_->period_ = ops.period;
105  impl_->callback_ = ops.callback;
106  impl_->callback_queue_ = ops.callback_queue;
107  impl_->tracked_object_ = ops.tracked_object;
108  impl_->has_tracked_object_ = (ops.tracked_object != NULL);
109  impl_->oneshot_ = ops.oneshot;
110 }
111 
112 Timer::Timer(const Timer& rhs)
113 {
114  impl_ = rhs.impl_;
115 }
116 
118 {
119 }
120 
122 {
123  if (impl_)
124  {
125  impl_->start();
126  }
127 }
128 
130 {
131  if (impl_)
132  {
133  impl_->stop();
134  }
135 }
136 
138 {
139  if (impl_)
140  {
141  return impl_->hasPending();
142  }
143 
144  return false;
145 }
146 
147 void Timer::setPeriod(const Duration& period, bool reset)
148 {
149  if (impl_)
150  {
151  impl_->setPeriod(period, reset);
152  }
153 }
154 
155 }
ros::Timer::Impl::start
void start()
Definition: timer.cpp:60
ros::TimerOptions::callback_queue
CallbackQueueInterface * callback_queue
Queue to add callbacks to. If NULL, the global callback queue will be used.
Definition: timer_options.h:65
ros::Timer::impl_
ImplPtr impl_
Definition: timer.h:126
boost::shared_ptr< void const >
ros::TimerOptions
Encapsulates all options available for starting a timer.
Definition: timer_options.h:40
ros
ros::Timer::Impl::setPeriod
void setPeriod(const Duration &period, bool reset=true)
Definition: timer.cpp:95
ros::Timer::stop
void stop()
Stop the timer. Once this call returns, no more callbacks will be called. Does nothing if the timer i...
Definition: timer.cpp:129
ros::Timer::isValid
bool isValid()
Definition: timer.h:76
ros::TimerOptions::callback
TimerCallback callback
The callback to call.
Definition: timer_options.h:63
ros::Timer
Manages a timer callback.
Definition: timer.h:46
ros::Timer::Impl::Impl
Impl()
Definition: timer.cpp:34
ros::TimerManager::add
int32_t add(const D &period, const boost::function< void(const E &)> &callback, CallbackQueueInterface *callback_queue, const VoidConstPtr &tracked_object, bool oneshot)
Definition: timer_manager.h:314
timer_manager.h
ros::TimerOptions::tracked_object
VoidConstPtr tracked_object
Definition: timer_options.h:75
ROS_DEBUG
#define ROS_DEBUG(...)
timer.h
ros::Timer::setPeriod
void setPeriod(const Duration &period, bool reset=true)
Set the period of this timer.
Definition: timer.cpp:147
ros::Timer::~Timer
~Timer()
Definition: timer.cpp:117
ros::Timer::Impl::stop
void stop()
Definition: timer.cpp:75
ros::Timer::Impl::hasPending
bool hasPending()
Definition: timer.cpp:85
ros::TimerManager::setPeriod
void setPeriod(int32_t handle, const D &period, bool reset=true)
Definition: timer_manager.h:454
ros::TimerOptions::period
Duration period
The period to call the callback at.
Definition: timer_options.h:62
ros::Timer::Impl::hasStarted
bool hasStarted() const
Definition: timer.cpp:45
ros::Timer::hasPending
bool hasPending()
Returns whether or not the timer has any pending events to call.
Definition: timer.cpp:137
ros::Timer::Impl::isValid
bool isValid()
Definition: timer.cpp:50
ros::TimerManager::remove
void remove(int32_t handle)
Definition: timer_manager.h:363
ros::Timer::start
void start()
Start the timer. Does nothing if the timer is already started.
Definition: timer.cpp:121
ros::Timer::Impl::~Impl
~Impl()
Definition: timer.cpp:39
ros::Duration
ros::Timer::Impl
Definition: timer.h:98
ros::TimerManager::hasPending
bool hasPending(int32_t handle)
Definition: timer_manager.h:290
ros::TimerOptions::oneshot
bool oneshot
Definition: timer_options.h:77
ros::Timer::Timer
Timer()
Definition: timer.h:49
ros::TimerManager::global
static TimerManager & global()
Definition: timer_manager.h:117


roscpp
Author(s): Morgan Quigley, Josh Faust, Brian Gerkey, Troy Straszheim, Dirk Thomas , Jacob Perron
autogenerated on Sat Sep 14 2024 02:59:36