Skip to contents

Publish multiple items to a stream in one transaction

Source: R/streams.R
mc_publish_multi.Rd

Publishes several key‑value items in a single transaction. This is more efficient than publishing each item separately.

Usage

mc_publish_multi(conn, stream, items, options = NULL)

Arguments

conn

A connection object created by mc_connect.

stream

Character string. Default stream for all items (if not overridden per item).

items

A list of item objects, each containing:

  • key or keys – the key(s) for the item.

  • data – the data to publish.

  • (optional) stream – override the default stream.

options

Optional default "offchain" string.

Value

A character string containing the transaction ID.

See also

mc_publish_multi_from for specifying the sender.

Other streams: mc_create_stream(), mc_create_stream_from(), mc_get_stream_info(), mc_get_stream_item(), mc_get_stream_key_summary(), mc_get_stream_publisher_summary(), mc_list_stream_block_items(), mc_list_stream_items(), mc_list_stream_key_items(), mc_list_stream_keys(), mc_list_stream_publisher_items(), mc_list_stream_publishers(), mc_list_stream_query_items(), mc_list_stream_tx_items(), mc_list_streams(), mc_publish(), mc_publish_from(), mc_publish_multi_from()

Examples

if (FALSE) { # \dontrun{
items <- list(
  list(key = "k1", data = list(text = "item1")),
  list(key = "k2", data = list(json = list(value = 2)))
)
txid <- mc_publish_multi(conn, "mystream", items)
} # }