add_element() (Funktion)
Die Funktion add_element() hängt an das Ende eines Arrays ein Array-Element an und weist dem Element einen Wert zu.
Syntax
Die Syntax der Funktion add_element() hat folgende Formate, je ein Format pro Datentyp:
array = add_element(array input, varchar value [, varchar name])
array = add_element(array input, varchar value [, nvarchar name])
array = add_element(array input, nvarchar value [, varchar name])
array = add_element(array input, nvarchar value [, nvarchar name])
array = add_element(array input, int1 value [, varchar name])
array = add_element(array input, int1 value [, nvarchar name])
array = add_element(array input, int2 value [, varchar name])
array = add_element(array input, int2 value [, nvarchar name])
array = add_element(array input, int4 value [, varchar name])
array = add_element(array input, int4 value [, nvarchar name])
array = add_element(array input, int8 value [, varchar name])
array = add_element(array input, int8 value [, nvarchar name])
array = add_element(array input, date value [, varchar name])
array = add_element(array input, date value [, nvarchar name])
array = add_element(array input, double value [, varchar name])
array = add_element(array input, double value [, nvarchar name])
array = add_element(array input, time value [, varchar name])
array = add_element(array input, time value [, nvarchar name])
array = add_element(array input, timetz value [, varchar name])
array = add_element(array input, timetz value [, nvarchar name])
array = add_element(array input, timestamp value [, varchar name]);
array = add_element(array input, timestamp value [, nvarchar name]);
Der Wert " input gibt das Array an, an das das Element angehängt werden soll.
Der Wert " value gibt den Wert an, der in dem neuen Array-Element gespeichert werden soll.
Der optionale Wert ' name ' gibt den Namen des anzuhängenden Array-Elements an.
Rückgabe
Die Funktion hängt ein neues Element mit einem Wert an.Beispiel
Die folgende Funktion hängt ein Element an das Ende des Arrays 'my_array' an und speichert den Wert '45' in diesem Element:
add_element(my_array, 45)