Quelltext der Seite Hilfe:Parserfunktionen/Text

<noinclude>{{Hilfe}}
Diese Hilfeseite zeigt '''[[Hilfe:Parserfunktionen|Parserfunktionen]]''' zur Arbeit mit '''Text''' im Sinne einer [[Zeichenkette]].</noinclude><includeonly>
== Text (Zeichenketten) ==
</includeonly>
<includeonly>=</includeonly>== Wikisyntax ==<includeonly>=</includeonly>
[[Wikisyntax]] kann vor der Auswertung verborgen werden.

Dies sind die einzigen Parserfunktionen mit einem konstanten Ergebnis.

<includeonly>=</includeonly>=== {{Anker|!}} Pipe-Symbol ===<includeonly>=</includeonly>

{| class="wikitable"
|- class="hintergrundfarbe8"
! Funktion
|- class="hintergrundfarbe5"
| <code>!</code>
|-
| Pipe-Symbol <code><nowiki>|</nowiki></code> generieren.
|-
|class="hintergrundfarbe9"| '''Beispiel:''' <code><nowiki>{{!}}</nowiki></code> → <code>{{!}}</code>
|}
Diese Funktion dient dazu, innerhalb der Parameterwerte für Vorlagen und auch Parserfunktionen ein Pipe-Symbol zu verwenden, ohne dass es in der ersten Auswertung als Trenner zwischen Parameterwerten wirkt.
* Im Ergebnis ist es dann syntaktisch wirksam und ein normales Pipe-Symbol. Das wird für die [[Hilfe:Tabellen|Tabellensyntax]] benötigt, falls diese in Parameterwerte einfließen soll.
* Wenn nur die dekorative Wirkung in der Darstellung angestrebt wird, kann auch das [[HTML-Entity]] <code>&amp;#124;</code> verwendet werden.

<includeonly>=</includeonly>=== {{Anker|{{=}}}} Gleichheitszeichen ===<includeonly>=</includeonly>
<!-- 2022-06   Phab:Task=91154   1.39.0-wmf.34 -->
{| class="wikitable"
|- class="hintergrundfarbe8"
! Funktion
|- class="hintergrundfarbe5"
| <code>=</code>
|-
| Gleichheitszeichen <code>=</code> generieren.
|-
|class="hintergrundfarbe9"| '''Beispiel:''' <code><nowiki>{{=}}</nowiki></code> → <code>{{=}}</code>
|}
Diese Funktion dient dazu, innerhalb der Parameterzuweisungen für Vorlagen und auch Parserfunktionen ein Gleichheitszeichen zu verwenden, ohne dass es in der ersten Auswertung als Bezeichner für Parameternamen wirkt.
* Im Ergebnis ist es dann syntaktisch wirksam und ein normales Gleichheitszeichen.
Das Problem tritt insbesondere dann auf, wenn unbenannten Parametern einer Vorlage ein Wert zugewiesen wird, der ein Gleichheitszeichen enthält. Hier gibt es zwei Möglichkeiten:
# Parameternamen voranstellen:<br /> <code style="white-space:nowrap"><nowiki>|1=<span class="hintergrundfarbe8">Überschrift</span></nowiki></code>
# Alle <code>=</code> im Wert einzeln maskieren:<br /> <code style="white-space:nowrap"><nowiki>|<span class{{=}}"hintergrundfarbe8">Überschrift</span></nowiki></code>
Wenn nur die dekorative Wirkung in der Darstellung angestrebt wird, kann auch das [[HTML-Entity]] <code>&amp;#61;</code> verwendet werden.

<includeonly>=</includeonly>== {{Anker|casing}} Groß- und Kleinschreibung ==<includeonly>=</includeonly>

Diese Funktionen wirken auf alle Buchstaben in allen Schriftsystemen, die das Konzept von  Groß- und Kleinbuchstaben kennen.

