ArrayAdd

value ArrayAdd ( array BYREF arrVar, value dValue, value LimitToSize = -1, value OnLimitReached = ARRAYADD_DoNotAdd );

Rückgabewert

Rückgabewert	Beschreibung
TRUE, true, 1	Der Befehl wurde ausgeführt.
FALSE, false, 0	Der übergebene Parameter arrVar ist kein Array.

Parameter

arrVar

Das Zielarray, dem ein Element hinzugefügt werden soll.

dValue

Der Wert, der dem Zielarray arrVar hinzugefügt werden soll.

LimitToSize

Die maximale Arraygröße die beim Hinzufügen eingehaltet werden soll. Bei einem Wert < 0 wird keine Begrenzung vorgenommen, sodass das Array endlos wächst.

OnLimitReached

Gibt an wie Verfahren werden soll, wenn das Hinzufügen des Werts dValue die maximale Größe LimitToSize des Arrays überschreiten würde.

OnLimitReached	Beschreibung
ARRAYADD_DoNotAdd	Wird die Grenze LimitToSize mit dem Hinzufügen des Wertes dValue überschritten, so wird der Wert nicht hinzugefügt.
ARRAYADD_DeleteFirst	Wird die Grenze LimitToSize mit dem Hinzufügen des Wertes dValue überschritten, so wird das erste Arrayelement gelöscht und dann der Wert hinzugefügt. Es entsteht ein Quasi-Ringspeicher.

 

Bemerkungen

Fügt ein neues Element dValue an das Ende des Zielarray arrVar an. Das Array wächst um ein Element, wenn keine Begrenzung LimitToSize angegeben wurde.

Beispiel

//Fügt dem Array arrMeasurements den Wert Temperature hinzu 
array arrMeasurements;
value Temperature = 41.3;
ArrayAdd (arrMeasurements,Temperature);

//Fügt dem Array arrMeasurements den Wert Temperature hinzu
//Wird die Arraylänge größer als 10, wird das erste Element gelöscht und dann der Wert angefügt
//Danach wird der arithmetische Mittelwert aus dem Array gebildet
array arrMeasurements;
value MeanValue, Temperature = 52.9;
ArrayAdd (arrMeasurements,Temperature, 10, ARRAYADD_DeleteFirst);
ArrayArithmeticMean (arrMeasurements, MeanValue);

Array Funktionen

Siehe auch ArrayFromString, ArrayInsertAt, ArraySetAt, ArraySetAtGrow