slot_subarray

Comportamento

C

• Procura o array no slot parent_slot
• Recupera o sub-objeto no índice especificado em array_id
• Coloca o sub-objeto no slot new_slot ou no próximo slot disponível, caso new_slot seja 0.
• Retorna o novo número de slot.

JavaScript

• Cria um subarray no slot pai especificado.
• Retorna um código de erro ou o resultado da criação do subarray.

Definição

C

int64_t slot_subarray (
    uint32_t parent_slot,
    uint32_t array_id,
    uint32_t new_slot
);

JavaScript

function slot_subarray(
    parent_slotno: number,
    array_id: number,
    new_slotno: number
  ): ErrorCode | number

Exemplo

C

int64_t subslot = 0;
subslot =
    slot_subarray(slot_no, i, (uint32_t)subslot);

JavaScript

let subslot = 0
subslot = slot_subarray(slot_no, i, subslot)

Parâmetros

C

Nome	Tipo	Descrição
parent_slot	uint32_t	Slot em que o array pai está
array_id	uint32_t	O código sf do campo que você está procurando. Para calcular isso manualmente, pegue o type serializado e desloque-o para os 16 bits mais altos de uint32_t, depois pegue o field e coloque-o nos 16 bits mais baixos. Por exemplo: sfEmitNonce tem type 5 e field 11, portanto seu valor é 0x050BU
new_slot	uint32_t	Novo número de slot no qual colocar o objeto do índice de array selecionado. Se nulo, escolhe o próximo slot disponível. Pode ser nulo.

JavaScript

Nome	Tipo	Descrição
parent_slotno	number	O número do slot pai.
array_id	number	O ID do array para o qual criar um subarray.
new_slotno	number	O novo número de slot para o subarray.

Código de Retorno

C

Tipo	Descrição
int64_t	O número do slot do objeto recém-alocado Se negativo, um erro: DOESNT_EXIST - O array_id especificado não existe no array apontado por parent_slot NO_FREE_SLOTS - A API exigiria a alocação de um novo slot, mas o Hook já está no número máximo de slots. NOT_AN_ARRAY - O parent_slot especificado não contém um STArray.

JavaScript

Tipo	Descrição
number	Retorna um código de erro ou o resultado da criação do subarray.