You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by gs...@apache.org on 2009/10/29 12:12:32 UTC
svn commit: r830896 -
/qpid/trunk/qpid/cpp/include/qpid/client/SubscriptionManager.h
Author: gsim
Date: Thu Oct 29 11:12:32 2009
New Revision: 830896
URL: http://svn.apache.org/viewvc?rev=830896&view=rev
Log:
Added extra info to doxygen comments regarding use of SubscriptionManager::get().
Modified:
qpid/trunk/qpid/cpp/include/qpid/client/SubscriptionManager.h
Modified: qpid/trunk/qpid/cpp/include/qpid/client/SubscriptionManager.h
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/cpp/include/qpid/client/SubscriptionManager.h?rev=830896&r1=830895&r2=830896&view=diff
==============================================================================
--- qpid/trunk/qpid/cpp/include/qpid/client/SubscriptionManager.h (original)
+++ qpid/trunk/qpid/cpp/include/qpid/client/SubscriptionManager.h Thu Oct 29 11:12:32 2009
@@ -164,6 +164,9 @@
/** Get a single message from a queue.
+ * (Note: this currently uses a subscription per invocation and is
+ * thus relatively expensive. The subscription is cancelled as
+ * part of each call which can trigger auto-deletion).
*@param result is set to the message from the queue.
*@param timeout wait up this timeout for a message to appear.
*@return true if result was set, false if no message available after timeout.
@@ -171,6 +174,9 @@
QPID_CLIENT_EXTERN bool get(Message& result, const std::string& queue, sys::Duration timeout=0);
/** Get a single message from a queue.
+ * (Note: this currently uses a subscription per invocation and is
+ * thus relatively expensive. The subscription is cancelled as
+ * part of each call which can trigger auto-deletion).
*@param timeout wait up this timeout for a message to appear.
*@return message from the queue.
*@throw Exception if the timeout is exceeded.
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:commits-subscribe@qpid.apache.org