text_or_list	Dieses ist der Text, der erweitert werden soll. Handelt es sich bei text_or_list um eine Liste, dann wird jedes Listenelement mittels string() in eine Zeichenkette gewandelt. Für jede einzelne dieser Zeichenketten wird die folgende Operation ausgeführt. Anderenfalls (keine Liste) wird dieser Parameter zwangsweise mittels string() in eine Zeichenkette gewandelt.
new_len	Die geforderte Länge der neuen Zeichenkette. Dieser Parameter wird zwangsweise mittels int32() in eine 32-Bit Ganzzahl gewandelt.
expand_text	Der Text, mit dem text erweitert werden soll. Dieser Parameter wird zwangsweise mittels string() in eine Zeichenkette gewandelt.
mode_bits	Ein Bitmaske mit Optionen, die die Ausführung steeurn. Dieser Parameter wird zwangsweise mittels int32() in eine 32-Bit Ganzzahl gewandelt. Ohne Angabe wird der Wert _EXP_RIGHT verwendet.

Beschreibung:

Aus Kompatibilität zur alten Implementierung von expand() sind negative Werte für new_len erlaubt:

Sollte new_len<0 sein, dann wird das Bit _EXP_TRUNCATE im Parameter mode_bits gesetzt und für den weiteren Verlauf gilt: new_len := abs(new_len).

Die Zeichenkette text wird auf die Länge new_len erweitert. Ist jedoch new_len<length(text), dann bleibt je nach Option text unverändert oder wird auf eine Länge von new_len gekürzt.

Bei einer Erweiterung wird mehrfach das Muster expand_text verwendet. Durch die Bitmaske mode_bits wird die Art und Weise des Auffüllens festgelegt. Dazu kännen die folgenden Werte ODER verknüpft werden:

_EXP_LEFT
Diese Option legt fest, dass die Erweiterung der Zeichenkette text auf der linken Seite vor dem ersten Zeichen stattfindet. Sollten sowohl das Bit _EXP_LEFT als auch das Bit _EXP_RIGHT gesetzt sein oder sollte keines von beiden Bits gesetzt sein, dann werden beide Seiten erweitert.
_EXP_RIGHT
Diese Option legt fest, dass die Erweiterung der Zeichenkette auf der rechten Seite nach dem letzten Zeichen stattfindet. Sollten sowohl das Bit _EXP_LEFT als auch das Bit _EXP_RIGHT gesetzt sein oder sollte keines von beiden Bits gesetzt sein, dann werden beide Seiten erweitert.
_EXP_BOTH := _EXP_LEFT | _EXP_RIGHT
_EXP_BOTH ist eine Abkürzung für die Kombination _EXP_LEFT|_EXP_RIGHT.
_EXP_WHOLE
Normalerweise wird das Muster expand_text wird so häufig wie möglich verwendet um die Zeichenkette aufzufüllen. Dabei wird am Ende auch ein Teilstück von expand_text verwendet.
Ist jedoch _EXP_WHOLE oder _EXP_FILL gesetzt, dann wird expand_text nur im ganzen verwendet und ggf. Leerzeichen am Anfang und am Ende eingefügt.
_EXP_FILL
_EXP_FILL ist eine Erweiterung zu _EXP_WHOLE: Ist _EXP_FILL gesetzt, dann wird expand_text nur im ganzen verwendet und ggf. Leerzeichen eingefügt. Diese Leerzeichen werden gleichmäßig zwischen den Vorkommen von expand_text sowie am Anfang und Ende verteilt.
_EXP_ADJUST
Durch _EXP_ADJUST erscheinen die Kopien von expand_text immer an den gleichen Zeichenketten-Positionen, unabhängig davon, wie lang die Zeichenkette vorher war. _EXP_ADJUST kann auch mit _EXP_FILL kombiniert werden.
Hierdurch erreicht man ein einheitliches Aussehen, wenn mehrere erweiterte Zeilen untereinander dargestellt werden. Auch die Verwenduing von alternierenden Mustern für exp (z.B. '-+' und '+-') erhöht die Ansehnlichkeit.
_EXP_TRUNCATE
Ist die Ausgangs-Zeichenkette länger als die gewünschte Länge, dann bleibt sie im Normalfall inverändert. Ist jedoch das Bit _EXP_TRUNCATE gesetzt, dann wird Ausgangs-Zeichenkette am Ende auf die Wunschlänge gekürzt.

