11.1 append()

anyalue append
(
      anyvalue ListValue  input,
      anyvalue NewValue   input
  { , integer  Count := 1 input }
  { , enum     Dir   := dir_row input }
)

Parameter

anyvalue ListValue input

In diesem Parameter wird die Sammlung bzw. der String angegeben an die ein Wert angehängt werden soll.

anyvalue NewValue input

Dieser Parameter definiert den neu anzufügenden Wert. Der Wert muss zum Wertetyp der Sammlung passen.

integer Count := 1 input

In diesem optionalen Parameter wird die Anzahl angegeben, wie oft ein neuer Wert (bzw. wie viele Zeilen oder Spalten) angehängt werden soll. Erlaubt sind Werte >= 0, wobei bei 0 kein Anhängen erfolgt. Standardmäßig wird der neue Wert einmal angehängt.

enum Dir := dir_row input

In diesem optionalen Parameter wird für Sammlungen vom Datentyp matrix definiert, ob neue Zeilen (dir_row) oder neue Spalten (dir_column) angehängt werden.

Rückgabewert

Die Funktion gibt die veränderte Sammlung bzw. den veränderten String zurück.

Besonderheiten

• hash

  Da dieser Sammlungsdatentyp keinen definierten Indexbereich besitzt, erfolgt das Anhängen hinter dem letzten integer-Index. Es wird also von einem hash mit einer Indizierung von 1,2,3… ausgegangen. Der letzte gesetzte Index vom Datentyp integer wird ermittelt und daran anschließend angehängt.

• matrix

  Das Anhängen in eine Matrix erfolgt immer zeilen- oder spaltenweise. Die Steuerung erfolgt über den Dir-Parameter. Standardmäßig (dir_row) werden neue Zeilen angefügt. Bei Angabe von dir_column werden neue Spalten angefügt.

• refvec

  Das Anhängen von null-Objekten ist nicht erlaubt. Falls die Objekt-Id schon vorhanden ist, erfolgt ein Umpositionieren an die letzte Position.

• string

  Der neue Wert wird am String-Ende angefügt.

• Default-Werte

  Um die Indexposition für die neuen Werte zu ermitteln werden auch Default-Werte beachtet, außer es handelt sich um eine hash-Sammlung.

Beispiele

• Mehrfaches Anhängen an einen String

  print append("hi", " ho", 3);

  Ausgabe

  "hi ho ho ho"

• Mehrfaches Anfügen an eine list-Sammlung

  variable list L := [4711, "koeln"];
  print append(L, true, 2);

  Ausgabe

  [4711,"koeln",true,true]

• Anfügen von zwei Zeilen an eine Matrix

  variable matrix M := [ [0,0]=>"?", [1,1]=>"a", [1,2]=>"b",
                         [2,2]=>"c", [3,1]=>"end" ];
  print append(M, "new", 2);

  Ausgabe

  [[1,1]=>"a",[1,2]=>"b",[2,1]=>"?",[2,2]=>"c",[3,1]=>"end",[3,2]=>"?",
  [4,1]=>"new",[4,2]=>"new",[5,1]=>"new",[5,2]=>"new"]

• Anfügen an einen Hash mit gemischter Indizierung

  variable hash H := [false=>.xleft, 31=>.width, 33=>.ytop, "x"=>1];
  print append(H, .height);

  Ausgabe

  [false=>.xleft,31=>.width,33=>.ytop,34=>.height,"x"=>1]

• Anhängen an eine vector-Liste

  variable vector[integer] V := [9, 8, 7];
  print append(V, 6);

  Ausgabe

  [9,8,7,6]

Verfügbarkeit

Ab IDM-Version A.06.02.g

Siehe auch

Eingebaute Funktion insert()