DSA_InsertItem-Funktion (dpa_dsa.h)

[DSA_InsertItem für die Verwendung im Betrieb verfügbar ist

Systeme, die im Abschnitt Anforderungen angegeben sind. Er kann in geändert oder nicht verfügbar sein.

nachfolgende Versionen.]

Fügt ein neues Element in ein dynamisches Strukturarray (DSA) ein. Bei Bedarf wird die DSA erweitert, um das neue Element aufzunehmen.

Syntax

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

Parameter

[in] hdsa

Typ: HDSA

Ein Handle für den DSA, in den das Element eingefügt werden soll.

[in] i

Typ: int

Die Position in der DSA, an der ein neues Element eingefügt werden soll, oder DSA_APPEND, um das Element am Ende des Arrays einzufügen.

[in] pitem

Typ: void*

Ein Zeiger auf das Element, das eingefügt werden soll.

Rückgabewert

Typ: int

Gibt den Index des neuen Elements zurück, wenn die Einfügung erfolgreich ist, oder DSA_ERR (-1), wenn die Einfügung fehlschlägt.

Hinweise

Die tatsächlichen Daten, auf die von pItem verwiesen wird, werden in die DSA kopiert. Nachfolgende Aktionen, die für dieses Element ausgeführt werden, wirken sich nicht auf die ursprüngliche Kopie aus.

Anforderungen