X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/f364225c23f541330fdc9a512d551a683cf374c9..4634214e18b847f6346048fa12179d3d99ae82c9:/include/simgrid/s4u/Mailbox.hpp diff --git a/include/simgrid/s4u/Mailbox.hpp b/include/simgrid/s4u/Mailbox.hpp index 035a928d05..687e78393c 100644 --- a/include/simgrid/s4u/Mailbox.hpp +++ b/include/simgrid/s4u/Mailbox.hpp @@ -6,14 +6,11 @@ #ifndef SIMGRID_S4U_MAILBOX_HPP #define SIMGRID_S4U_MAILBOX_HPP -#include - -#include #include - -#include #include +#include + namespace simgrid { namespace s4u { @@ -113,23 +110,23 @@ class XBT_PUBLIC Mailbox { explicit Mailbox(kernel::activity::MailboxImpl * mbox) : pimpl_(mbox) {} /** private function to manage the mailboxes' lifetime (see @ref s4u_raii) */ - friend XBT_PUBLIC void intrusive_ptr_add_ref(Mailbox*) {} + friend void intrusive_ptr_add_ref(Mailbox*) {} /** private function to manage the mailboxes' lifetime (see @ref s4u_raii) */ - friend XBT_PUBLIC void intrusive_ptr_release(Mailbox*) {} + friend void intrusive_ptr_release(Mailbox*) {} public: /** private function, do not use. FIXME: make me protected */ - kernel::activity::MailboxImpl* getImpl() { return pimpl_; } + kernel::activity::MailboxImpl* get_impl() { return pimpl_; } /** @brief Retrieves the name of that mailbox as a C++ string */ - const simgrid::xbt::string& getName() const; + const simgrid::xbt::string& get_name() const; /** @brief Retrieves the name of that mailbox as a C string */ - const char* getCname() const; + const char* get_cname() const; /** Retrieve the mailbox associated to the given C string */ - static MailboxPtr byName(const char *name); + static MailboxPtr by_name(const char* name); /** Retrieve the mailbox associated to the given C++ string */ - static MailboxPtr byName(std::string name); + static MailboxPtr by_name(std::string name); /** Returns whether the mailbox contains queued communications */ bool empty(); @@ -146,10 +143,10 @@ public: * its host even before he does a recv(). This models the real behavior of TCP * and MPI communications, amongst other. */ - void setReceiver(ActorPtr actor); + void set_receiver(ActorPtr actor); /** Return the actor declared as permanent receiver, or nullptr if none **/ - ActorPtr getReceiver(); + ActorPtr get_receiver(); /** Creates (but don't start) a data emission to that mailbox */ CommPtr put_init(); @@ -169,9 +166,33 @@ public: CommPtr get_async(void** data); /** Blocking data reception */ - void* get(); + void* get(); // FIXME: make a typed template version /** Blocking data reception with timeout */ void* get(double timeout); + + // Deprecated functions + XBT_ATTRIB_DEPRECATED_v323("Please use Mailbox::set_receiver()") void setReceiver(ActorPtr actor) + { + set_receiver(actor); + } + XBT_ATTRIB_DEPRECATED_v323("Please use Mailbox::get_receiver()") ActorPtr getReceiver() { return get_receiver(); } + XBT_ATTRIB_DEPRECATED_v323("Please use Mailbox::get_name()") const simgrid::xbt::string& getName() const + { + return get_name(); + } + XBT_ATTRIB_DEPRECATED_v323("Please use Mailbox::get_cname()") const char* getCname() const { return get_cname(); } + XBT_ATTRIB_DEPRECATED_v323("Please use Mailbox::get_impl()") kernel::activity::MailboxImpl* getImpl() + { + return get_impl(); + } + XBT_ATTRIB_DEPRECATED_v323("Please use Mailbox::by_name()") static MailboxPtr byName(const char* name) + { + return by_name(name); + } + XBT_ATTRIB_DEPRECATED_v323("Please use Mailbox::by_name()") static MailboxPtr byName(std::string name) + { + return by_name(name); + } }; }} // namespace simgrid::s4u