Serialize a Haskell value with a EncCBOR instance to an external binary representation.

The output is represented as a lazy ByteString and is constructed incrementally.

Serialize a Haskell value to an external binary representation.

The output is represented as a strict ByteString.

Serialize into a Builder. Useful if you want to throw other ByteStrings around it.

A flattened representation of a term, which is independent of any underlying binary representation, but which we later serialise into CBOR format.

Since: cborg-0.2.0.0

Get access to the current version being used in the encoder

Ignore the current version of the encoder and enforce the supplied one instead.

Conditionoly choose the encoder newer or older deceder, depending on the current version. Supplied version acts as a pivot.

Example

Alternative way to encode a Maybe type.

Note - this is not the default method for encoding Maybe, use encodeMaybe instead

Alternative way to encode a Maybe type.

Note - this is not the default method for encoding StrictMaybe, use encodeStrictMaybe instead

Encode a rational number with tag 30, as per tag assignment: https://www.iana.org/assignments/cbor-tags/cbor-tags.xhtml

https://peteroupc.github.io/CBOR/rational.html

Encode a list. Versions variance:

• [>= 2] - Variable length encoding for lists longer than 23 elements, otherwise exact length encoding
• [< 2] - Variable length encoding

Encode a Seq. Variable length encoding for Sequences larger than 23 elements, otherwise exact length encoding

Encode a Set. Versions variance:

• [>= 9] - Variable length encoding for Sets larger than 23 elements, otherwise exact length encoding. Prefixes with a special 258 setTag.
• [>= 2] - Variable length encoding for Sets larger than 23 elements, otherwise exact length encoding
• [< 2] - Variable length encoding. Prefixes with a special 258 setTag.

Encode a Map. Versions variance:

• [>= 2] - Variable length encoding for Maps larger than 23 key value pairs, otherwise exact length encoding
• [< 2] - Variable length encoding.

Mimics Map encoder encodeMap identically.

Generic encoder for vectors. Its intended use is to allow easy definition of EncCBOR instances for custom vector

Conditionally use variable length encoding for list like structures with length larger than 23, otherwise use exact list length encoding.

Encode any Foldable with the variable list length encoding, which will use indefinite encoding over 23 elements and definite otherwise.

Encode any Foldable with indefinite list length encoding

Encode a data structure as a Map with the 0-based index for a Key to a value. Uses variable map length encoding, which means an indefinite encoding for maps with over 23 elements and definite otherwise.

This is the optimal maximum number for encoding exact length. Above that threashold using variable length encoding will result in less bytes on the wire.

Convert a versioned EncCBOR instance to a plain Encoding using Byron protocol version.

Encode and serialise the given a and surround it with the semantic tag 24 In CBOR diagnostic notation: > 24(hDEADBEEF)

Like encodeNestedCbor, but assumes nothing about the shape of input object, so that it must be passed as a binary ByteString blob. It's the caller responsibility to ensure the input ByteString correspond indeed to valid, previously-serialised CBOR data.

Run a ByteString Builder using a strategy aimed at making smaller things efficiently.

It takes a size hint and produces a strict ByteString. This will be fast when the size hint is the same or slightly bigger than the true size.

Encode as bytes using MemPack and then encode those bytes as CBOR