11.6 concat()

Die Funktion concat() verkettet mehrere Strings zu einem String. Bei der Verkettung kann eine Trennzeichenfolge zwischen den Strings eingefügt werden oder die Strings können wiederholt aneinander gehängt werden.

Definition

Wenn der erste Parameter ein String ist, wird dieser String immer zwischen zwei zu verkettenden Strings eingefügt.

string concat
(
      string   Separator input,
      anyvalue Value1    input
  { , anyvalue Value2    input
  ...
  { , anyvalue Value15   input } }
)

Ist der erste Parameter ein integer-Wert, dann definiert er, wie oft die Verkettung der Strings wiederholt wird.

string concat
(
      integer  Repeat  input,
      anyvalue Value1  input
  { , anyvalue Value2  input
  ...
  { , anyvalue Value15 input } }
)

Parameter

string Separator input

Dieser Parameter enthält eine Trennzeichenfolge, die bei der Verkettung zwischen zwei Strings eingefügt wird.

Separator kann nicht zusammen mit Repeat verwendet werden.

integer Repeat input

Dieser Parameter definiert, wie oft die Verkettung der Strings wiederholt werden soll. Zunächst wird ein String aus den übergebenen Value-Parametern gebildet, anschließend wird der gebildete String so oft aneinander gehängt, wie in Repeat angegeben. Ist Repeat <= 0, wird ein Leerstring zurückgegeben.

Repeat kann nicht zusammen mit Separator verwendet werden.

anyvalue Value1 input
anyvalue Value2 input
…
anyvalue Value15 input

In diesen (optionalen) Parametern werden die Werte übergeben, die zu einem String verkettet werden sollen.

Skalare Werte werden für die Verkettung zu Strings gewandelt. Enthalten die Parameter Sammlungen, dann werden zunächst die darin enthaltenen Werte (ohne Defaultwerte) verkettet und anschließend die Parameter miteinander verkettet. Die Vorgehensweise entspricht einem Aufruf von sprintf("%s", <Value>).

Rückgabewert

String in dem die übergebenen Werte verkettet sind.

Beispiele