These docs are for v2.0. Click to read the latest docs for v3.0.

Write an integer to the XRPLD trace log

Behaviour

  • Write an integer to the trace log along with a message (if any)

Definition

int64_t trace_num (
    uint32_t mread_ptr,
    uint32_t mread_len,
  	int64_t number 
);

Example

#define SBUF(str) (uint32_t)(str), sizeof(str)
trace_num(SBUF("This is an integer"), 10);

Parameters

NameTypeDescription
rmead_ptruint32_tPointer to a message to output before the hex-encoded serialized object found in the slot. May be null.
mread_lenuint32_tLength of the message. May be null.
numberint64_tThe number.

Return Code

TypeDescription
int64_t0 if successful

If negative, an error:
OUT_OF_BOUNDS
- pointers/lengths specified outside of hook memory.