Função DSA_InsertItem (dpa_dsa.h)

[DSA_InsertItem está disponível para uso na operação

sistemas especificados na seção Requisitos. Ele pode estar alterado ou indisponível no

versões subsequentes.]

Insere um novo item em uma DSA (matriz de estrutura dinâmica). Se necessário, a DSA se expande para acomodar o novo item.

Sintaxe

int DSA_InsertItem(
  [in] HDSA       hdsa,
  [in] int        i,
  [in] const void *pitem
);

Parâmetros

[in] hdsa

Tipo: HDSA

Um identificador para o DSA no qual inserir o item.

[in] i

Tipo: int

A posição na DSA em que o novo item deve ser inserido ou DSA_APPEND inserir o item no final da matriz.

[in] pitem

Tipo: void*

Um ponteiro para o item que deve ser inserido.

Retornar valor

Tipo: int

Retorna o índice do novo item se a inserção for bem-sucedida ou DSA_ERR (-1) se a inserção falhar.

Comentários

Os dados reais apontados por pItem são copiados para a DSA. As ações subsequentes executadas nesse item não afetam a cópia original.

Requisitos