trace

Comportamento

• Escreve um buffer de dentro do Hook no log de trace junto com uma mensagem (se houver)

Definição

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

Exemplo

C

#define SBUF(str) (uint32_t)(str), sizeof(str)
trace(SBUF("Buffer conatained"), SBUF(some_buffer), 1);

JavaScript

trace("Buffer conatained", some_buffer, 1);

Parâmetros

C

Nome	Tipo	Descrição
mread_ptr	uint32_t	Ponteiro para uma mensagem a ser exibida antes do buffer. Pode ser nulo.
mread_len	uint32_t	Tamanho da mensagem. Pode ser nulo.
dread_ptr	uint32_t	Ponteiro para o buffer a ser exibido.
dread_len	uint32_t	Tamanho do buffer a ser exibido.
as_hex	uint32_t	Se 1, exibe o buffer em hexadecimal. Se 0, exibe o buffer em utf-8.

JavaScript

Nome	Tipo	Descrição
message	string	A ‘chave de log’, mensagem a ser exibida antes do buffer (pode ser nula)
data	any	Os dados a serem registrados
hex	boolean	Deve ser registrado formatado em HEX? 0 - NÃO 1 - SIM

Código de Retorno

C

Tipo	Descrição
int64_t	0 se for bem-sucedido Se negativo, um erro: OUT_OF_BOUNDS - ponteiros/tamanhos especificados fora da memória do hook.

JavaScript

Tipo	Descrição
ErrorCode	int64_t, o valor é 0 se for bem-sucedido Se negativo, um erro: OUT_OF_BOUNDS