Classes | Public Member Functions | Private Types | Private Member Functions | Private Attributes | Friends | List of all members
ros::ServiceClient Class Reference

Provides a handle-based interface to service client connections. More...

#include <service_client.h>

Classes

struct  Impl
 

Public Member Functions

template<typename MReq , typename MRes >
bool call (const MReq &req, MRes &resp, const std::string &service_md5sum)
 Mostly for internal use, the other templated versions of call() just call into this one. More...
 
bool call (const SerializedMessage &req, SerializedMessage &resp, const std::string &service_md5sum)
 
template<class MReq , class MRes >
bool call (MReq &req, MRes &res)
 Call the service aliased by this handle with the specified request/response messages. More...
 
template<class Service >
bool call (Service &service)
 Call the service aliased by this handle with the specified service request/response. More...
 
bool exists ()
 Checks if this is both advertised and available. More...
 
std::string getService ()
 Returns the name of the service this ServiceClient connects to. More...
 
bool isPersistent () const
 Returns true if this handle points to a persistent service, false otherwise. More...
 
bool isValid () const
 Returns whether or not this handle is valid. For a persistent service, this becomes false when the connection has dropped. Non-persistent service handles are always valid. More...
 
 operator void * () const
 
bool operator!= (const ServiceClient &rhs) const
 
bool operator< (const ServiceClient &rhs) const
 
ServiceClientoperator= (const ServiceClient &other)=default
 
bool operator== (const ServiceClient &rhs) const
 
 ServiceClient ()
 
 ServiceClient (const ServiceClient &rhs)
 
 ServiceClient (const std::string &service_name, bool persistent, const M_string &header_values, const std::string &service_md5sum)
 
void shutdown ()
 Shutdown the connection associated with this ServiceClient. More...
 
bool waitForExistence (ros::Duration timeout=ros::Duration(-1))
 Wait for this service to be advertised and available. Blocks until it is. More...
 
 ~ServiceClient ()
 

Private Types

typedef boost::shared_ptr< ImplImplPtr
 
typedef boost::weak_ptr< ImplImplWPtr
 

Private Member Functions

void deserializeFailed (const std::exception &e)
 

Private Attributes

ImplPtr impl_
 

Friends

class NodeHandle
 
class NodeHandleBackingCollection
 

Detailed Description

Provides a handle-based interface to service client connections.

Definition at line 42 of file service_client.h.

Member Typedef Documentation

◆ ImplPtr

Definition at line 204 of file service_client.h.

◆ ImplWPtr

typedef boost::weak_ptr<Impl> ros::ServiceClient::ImplWPtr
private

Definition at line 205 of file service_client.h.

Constructor & Destructor Documentation

◆ ServiceClient() [1/3]

ros::ServiceClient::ServiceClient ( )
inline

Definition at line 45 of file service_client.h.

◆ ServiceClient() [2/3]

ros::ServiceClient::ServiceClient ( const std::string &  service_name,
bool  persistent,
const M_string header_values,
const std::string &  service_md5sum 
)

Definition at line 84 of file service_client.cpp.

◆ ServiceClient() [3/3]

ros::ServiceClient::ServiceClient ( const ServiceClient rhs)

Definition at line 98 of file service_client.cpp.

◆ ~ServiceClient()

ros::ServiceClient::~ServiceClient ( )

Definition at line 103 of file service_client.cpp.

Member Function Documentation

◆ call() [1/4]

template<typename MReq , typename MRes >
bool ros::ServiceClient::call ( const MReq &  req,
MRes &  resp,
const std::string &  service_md5sum 
)
inline

Mostly for internal use, the other templated versions of call() just call into this one.

Definition at line 98 of file service_client.h.

◆ call() [2/4]

bool ros::ServiceClient::call ( const SerializedMessage req,
SerializedMessage resp,
const std::string &  service_md5sum 
)

Definition at line 108 of file service_client.cpp.

◆ call() [3/4]

template<class MReq , class MRes >
bool ros::ServiceClient::call ( MReq &  req,
MRes &  res 
)
inline

Call the service aliased by this handle with the specified request/response messages.

Note
The request/response message types must match the types specified in the templated call to NodeHandle::serviceClient()/servicecreateClient()

Definition at line 56 of file service_client.h.

◆ call() [4/4]

template<class Service >
bool ros::ServiceClient::call ( Service &  service)
inline

Call the service aliased by this handle with the specified service request/response.

Definition at line 82 of file service_client.h.

◆ deserializeFailed()

void ros::ServiceClient::deserializeFailed ( const std::exception &  e)
inlineprivate

Definition at line 184 of file service_client.h.

◆ exists()

bool ros::ServiceClient::exists ( )

Checks if this is both advertised and available.

Returns
true if the service is up and available, false otherwise

Definition at line 193 of file service_client.cpp.

◆ getService()

std::string ros::ServiceClient::getService ( )

Returns the name of the service this ServiceClient connects to.

Definition at line 203 of file service_client.cpp.

◆ isPersistent()

bool ros::ServiceClient::isPersistent ( ) const

Returns true if this handle points to a persistent service, false otherwise.

Definition at line 165 of file service_client.cpp.

◆ isValid()

bool ros::ServiceClient::isValid ( ) const

Returns whether or not this handle is valid. For a persistent service, this becomes false when the connection has dropped. Non-persistent service handles are always valid.

Definition at line 155 of file service_client.cpp.

◆ operator void *()

ros::ServiceClient::operator void * ( ) const
inline

Definition at line 164 of file service_client.h.

◆ operator!=()

bool ros::ServiceClient::operator!= ( const ServiceClient rhs) const
inline

Definition at line 175 of file service_client.h.

◆ operator<()

bool ros::ServiceClient::operator< ( const ServiceClient rhs) const
inline

Definition at line 165 of file service_client.h.

◆ operator=()

ServiceClient& ros::ServiceClient::operator= ( const ServiceClient other)
default

◆ operator==()

bool ros::ServiceClient::operator== ( const ServiceClient rhs) const
inline

Definition at line 170 of file service_client.h.

◆ shutdown()

void ros::ServiceClient::shutdown ( )

Shutdown the connection associated with this ServiceClient.

This method usually does not need to be explicitly called, as automatic shutdown happens when all copies of this ServiceClient go out of scope

This method overrides the automatic reference counted shutdown, and does so immediately.

Definition at line 175 of file service_client.cpp.

◆ waitForExistence()

bool ros::ServiceClient::waitForExistence ( ros::Duration  timeout = ros::Duration(-1))

Wait for this service to be advertised and available. Blocks until it is.

Parameters
timeoutThe amount of time to wait for before timing out. If timeout is -1 (default), waits until the node is shutdown
Returns
true on success, false otherwise

Definition at line 183 of file service_client.cpp.

Friends And Related Function Documentation

◆ NodeHandle

friend class NodeHandle
friend

Definition at line 209 of file service_client.h.

◆ NodeHandleBackingCollection

friend class NodeHandleBackingCollection
friend

Definition at line 210 of file service_client.h.

Member Data Documentation

◆ impl_

ImplPtr ros::ServiceClient::impl_
private

Definition at line 207 of file service_client.h.


The documentation for this class was generated from the following files:


roscpp
Author(s): Morgan Quigley, Josh Faust, Brian Gerkey, Troy Straszheim, Dirk Thomas , Jacob Perron
autogenerated on Thu Nov 23 2023 04:01:44