ReferenceAPIsRust Library Referencenemo-relay-ffiapi

Function nemo_relay_event

View as Markdown

Generated from cargo doc --no-deps -p nemo-relay -p nemo-relay-adaptive -p nemo-relay-ffi.

#[unsafe(no_mangle)]pub unsafe extern "C" fn nemo_relay_event(
    name: *const c_char,
    parent: *const FfiScopeHandle,
    data_json: *const c_char,
    metadata_json: *const c_char,
    timestamp_unix_micros: *const i64,
) -> NemoRelayStatus

Emit a named lifecycle event.

This creates a point-in-time Mark event without pushing or popping a scope.

Parameters

  • name: Null-terminated event name.
  • parent: Optional parent scope handle, or null to use the current top of stack.
  • data_json: Optional null-terminated JSON data payload recorded on the mark event, or null.
  • metadata_json: Optional null-terminated JSON metadata payload recorded on the mark event, or null.
  • timestamp_unix_micros: Optional Unix microseconds timestamp for the mark event, or null to use the current UTC time.

Errors

Returns InvalidJson for invalid JSON inputs and InvalidArg when timestamp_unix_micros is outside the supported timestamp range.

Safety

name must be a valid C string. Other pointer args may be null; when non-null, optional pointers must be valid for reads for the duration of the call.