pxmlw6n2f/Gazebo_Distributed/gazebo/transport/Subscriber.hh

84 lines
2.3 KiB
C++

/*
* Copyright (C) 2012 Open Source Robotics Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
/* Desc: Handles a subscription to a topic
* Author: Nate Koenig
*/
#ifndef _SUBSCRIBER_HH_
#define _SUBSCRIBER_HH_
#include <string>
#include <boost/shared_ptr.hpp>
#include "gazebo/transport/CallbackHelper.hh"
#include "gazebo/util/system.hh"
namespace gazebo
{
namespace transport
{
/// \addtogroup gazebo_transport
/// \{
/// \class Subscriber Subscriber.hh transport/transport.hh
/// \brief A subscriber to a topic
class GZ_TRANSPORT_VISIBLE Subscriber
{
/// \brief Constructor
/// \param[in] _topic The topic we're subscribing to
/// \param[in] _node The associated node
public: Subscriber(const std::string &_topic, NodePtr _node);
/// \brief Destructor
public: virtual ~Subscriber();
/// \internal
/// \brief Set the ID of the callback which is associated with this
/// subscriber. This function should only be used by Node.hh
/// \param[in] _id ID of the callback
public: void SetCallbackId(unsigned int _id);
/// \internal
/// \brief Get the ID of the callback which is associated with this
/// subscriber. This function should only be used by Node.hh
/// \return ID of the callback
public: unsigned int GetCallbackId() const;
/// \brief Get the topic name
/// \return The topic name
public: std::string GetTopic() const;
/// \brief Unsubscribe from the topic
public: void Unsubscribe() const;
/// \brief Topic this object is subscribe to.
private: std::string topic;
/// \brief Node which handles communication.
private: NodePtr node;
/// \brief Id of the callback associated with this object.
private: unsigned int callbackId;
};
/// \}
}
}
#endif