/*
Copyright (c) 2007-2009 FastMQ Inc.
This file is part of 0MQ.
0MQ is free software; you can redistribute it and/or modify it under
the terms of the Lesser GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
0MQ is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
Lesser GNU General Public License for more details.
You should have received a copy of the Lesser GNU General Public License
along with this program. If not, see .
*/
#ifndef __ZMQ_HPP_INCLUDED__
#define __ZMQ_HPP_INCLUDED__
#include "zmq.h"
#include
#include
#include
namespace zmq
{
typedef zmq_free_fn free_fn;
enum message_type_t
{
message_data = 1 << 0,
message_gap = 1 << ZMQ_GAP,
message_delimiter = 1 << ZMQ_DELIMITER
};
class no_memory : public exception
{
virtual const char *what ()
{
return "Out of memory";
}
};
class invalid_argument : public exception
{
virtual const char *what ()
{
return "Invalid argument";
}
};
class too_many_threads : public exception
{
virtual const char *what ()
{
return "Too many threads";
}
};
class address_in_use : public exception
{
virtual const char *what ()
{
return "Address in use";
}
};
// A message. Caution: Don't change the body of the message once you've
// copied it - the behaviour is undefined. Don't change the body of the
// received message either - other threads may be accessing it in parallel.
class message_t : private zmq_msg
{
friend class socket_t;
public:
// Creates message size_ bytes long.
inline message_t (size_t size_ = 0)
{
int rc = zmq_msg_init_size (this, size_);
if (rc == -1) {
assert (errno == ENOMEM);
throw no_memory ();
}
}
// Creates message from the supplied buffer. 0MQ takes care of
// deallocating the buffer once it is not needed. The deallocation
// function is supplied in ffn_ parameter. If ffn_ is NULL, no
// deallocation happens - this is useful for sending static buffers.
inline message_t (void *data_, size_t size_,
free_fn *ffn_)
{
int rc = zmq_msg_init_data (this, data_, size_, ffn_);
assert (rc == 0);
}
// Destroys the message.
inline ~message_t ()
{
int rc = zmq_msg_close (this);
assert (rc == 0);
}
// Destroys old content of the message and allocates buffer for the
// new message body. Having this as a separate function allows user
// to reuse once-allocated message for multiple times.
inline void rebuild (size_t size_)
{
int rc = zmq_msg_close (this);
assert (rc == 0);
rc = zmq_msg_init_size (this, size_);
if (rc == -1) {
assert (errno == ENOMEM);
throw no_memory ();
}
}
// Same as above, however, the message is rebuilt from the supplied
// buffer. See appropriate constructor for discussion of buffer
// deallocation mechanism.
inline void rebuild (void *data_, size_t size_, free_fn *ffn_)
{
int rc = zmq_msg_close (this);
assert (rc == 0);
rc = zmq_msg_init_data (this, data_, size_, ffn_);
assert (rc == 0);
}
// Moves the message content from one message to the another. If the
// destination message have contained data prior to the operation
// these get deallocated. The source message will contain 0 bytes
// of data after the operation.
inline void move_to (message_t *msg_)
{
int rc = zmq_msg_move (this, (zmq_msg*) msg_);
assert (rc == 0);
}
// Copies the message content from one message to the another. If the
// destination message have contained data prior to the operation
// these get deallocated.
inline void copy_to (message_t *msg_)
{
int rc = zmq_msg_copy (this, (zmq_msg*) msg_);
assert (rc == 0);
}
// Returns message type.
inline message_type_t type ()
{
return (message_type_t) (1 << zmq_msg_type (this));
}
// Returns pointer to message's data buffer.
inline void *data ()
{
return zmq_msg_data (this);
}
// Returns the size of message data buffer.
inline size_t size ()
{
return zmq_msg_size (this);
}
private:
// Disable implicit message copying, so that users won't use shared
// messages (less efficient) without being aware of the fact.
message_t (const message_t&);
void operator = (const message_t&);
};
class context_t
{
friend class socket_t;
public:
inline context_t (int app_threads_, int io_threads_)
{
ptr = zmq_init (app_threads_, io_threads_);
if (ptr == NULL) {
assert (errno == EINVAL);
throw invalid_argument ();
}
}
inline ~context_t ()
{
int rc = zmq_term (ptr);
assert (rc == 0);
}
private:
void *ptr;
// Disable copying.
context_t (const context_t&);
void operator = (const context_t&);
};
class socket_t
{
public:
inline socket_t (context_t &context_, int type_ = 0)
{
ptr = zmq_socket (context_.ptr, type_);
if (ptr == NULL) {
assert (errno == EMFILE || errno == EINVAL);
if (errno == EMFILE)
throw too_many_threads ();
else
throw invalid_argument ();
}
}
inline ~socket_t ()
{
int rc = zmq_close (ptr);
assert (rc == 0);
}
inline void bind (const char *addr_, zmq_opts *opts_ = NULL)
{
int rc = zmq_bind (ptr, addr_, opts_);
if (rc == -1) {
assert (errno == EINVAL || errno == EADDRINUSE);
if (errno == EINVAL)
throw invalid_argument ();
else
throw address_in_use ();
}
}
inline void connect (const char *addr_, zmq_opts *opts_ = NULL)
{
int rc = zmq_connect (ptr, addr_, opts_);
if (rc == -1) {
assert (errno == EINVAL || errno == EADDRINUSE);
if (errno == EINVAL)
throw invalid_argument ();
else
throw address_in_use ();
}
}
inline void subscribe (const char *criteria_)
{
int rc = zmq_subscribe (ptr, criteria_);
assert (rc == 0);
}
inline int send (message_t &msg_, int flags_ = 0)
{
int rc = zmq_send (ptr, &msg_, flags_);
assert (rc == 0 || (rc == -1 && errno == EAGAIN));
return rc;
}
inline void flush ()
{
int rc = zmq_flush (ptr);
assert (rc == 0);
}
inline int recv (message_t *msg_, int flags_ = 0)
{
int rc = zmq_recv (ptr, msg_, flags_);
assert (rc == 0 || (rc == -1 && errno == EAGAIN));
return rc;
}
private:
void *ptr;
// Disable copying.
socket_t (const socket_t&);
void operator = (const socket_t&);
};
}
#endif