GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
ZMQ_CPP(7) 0MQ Manual ZMQ_CPP(7)

zmq_cpp - interface between 0MQ and C++ applications

#include <zmq.hpp>
c++ [flags] files -lzmq [libraries]

This manual page describes how the 0MQ C++ language binding maps to the underlying 0MQ C library functions.
All 0MQ constants defined by zmq.h are also available to the C++ language binding.
The following classes are provided in the zmq namespace:

The context_t class encapsulates functionality dealing with the initialisation and termination of a 0MQ context.
 
Constructor
 
context_t::context_t(int io_threads)
Maps to the zmq_init() function, as described in zmq_init(3).
 
Destructor
 
context_t::~context_t(void)
Maps to the zmq_term() function, as described in zmq_term(3).
 
Methods
 
None.

The socket_t class encapsulates a 0MQ socket.
 
Constructor
 
socket_t::socket_t(context_t &context, int type)
Maps to the zmq_socket() function, as described in zmq_socket(3).
 
Destructor
 
socket_t::~socket_t(void)
Calls the zmq_close() function, as described in zmq_close(3).
 
Methods
 
void socket_t::getsockopt(int option_name, void *option_value, size_t
*option_len)
Maps to the zmq_getsockopt() function, as described in zmq_getsockopt(3).
void socket_t::setsockopt(int option_name, const void *option_value, size_t
option_len)
Maps to the zmq_setsockopt() function, as described in zmq_setsockopt(3).
void socket_t::bind(const char *endpoint)
Maps to the zmq_bind() function, as described in zmq_bind(3).
void socket_t::connect(const char *endpoint)
Maps to the zmq_connect() function, as described in zmq_connect(3).
bool socket_t::send(message_t &msg, int flags = 0)
Maps to the zmq_send() function, as described in zmq_send(3). Returns true if message is successfully sent, false if it is not.
bool socket_t::recv(message_t *msg, int flags = 0)
Maps to the zmq_recv() function, as described in zmq_recv(3). Returns true if message is successfully received, false if it is not.

The zmq::message_t class encapsulates the zmq_msg_t structure and functions to construct, destruct and manipulate 0MQ messages.
 
Constructor
 
message_t::message_t(void)
message_t::message_t(size_t size)
message_t::message_t(void *data, size_t size, free_fn *ffn)
These map to the zmq_msg_init(), zmq_msg_init_size() and zmq_msg_init_data() functions, described in zmq_msg_init(3), zmq_msg_init_size(3) and zmq_msg_init_data(3) respectively.
 
Destructor
 
message_t::~message_t(void)
Calls the zmq_msg_close() function, as described in zmq_msg_close(3).
 
Methods
 
void *message_t::data (void)
Maps to the zmq_msg_data() function, as described in zmq_msg_data(3).
size_t message_t::size (void)
Maps to the zmq_msg_size() function, as described in zmq_msg_size(3).
void message_t::copy (message_t *src)
Maps to the zmq_msg_copy() function, as described in zmq_msg_copy(3).
void message_t::move (message_t *src)
Maps to the zmq_msg_move() function, as described in zmq_msg_move(3).
message_t::rebuild(void)
message_t::rebuild(size_t size)
message_t::rebuild(void *data, size_t size, free_fn *ffn)
Equivalent to calling the zmq_msg_close() function followed by the corresponding zmq_msg_init() function.

int poll (zmq_pollitem_t *items, int nitems, long timeout = -1)
The poll() function is a namespaced equivalent of the zmq_poll() function, as described in zmq_poll(3).
 
Note
 
 
To obtain a 0MQ socket for use in a zmq_pollitem_t structure, you should cast an instance of the socket_t class to (void *).

All errors reported by the underlying 0MQ C library functions are automatically converted to exceptions by the C++ language binding. The zmq::error_t class is derived from the std::exception class and uses the zmq_strerror() function to convert the error code to human-readable string.

zmq::context_t ctx (1);
zmq::socket_t s (ctx, ZMQ_PUB);
s.connect ("tcp://192.168.0.115:5555");
zmq::message_t msg (100);
memset (msg.data (), 0, 100);
s.send (msg);

zmq(7)

This manual page was written by the 0MQ community.
04/04/2012 0MQ 2.2.0

Search for    or go to Top of page |  Section 7 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.