Funzione DSA_InsertItem (dpa_dsa.h)

[DSA_InsertItem è disponibile per l'uso nel funzionamento

sistemi specificati nella sezione Requisiti. Può essere modificato o non disponibile in

versioni successive.]

Inserisce un nuovo elemento in una matrice di struttura dinamica (DSA). Se necessario, DSA espande per ospitare il nuovo elemento.

Sintassi

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

Parametri

[in] hdsa

Tipo: HDSA

Handle per DSA in cui inserire l'elemento.

[in] i

Tipo: int

Posizione nella DSA in cui deve essere inserito un nuovo elemento o DSA_APPEND per inserire l'elemento alla fine della matrice.

[in] pitem

Tipo: void*

Puntatore all'elemento da inserire.

Valore restituito

Tipo: int

Restituisce l'indice del nuovo elemento se l'inserimento ha esito positivo o DSA_ERR (-1) se l'inserimento ha esito negativo.

Commenti

I dati effettivi a cui fa riferimento pItem sono copiati in DSA. Le azioni successive eseguite su tale elemento non influiscono sulla copia originale.

Requisiti