slot_set

Comportamento

C

• Localiza um objeto a partir do Keylet fornecido em read_ptr
• Posiciona o objeto localizado no slot especificado ou em um novo slot, caso nenhum slot (zero) seja especificado

JavaScript

• Define os dados para o slot especificado.
• Retorna um código de erro ou o resultado da operação de definição.

Definição

C

int64_t slot_set (
    uint32_t read_ptr,
    uint32_t read_len,
    uint32_t slot_no
);

JavaScript

function slot_set(
    kl: ByteArray | HexString,
    slotno: number
  ): ErrorCode | number

Exemplo

C

int64_t slot_no =
  slot_set(keylet, 34, 0);

JavaScript

const slot_no = slot_set(keylet, 0)

Parâmetros

C

Nome	Tipo	Descrição
read_ptr	uint32_t	Ponteiro para um buffer contendo o keylet do objeto a ser localizado. Também pode ser um hash de transação.
read_len	uint32_t	Tamanho do buffer de leitura. Deve ser sempre 32 ou 34.
slot_no	uint32_t	O número do slot no qual posicionar o objeto, ou 0 caso deseje que o próximo disponível seja escolhido.

JavaScript

Nome	Tipo	Descrição
kl	ByteArray | HexString	Os dados a serem definidos no slot, podendo ser um array ou uma string.
slotno	number	O número do slot para o qual definir os dados.

Código de Retorno

C

Tipo	Descrição
int64_t	O número do slot em que o objeto foi inserido Se negativo, um erro: OUT_OF_BOUNDS - ponteiros/tamanhos especificados fora da memória do hook. INVALID_ARGUMENT - read_len deve ser 32 ou 34 bytes, dependendo se um hash de transação ou um keylet está sendo usado em read_ptr - o hash ou keylet era inválido DOESNT_EXIST - o objeto solicitado não foi encontrado

JavaScript

Tipo	Descrição
ErrorCode or number	Retorna um código de erro ou o resultado da operação de definição.