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.

Beschreibung:

Als Quelle text_or_list wird ein Text oder eine Liste von Texten erwartet. Alle Texte werden in einen HTTP-Query-Text gewandelt, so dass dieser z.B. als Parameter eine URI ergänzen kann.

Die Umwandlung geschieht unter Berücksichtigung der mode_bits nach den folgenden Regeln:

Leerzeichen werden in Plusszeichen ('+') gewandelt.

_CONV_HASH
Ist Bit _CONV_HASH in flags gesetzt, dann werden alle Nummernzeichen ('#') in '%23' gewandelt. Dieses Bit ist in _CONV_QUERY_STD enthalten, weil es eine übliche Umwandlung ist.

_CONV_PERCENT
Ist Bit _CONV_PERCENT in flags gesetzt, dann werden alle Prozentzeichen ('%') in '%25' gewandelt. Dieses Bit ist in _CONV_QUERY_STD enthalten, weil es eine übliche Umwandlung ist.

_CONV_AMP
Ist Bit _CONV_AMP in flags gesetzt, dann werden alle Kaufmansunds ('&') in '%26' gewandelt. Dieses Bit ist in _CONV_QUERY_STD enthalten, weil es eine übliche Umwandlung ist.

_CONV_PLUS
Ist Bit _CONV_PLUS in flags gesetzt, dann werden alle Plusszeichen ('+') in '%2b' gewandelt. Dieses Bit ist in _CONV_QUERY_STD enthalten, weil es eine übliche Umwandlung ist.

_CONV_SLASH
Ist Bit _CONV_SLASH in flags gesetzt, dann werden alle Schrägstriche ('/') in '%2f' gewandelt.
Diese Umwandlung ist nicht notwendig um einen korrekten Query-String zu generieren.

_CONV_QMARK
Ist Bit _CONV_QMARK in flags gesetzt, dann werden alle Fragezeichen ('?') in '%3f' gewandelt.
Diese Umwandlung ist nicht notwendig um einen korrekten Query-String zu generieren.

_CONV_CONTROL
Ist Bit _CONV_CONTROL in flags gesetzt, dann werden alle Zeichen <32 in eine Sequenz gemäß '%xx' gewandelt. Dieses Bit ist in _CONV_QUERY_STD enthalten, weil es eine übliche Umwandlung ist.

_CONV_SPECIAL
Ist Bit _CONV_SPECIAL in flags gesetzt, dann werden alle Zeichen >=128 in eine Sequenz gemäß '%xx' gewandelt. Dieses Bit ist in _CONV_QUERY_STD enthalten, weil es eine übliche Umwandlung ist.

Die beiden folgenden Flags sind Kombinationen aus den oben genannten:

_CONV_QUERY_STD := _CONV_AMP | _CONV_PERCENT | _CONV_HASH | _CONV_PLUS | _CONV_SPECIAL | _CONV_CONTROL
In _CONV_QUERY_STD sind alle oben genannten Bits mit Ausnahme von _CONV_SLASH und _CONV_QMARK gesetzt. Diese Bit repräsentieren den übliche Umwandlungs-Modus.

_CONV_QUERY_ALL := _CONV_QUERY_STD | _CONV_SLASH | _CONV_QMARK
In _CONV_QUERY_ALL sind alle oben genannten Bits und damit alle relevanten Bits gesetzt.

Funktionsergebnis: STRING/LIST

Als Funktionsergebnis wird die umgewandelte Zeichenkette bzw. die Liste mit den umgewandelten Zeichenketten geliefert.

Siehe auch:
query2text() text2xml()

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