otxn_param

Comportamento

C

• Procura o valor de um parâmetro nomeado especificado em read_ptr na transação de origem.
• Escreve o valor do parâmetro em write_ptr

JavaScript

• Procura o valor de um parâmetro nomeado especificado na transação de origem.
• Retorna o valor do parâmetro especificado, ou um ErrorCode caso a busca falhe.

Definição

C

int64_t otxn_param (
    uint32_t write_ptr,
    uint32_t write_len,
    uint32_t read_ptr,
    uint32_t read_len
);

JavaScript

function otxn_param(name: ByteArray | HexString): ErrorCode | ByteArray

Exemplo

C

uint8_t pname[] = {0xCAU, 0xFEU};
uint8_t pvalue[32];
int64_t value_len =
    otxn_param(pvalue, 32, pname, 2);

JavaScript

const pname = [0xCA, 0xFE]
const pvalue = otxn_param(pname)

Parâmetros

C

Nome	Tipo	Descrição
write_ptr	uint32_t	Ponteiro para um buffer de tamanho adequado para armazenar a saída. Deve ter pelo menos 32 bytes.
write_len	uint32_t	Tamanho do buffer de saída.
read_ptr	uint32_t	Ponteiro para um buffer contendo o nome do parâmetro
read_len	uint32_t	Tamanho do nome do parâmetro

JavaScript

Nome	Tipo	Descrição
name	ByteArray | HexString	O nome do parâmetro a ser procurado, especificado como um ByteArray ou string.

Código de Retorno

C

Tipo	Descrição
int64_t	O número de bytes escritos Se negativo, um erro: OUT_OF_BOUNDS - ponteiros/tamanhos especificados fora da memória do hook. DOESNT_EXIST - O parâmetro especificado não existe ou é nulo TOO_SMALL - O nome do parâmetro não pode ser nulo TOO_BIG - O nome do parâmetro tem mais de 32 bytes

JavaScript

Tipo	Descrição
ErrorCode | ByteArray	Retorna o valor do parâmetro especificado, ou um ErrorCode caso a busca falhe.