Beispiele
STRING	LEN	EXP	MODE	Ergebnis
Dirk	20	*	_EXP_LEFT\|_EXP_RIGHT	******Dirk******
Clemens	20	*	_EXP_BOTH	****Clemens*****
Clemens	20	*	_EXP_RIGHT	Clemens*************
Clemens	20	*	_EXP_LEFT	*************Clemens

aaa	20	12345	_EXP_BOTH	12345123aaa123451234
aaa	20	12345	_EXP_BOTH\|_EXP_WHOLE	12345 aaa12345
aaaaa	20	12345	_EXP_BOTH	1234512aaaaa12345123
aaaaa	20	12345	_EXP_BOTH\|_EXP_WHOLE	12345 aaaaa12345

a	20	1234	_EXP_BOTH\|_EXP_WHOLE	12341234 a12341234
a	20	1234	_EXP_BOTH\|_EXP_WHOLE\|_EXP_FILL	1234 1234a 12341234

a	20	12345	_EXP_RIGHT\|_EXP_ADJUST	a2345123451234512345
aaa	20	12345	_EXP_RIGHT\|_EXP_ADJUST	aaa45123451234512345
aaaaa	20	12345	_EXP_RIGHT\|_EXP_ADJUST	aaaaa123451234512345
aaaaaaa	20	12345	_EXP_RIGHT\|_EXP_ADJUST	aaaaaaa3451234512345
aaaaaaaaa	20	12345	_EXP_RIGHT\|_EXP_ADJUST	aaaaaaaaa51234512345

1234567890	5	xxxxx	_EXP_BOTH	1234567890
1234567890	5	xxxxx	_EXP_BOTH\|_EXP_TRUNCATE	12345

Funktionsergebnis: STRING/LIST

Als Funktionsergebnis wird die modifizierte Zeichenkette bzw. die Liste mit den modifizierten Zeichenketten geliefert.

Weitere ähnliche Funktionen:

Zeichenketten, Transformation
Funktion	Kurzinfo
ansi2dos()	—
breakIntoLines()	—
capitals()	Den ersten Buchstabe jedes Wortes in einen Großbuchstaben und alle anderen Buchstaben in Kleinbuchstaben wandeln.
char()	—
charMB()	—
chgCase()	Alle Kleinbuchstaben in Großbuchstaben und umgekehrt wandeln.
decode64()	—
dos2ansi()	—
encode64()	—
endian()	Eine Ganzzahl wird in bzw. aus einer Zeichenkette mit angegebener Endian-Folge gewandelt.
expand()	Eine Zeichenkette auf eine festgelegte Größe erweitern.
getCoding()	Die Kodiermethode einer Zeichenkette ermittlen oder ersatzweise erraten.
hexDump()	Eine Zeichenkette als Hex-Dump ausgeben.
indent()	—
lower()	Alle Großbuchstaben in Kleinbuchstaben wandeln.
ord()	—
ordMB()	—
query2text()	Einen HTTP-Query-Text in Klartext wandeln.
randomize()	—
recode()	—
reverse()	—
sortString()	—
text2query()	Einen Klartext in einen HTTP-Query-Text wandeln.
text2utf8()	—
text2xml()	Einen Klartext in einem XML/HTML/QUERY-Text wandeln.
translate()	—
trim()	Leer- und Kontrollzeichen aus einer Zeichenkette entfernen.
upper()	Alle Kleinbuchstaben in Großbuchstaben wandeln.
utf82text()	—
xml2text()	—