slot_subfield

Comportamento

C

• Procura o objeto no slot parent_slot
• Recupera o sub-objeto em field_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 subcampo no slot pai especificado.
• Retorna um código de erro ou o resultado da criação do subcampo.

Definição

C

int64_t slot_subfield (
    uint32_t parent_slot,
    uint32_t field_id,
    uint32_t new_slot
);

JavaScript

function slot_subfield(
    parent_slotno: number,
    field_id: number,
    new_slotno: number
  ): ErrorCode | number

Exemplo

C

int64_t amt_slot =
    slot_subfield(oslot, sfAmount, 0);

JavaScript

const amt_slot = slot_subfield(oslot, sfAmount, 0)

Parâmetros

C

Nome	Tipo	Descrição
parent_slot	uint32_t	Slot em que o objeto pai está
field_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 campo 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.
field_id	number	O ID do campo para o qual criar um subcampo.
new_slotno	number	O novo número de slot para o subcampo.

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 campo procurado não está presente no slot pai ou o slot pai está vazio. 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. INVALID_FIELD - O campo especificado não é um campo sf válido. NOT_AN_OBJECT - O objeto alocado no slot não é um STObject válido.

JavaScript

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