Function anjay_send_batch_add_bytes

Function Documentation

int anjay_send_batch_add_bytes(anjay_send_batch_builder_t *builder, anjay_oid_t oid, anjay_iid_t iid, anjay_rid_t rid, anjay_riid_t riid, avs_time_real_t timestamp, const void *data, size_t length)

Adds bytes to batch builder.

IMPORTANT NOTE: If timestamp is earlier than 1978-07-04 21:24:16 UTC (2**28 seconds since Unix epoch), then it’s assumed to be relative to some arbitrary point in time, and will be encoded as relative to “now”. Otherwise, the time is assumed to be an Unix timestamp, and encoded as time since Unix epoch. See also: RFC 8428, “Requirements and Design Goals”

Parameters:

  • builder – Pointer to batch builder

  • oid – Object ID, MUST NOT be UINT16_MAX

  • iid – Instance ID, MUST NOT be UINT16_MAX

  • rid – Resource ID, MUST NOT be UINT16_MAX

  • riid – Resource Instance ID, UINT16_MAX for no RIID

  • timestamp – Time related to bytes being send (e.g. when the measurement corresponding to the passed bytes was made)

  • data – Pointer to data. No longer required by batch builder after call to this function, because internal copy is made. Can be NULL only if length is 0.

  • length – Length of data in bytes.

Returns:

0 on success, negative value otherwise. In case of failure, the builder is left unchanged.