{| class="wikitable"
|- class="hintergrundfarbe8"
! Funktion !! [[Hilfe:Parserfunktionen#L10N|Lokalisierung]] !! Pflichtparameter
|- class="hintergrundfarbe5"
| <code>lc</code> || <code>klein</code> || ''Textfragment''
|-
|colspan="3"| Alle Buchstaben in Kleinbuchstaben wandeln.
|-
|colspan="3" class="hintergrundfarbe9"| '''Beispiel:''' <code><nowiki>{{lc:CamelCasing}}</nowiki></code> → <code>{{lc:CamelCasing}}</code>
|- class="hintergrundfarbe5"
| <code>lcfirst</code> || <code>initial_klein</code> || ''Textfragment''
|-
|colspan="3"| Ersten Buchstaben in Kleinbuchstaben wandeln.
|-
|colspan="3" class="hintergrundfarbe9"| '''Beispiel:''' <code><nowiki>{{lcfirst:CamelCasing}}</nowiki></code> → <code>{{lcfirst:CamelCasing}}</code>
|- class="hintergrundfarbe5"
| <code>uc</code> || <code>gross</code> || ''Textfragment''
|-
|colspan="3"| Alle Buchstaben in Großbuchstaben wandeln.
|-
|colspan="3" class="hintergrundfarbe9"| '''Beispiel:''' <code><nowiki>{{uc:CamelCasing}}</nowiki></code> → <code>{{uc:CamelCasing}}</code>
|- class="hintergrundfarbe5"
| <code>ucfirst</code> || <code>initial_gross</code> || ''Textfragment''
|-
|colspan="3"| Ersten Buchstaben in Großbuchstaben wandeln.
|-
|colspan="3" class="hintergrundfarbe9"| '''Beispiel:''' <code><nowiki>{{ucfirst:CamelCasing}}</nowiki></code> → <code>{{ucfirst:CamelCasing}}</code>
|}

<includeonly>=</includeonly>== {{Anker|padding}} Ausrichten (padding) ==<includeonly>=</includeonly>

Diese Funktionen ermöglichen das Einfügen von Zeichen, um in einer geeigneten Darstellung ggf. die Ziffer Null oder auch Leerzeichen so einzufügen, dass alle Zeichenketten die vorgegebene Länge erhalten.

{| class="wikitable"
|- class="hintergrundfarbe8"
! Funktion !! [[Hilfe:Parserfunktionen#L10N|Lokalisierung]] !!colspan="3"| Pflichtparameter
|- class="hintergrundfarbe5"
| <code>padleft</code> || <code>füllenlinks</code>
|style="border-right-style:none"| ''Textfragment''
|style="border-left-width:2px; border-left-color:#000000; border-right-style:none;"| ''Länge''
|style="border-left-width:2px; border-left-color:#000000;"| ''Füllzeichen''
|-
|colspan="5"| Linksbündig mit ''Füllzeichen'' auffüllen, bis mindestens ''Länge'' erreicht ist.
|-
|colspan="5" class="hintergrundfarbe9"| '''Beispiel:''' <code><nowiki>{{padleft:1234|6|0}}</nowiki></code> → <code>{{padleft:1234|6|0}}</code>
|- class="hintergrundfarbe5"
| <code>padright</code> || <code>füllenrechts</code>
|style="border-right-style:none"| ''Textfragment''
|style="border-left-width:2px; border-left-color:#000000; border-right-style:none;"| ''Länge''
|style="border-left-width:2px; border-left-color:#000000;"| ''Füllzeichen''
|-
|colspan="5"| Rechtsbündig mit ''Füllzeichen'' auffüllen, bis mindestens ''Länge'' erreicht ist.
|-
|colspan="5" class="hintergrundfarbe9"| '''Beispiel:''' <code><nowiki>{{padright:5,67|6|0}}</nowiki></code> → <code>{{padright:5,67|6|0}}</code>
|}
Als ''Füllzeichen'' können auch mehrere Zeichen angegeben werden; aber die Mindestlänge führt dann ggf. zu unerwarteten Ergebnissen:
* <syntaxhighlight lang="text" inline>"{{padright:Haus|7|&nbsp;}}"</syntaxhighlight> → <code>"{{padright:Haus|7|&nbsp;}}"</code>
Werte kleiner oder gleich Null oder nichtnumerische Angaben für die ''Länge'' und fehlende Textfragmente liefern ggf. seltsame Effekte.

<includeonly>=</includeonly>== {{Anker|plural}} Plural und Singular ==<includeonly>=</includeonly>

{| class="wikitable"
|- class="hintergrundfarbe8"
! Funktion !!colspan="3"| Pflichtparameter
|- class="hintergrundfarbe5"
| <code>plural</code>
|style="border-right-style:none"| ''Anzahl''
|style="border-left-width:2px; border-left-color:#000000; border-right-style:none;"| ''Singularform''
|style="border-left-width:2px; border-left-color:#000000;"| ''Pluralform''
|-
|colspan="4"| Text in grammatikalisch korrekter Schreibung abhängig von der ''Anzahl''.
* Wenn die ''Anzahl'' den Wert <code>1</code> hat, wird die ''Singularform'' zurückgegeben.
* Wenn die ''Anzahl'' mehr als eins liefert, wird die ''Pluralform'' zurückgegeben.
In anderen Projektsprachen kann es weitere sprachbezogen definierte Parameter geben, wenn diese einen [[Paukal]], [[Dual (Grammatik)|Dual]], [[Trial (Grammatik)|Trial]] usw. kennen.
|-
|colspan="4" class="hintergrundfarbe9"| '''Beispiele:'''
* <code><nowiki>{{plural:1|Kuh|Kühe}}</nowiki></code> → <code>{{plural:1|Kuh|Kühe}}</code>
* <code><nowiki>{{plural:5|Kuh|Kühe}}</nowiki></code> → <code>{{plural:5|Kuh|Kühe}}</code>
|}
Wenn die ''Anzahl'' kleiner als eins oder nicht numerisch ist, lässt sich das Verhalten nicht dauerhaft vorhersagen. Es kann die ''Pluralform'' oder „nichts“ resultieren.

Konkurrierend zu dieser Parserfunktion gibt es eine [[Vorlage:Plural|Vorlage gleichen Namens]], die dadurch aktiviert wird, dass der erste Parameter durch <code>|</code> statt <code>:</code> abgetrennt wird:
* <code><nowiki>{{plural|1|Kuh|Kühe}}</nowiki></code> → <code>{{plural|1|Kuh|Kühe}}</code>
* <code><nowiki>{{plural|5|Kuh|Kühe}}</nowiki></code> → <code>{{plural|5|Kuh|Kühe}}</code>
Hier wird die ''Anzahl'' wiederverwendet und mittels eines geschützten Leerzeichens vorangestellt.
* [[Vorlage:Mehrzahl]] wäre allerdings ein glücklicherer Name gewesen und hätte verdeutlicht, dass es sich offenkundig um etwas anderes handelt.

<includeonly>=</includeonly>== {{Anker|gender}} Geschlecht ==<includeonly>=</includeonly>

{| class="wikitable"
|- class="hintergrundfarbe8"
! Funktion !! [[Hilfe:Parserfunktionen#L10N|Lokalisierung]] !!colspan="3"| Pflichtparameter !! Parameter
|- class="hintergrundfarbe5"
| <code>gender</code> || <code>geschlecht</code>
|style="border-right-style:none"| ''Konto''
|style="border-left-width:2px; border-left-color:#000000; border-right-style:none;"| ''Text männlich''
|style="border-left-width:2px; border-left-color:#000000; border-right-style:none;"| ''Text weiblich''
|style="border-left-width:2px; border-left-color:#000000;"| ''Text unbekannt''
|-
|colspan="6"| Textvariante abhängig von der momentanen [[Hilfe:Einstellungen#Sprache|persönlichen Einstellung]] eines [[Hilfe:Benutzerkonto|Benutzerkontos]] darstellen.
* Wenn das Konto als explizit männlich oder weiblich konfiguriert wurde, wird die entsprechende Variante dargestellt.
* Wenn das Konto nicht bekannt ist oder keine explizite Wahl getroffen wurde, wird die Variante „unbekannt“ dargestellt.
* Wenn die (erst später ermöglichte) „unbekannt“-Variante nicht vorgegeben ist, wird die „männlich“-Version für diesen Fall benutzt.
|-
|colspan="6" class="hintergrundfarbe9"| '''Beispiele:'''
* <code><nowiki>{{gender:Beispielnutzer|m|w|u}}</nowiki></code> → <code>{{gender:Beispielnutzer|m|w|u}}</code> ''des [[Benutzer:Beispielnutzer]] (generisch)''.
* <code><nowiki>{{gender:Beispielnutzerin|m|w|u}}</nowiki></code> → <code>{{gender:Beispielnutzerin|m|w|d}}</code> ''der [[Benutzerin:Beispielnutzerin]]''.
* <code><nowiki>{{gender:Beispielnutzer (m)|m|w|u}}</nowiki></code> → <code>{{gender:Beispielnutzer (m)|m|w|d}}</code> ''des [[Benutzerin:Beispielnutzer (m)]]''.
* <code><nowiki>{{gender:Beispielnutzer|m|w}}</nowiki></code> → <code>{{gender:Beispielnutzer|m|w}}</code> ''des [[Benutzer:Beispielnutzer]] ohne „unbekannt“-Variante''.
* <code><nowiki>{{gender:123.456.789.012|m|w|u}}</nowiki></code> → <code>{{gender:123.456.789.012|m|w|u}}</code> ''für nicht registrierten Nick (IP-Adresse)''.
|}

<includeonly>=</includeonly>== {{Anker|commaSeparatedList}} Aufzählung ==<includeonly>=</includeonly>

{| class="wikitable"
|- class="hintergrundfarbe8"
! Funktion !! Pflichtparameter !!colspan="3"| Parameter
|- class="hintergrundfarbe5"
| <code>#commaSeparatedList</code>
|style="border-right-style:none"| ''Item1''
|style="border-left-width:2px; border-left-color:#000000; border-right-style:none;"| ''Item2''
|style="border-left-width:2px; border-left-color:#000000; border-right-style:none;"| ''Item3''
|style="border-left-width:2px; border-left-color:#000000;"| …
|-
|colspan="5"| Komma-separierte Liste von Elementen.
* ''Item1'' – erstes Element
* ''Item2'' – zweites Element
* ''Item3'' – drittes Element
* …
|-
|colspan="6" class="hintergrundfarbe9"| '''Beispiel:''' <code><nowiki>{{#commaSeparatedList:a|b|c}}</nowiki></code> → <code>{{#commaSeparatedList:a|b|c}}</code>
|-
|colspan="5"| Die Funktion entstammt [[mw:Extension:Wikibase Client]].
|}

<includeonly>=</includeonly>== {{Anker|grammar}} Grammatik ==<includeonly>=</includeonly>

Für diese Funktion ist deutschsprachig zurzeit keine Programmierung hinterlegt.

{| class="wikitable"
|- class="hintergrundfarbe8"
! Funktion
|- class="hintergrundfarbe5"
| <code>grammar</code>
|-
| Sprachabhängige Modifikation (Beugung, Verb/Substantiv usw.)
|}

<includeonly>=</includeonly>== Schreibrichtung ==<includeonly>=</includeonly>

Diese Funktionen werden in der deutschsprachigen Wikipedia nicht verwendet.
* Es sind die sprach- und schriftspezifischen Vorlagen der [[:Kategorie:Vorlage:zur Schriftunterstützung (bidi)]] zu benutzen.
*  Diese Methodik mit Steuerzeichen ist seit längerer Zeit unerwünscht und entstammt dem vorigen Jahrhundert.
* Moderne Techniken verwenden HTML-Elemente für die Inhalte und weisen ihnen entsprechende Attribute zu.

{| class="wikitable"
|- class="hintergrundfarbe8"
! Funktion !! Pflichtparameter
|- class="hintergrundfarbe5" id="bidi"
| <code>bidi</code> || ''Textfragment''
|-
|colspan="2"| [[Bidirektionaler Text]].
* ''Textfragment'' (hier: Rechts-Links-Schreibrichtung)
* Es wird in einem Projekt mit Links-Rechts-Schreibrichtung banal <code>&amp;rlm;</code> und <code>&amp;lrm;</code> davor und dahinter geschrieben.
|- class="hintergrundfarbe5" id="DIRECTIONMARK"
| <code>DIRECTIONMARK</code><br /> <code>DIRMARK</code> ||
|-
|colspan="2"| Reguläre Schreibrichtung sicherstellen.
* Es wird in einem Projekt mit Links-Rechts-Schreibrichtung banal <code>&amp;lrm;</code> eingefügt.
* Damit sollten nach Einfügung unbekannter Textfragmente unerwünschte Effekte auf den nachfolgenden Text vermieden werden.
|}

{{Hilfe/Weitere Informationen|Liste=
* <code>[[Hilfe:Parserfunktionen/Seite und URL#urlencode|urlencode]]</code> – Parserfunktion für [[URL-Encoding]]
* [[Vorlage:Navigationsleiste Zeichenketten-Vorlagen|Zeichenketten-Vorlagen]]
* [[Wikipedia:Lua/Modul/Text|Modul:Text]] mit weiteren Funktionen für Zeichenketten
|NOTOC=<includeonly>3</includeonly>
}}
<noinclude>
{{Dokumentation/Suchbegriffe|
casesensitive case sensitive lowercase uppercase downcase tolower toupper}}

[[Kategorie:Hilfe:Vorlagen]]
[[Kategorie:Hilfe:Wikisyntax]]
</noinclude>