Go to file
Gudmundur Adalsteinsson ff23b4ce95 Problem: Friendship between socket_t and context_t
Solution: Not needed since the void* can be obtained from the API of
context_t
2019-03-26 21:58:38 +00:00
cmake Problem: version detection broken, confuses libzmq and cppzmq versions 2018-03-28 12:58:12 +02:00
demo Problem: libzmq 4.2.0 cmake build broken 2018-05-13 15:30:56 +01:00
libzmq-pkg-config fix install without static libzmq 2018-09-20 23:28:24 +02:00
tests Unit tests for message_t::get() 2019-03-14 14:25:50 +01:00
.clang-format Problem: whitespace style too restrictive. 2018-05-12 17:28:28 +01:00
.gitignore .gitignore added 2017-01-09 11:50:50 +01:00
.travis.yml Problem: current libzmq is not tested 2019-02-04 10:32:46 +01:00
appveyor.yml Problem: Dependency on googletest framework 2018-10-17 15:22:07 +01:00
ci_build.sh Problem: current libzmq is not tested 2019-02-04 10:32:46 +01:00
CMakeLists.txt Problem: cmake build succeeds even if libzmq not found 2018-05-25 11:13:32 +02:00
cppzmqConfig.cmake.in Problem: #209 cppzmq fails with cmake 3.6.3 and above 2018-07-05 00:12:34 +01:00
LICENSE Added license and link to C4.1 contribution policy 2013-05-10 07:39:40 -04:00
README.md Problem: current libzmq is not tested 2019-02-04 10:32:46 +01:00
version.sh Problem: version detection broken, confuses libzmq and cppzmq versions 2018-03-28 12:58:12 +02:00
zmq_addon.hpp add front and back (#269) 2018-10-17 08:41:21 +01:00
zmq.hpp Problem: Friendship between socket_t and context_t 2019-03-26 21:58:38 +00:00

Travis-CI Status Appveyor Status Coverage Status License

Introduction & Design Goals

cppzmq is a C++ binding for libzmq. It has the following design goals:

  • cppzmq maps the libzmq C API to C++ concepts. In particular:
    • it is type-safe (the libzmq C API exposes various class-like concepts as void*)
    • it provides exception-based error handling (the libzmq C API provides errno-based error handling)
    • it provides RAII-style classes that automate resource management (the libzmq C API requires the user to take care to free resources explicitly)
  • cppzmq is a light-weight, header-only binding. You only need to include the header file zmq.hpp (and maybe zmq_addon.hpp) to use it.
  • zmq.hpp is meant to contain direct mappings of the abstractions provided by the libzmq C API, while zmq_addon.hpp provides additional higher-level abstractions.

There are other C++ bindings for ZeroMQ with different design goals. In particular, none of the following bindings are header-only:

  • zmqpp is a high-level binding to libzmq.
  • czmqpp is a binding based on the high-level czmq API.
  • fbzmq is a binding that integrates with Apache Thrift and provides higher-level abstractions in addition. It requires C++14.

Supported platforms

  • Only a subset of the platforms that are supported by libzmq itself are supported. Some features already require a compiler supporting C++11. In the future, probably all features will require C++11. To build and run the tests, CMake and Catch are required.
  • Any libzmq 4.x version is expected to work. DRAFT features may only work for the most recent tested version. Currently explicitly tested libzmq versions are
    • 4.2.0 (without DRAFT API)
    • 4.2.5 (without DRAFT API)
    • 4.3.1 (with and without DRAFT API)
  • Platforms with full support (i.e. CI executing build and tests)
    • Ubuntu 14.04 x64 (with gcc 4.8.4) (without DRAFT API only)
    • Ubuntu 14.04 x64 (with gcc 7.3.0)
    • Visual Studio 2015 x86
    • Visual Studio 2017 x86
    • OSX (with clang xcode9.1) (without DRAFT API)
  • Additional platforms that are known to work:
    • We have no current reports on additional platforms that are known to work yet. Please add your platform here. If CI can be provided for them with a cloud-based CI service working with GitHub, you are invited to add CI, and make it possible to be included in the list above.
  • Additional platforms that probably work:
    • Any platform supported by libzmq that provides a sufficiently recent gcc (4.8.1 or newer) or clang (3.3 or newer)
    • Visual Studio 2012+ x86/x64

Contribution policy

The contribution policy is at: http://rfc.zeromq.org/spec:22

Build instructions

Build steps:

  1. Build libzmq via cmake. This does an out of source build and installs the build files

    • download and unzip the lib, cd to directory
    • mkdir build
    • cd build
    • cmake ..
    • sudo make -j4 install
  2. Build cppzmq via cmake. This does an out of source build and installs the build files

    • download and unzip the lib, cd to directory
    • mkdir build
    • cd build
    • cmake ..
    • sudo make -j4 install

Using this:

A cmake find package scripts is provided for you to easily include this library. Add these lines in your CMakeLists.txt to include the headers and library files of cpp zmq (which will also include libzmq for you).

#find cppzmq wrapper, installed by make of cppzmq
find_package(cppzmq)
target_link_libraries(*Your Project Name* cppzmq)