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.

mode_bits

Ein Ganzzahl, die als Bitfeld interpretiert wird und die die Umwandlung steuert. Ohne Angabe wird _TRIM_STD verwendet.

Beschreibung:

Der Parameter mode_bits enthält Optionen, die die Ausführung bestimmen. Ist das Flag _TRIM_UNICODE gesetzt, dann wird die Quelle als UTF-8-Zeichenkette anstatt als ANSI-Zeichenkette interpretiert. Ungültige UTF-8-Zeichen werden jedoch immer als ANSI-Zeichen interpretiert.

Diese Funktion arbeitet in den folgenden logischen Schritten (Logisch deshalb, weil alles in einem Durchgang durchgeführt wird):

_TRIM_UNICODE
Ist das Flag _TRIM_UNICODE gesetzt, dann wird die Quelle als UTF-8-Zeichenkette interpretiert. Ungültige UTF-8 werden ersatzweise als ANSI-Zeichen interpretiert.
Zuerst werden alle Steuerzeichen (ASCII Kodes 0..31) in Leerzeichen gewandelt. Ist das Flag _TRIM_UNICODE gesetzt, dann werden zusätzlich alle Unicode-Leerzeichen und Unicode-Steuerzeichen in Leerzeichen gewandelt.

_TRIM_BEGIN
Ist die Option _TRIM_BEGIN gesetzt, dann werden alle Leerzeichen am Anfang gelöscht.

_TRIM_END := 0
Ist die Option _TRIM_END gesetzt, dann werden alle Leerzeichen am Ende gelöscht.

_TRIM_MULTI
Ist die Option _TRIM_MULTI gesetzt, dann werden alle mehrfachen Leerzeichen durch ein einziges Leerzeichen ersetzt.

_TRIM_STRING
Innerhalb von Hochkommata (') oder Anführungszeichen (") eingeschlossene Teil-Zeichenketten werden normalerweise von der Ersetzung ausgeschlossen. Durch die Option _TRIM_STRING werden aber auch innerhalb dieser Teil-Zeichenketten mehrfache Leerzeichen durch ein einziges Leerzeichen ersetzt.

Es existieren noch weitere Optionen, die eine Kombination der obigen sind:

_TRIM_BOTH := _TRIM_BEGIN | _TRIM_END
_TRIM_BOTH ist eine Abkürzung von _TRIM_BEGIN|_TRIM_END.

_TRIM_STD := _TRIM_BEGIN | _TRIM_END | _TRIM_MULTI
_TRIM_STD ist eine Abkürzung von _TRIM_BEGIN|_TRIM_END|_TRIM_MULTI.

_TRIM_STD_STRING := _TRIM_STD | _TRIM_STRING
_TRIM_STD_STRING ist eine Abkürzung von _TRIM_STD|_TRIM_STRING.

In dem folgenden Beispielen werden Leerzeichen durch Punkte ('.') dagestellt:

Beispiele
mode_bits	Quelle	Ergebnis
_TRIM_BEGIN	..a..b..c..	a..b..c..
_TRIM_END	..a..b..c..	..a..b..c
_TRIM_MULTI	..a..b..c..	.a.b.c.
_TRIM_BEGIN\|_TRIM_END	..a..b..c..	a..b..c
_TRIM_BOTH	..a..b..c..	a..b..c
_TRIM_BOTH\|_TRIM_MULTI	..a..b..c..	a.b.c

_TRIM_STD	..a..'..b..c..'..d..	a.'..b..c..'.d
_TRIM_STD_STRING	..a..'..b..c..'..d..	a.'.b.c.'.d

_TRIM_STD	..a.."..b..c.."..d..	a."..b..c..".d
_TRIM_STD_STRING	..a.."..b..c.."..d..	a.".b.c.".d

Funktionsergebnis: STRING/LIST

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

Siehe auch:
indent() expand()

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()	—