trace

Comportamiento

• Escribe un buffer desde el Hook en el log de trazas junto con un mensaje (si se proporciona)

Definición

C

int64_t trace (
    uint32_t mread_ptr,
    uint32_t mread_len,
    uint32_t dread_ptr,
    uint32_t dread_len,
    uint32_t as_hex
);

JavaScript

function trace(
    message: string | null,
    data: any,
    hex: boolean | 0 | 1
  ): ErrorCode

Ejemplo

C

#define SBUF(str) (uint32_t)(str), sizeof(str)
trace(SBUF("Contenido del buffer"), SBUF(some_buffer), 1);

JavaScript

trace("Contenido del buffer", some_buffer, 1);

Parámetros

C

Nombre	Tipo	Descripción
mread_ptr	uint32_t	Puntero a un mensaje a mostrar antes del buffer. Puede ser null.
mread_len	uint32_t	Longitud del mensaje. Puede ser null.
dread_ptr	uint32_t	Puntero al buffer a mostrar
dread_len	uint32_t	Longitud del buffer
as_hex	uint32_t	Si es 1 muestra el buffer en hexadecimal. Si es 0 lo muestra en UTF-8.

JavaScript

Nombre	Tipo	Descripción
message	string	Mensaje (clave de log) a mostrar antes del buffer (puede ser null)
data	any	Datos a registrar
hex	boolean	¿Mostrar en HEX? 0 - NO 1 - SÍ

Código de retorno

C

Tipo	Descripción
int64_t	0 si tiene éxito Si es negativo, error: OUT_OF_BOUNDS - punteros fuera de la memoria del hook.

JavaScript

Tipo	Descripción
ErrorCode	int64_t, valor 0 si tiene éxito Si es negativo, error: OUT_OF_BOUNDS