zmq_z85_encode(3)

zmq_z85_encode3

Encode a binary key as z85 printable text

Usage

char *zmq_z85_encode (char *dest, const uint8_t *data, size_t size);

Overview

The zmq_z85_encode() function shall encode the binary block specified by data and size into a string in dest. The size of the binary block must be divisible by 4. The dest must have sufficient space for size * 1.25 plus 1 for a null terminator. A 32-byte CURVE key is encoded as 40 ASCII characters plus a null terminator.

The encoding shall follow the ZMQ RFC 32 specification.

Return value

The zmq_z85_encode() function shall return dest if successful, else it shall return NULL.

Examples

Encoding a CURVE key.

#include <sodium.h>
uint8_t public_key [32];
uint8_t secret_key [32];
int rc = crypto_box_keypair (public_key, secret_key);
assert (rc == 0);
char encoded [41];
zmq_z85_encode (encoded, public_key, 32);
puts (encoded);

Releases

7 releases since Debian 8 (Jessie); the text changed 6 times.

  1. 8
  2. 9
  3. 10
  4. 11
  5. 12
  6. 13
  7. Arch

Authors

This page was written by the 0MQ community. To make a change please read the 0MQ Contribution Policy at http://www.zeromq.org/docs:contributing.

From zeromq 4.3.5-3 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.