Vorlage:Str left

Dokumentation für die Vorlage {{Str left}}[Ansicht] [Bearbeiten] [Versionsgeschichte] [Aktualisieren]

Dieser Artikel wurde aus einer englischen Sprachversion importiert und wurde noch nicht vollständig übersetzt. Bitte hilf mit, den Text auf deutsch verfügbar zu machen.

Usage

{{Str left|<string>|<count>}}

Gives the <count> substring of characters from the start of the trimmed string (the substring has length <count>).

If <count> is invalid, empty or zero, an empty string is returned. If undefined, it defaults to 1.

Limitations

Length to 500: The maximum substring stops at 500 long, yet gives no error message. Only 500 characters can be extracted even if the <string> is longer.
Inexpensive (uses no other templates).

Examples

{{ Str left | Lorem ipsum dolor sit amet | 10 }} → Lorem ipsu
{{ Str left | Lorem ipsum dolor sit amet | 1 }} → L
{{ Str left | Lorem ipsum dolor sit amet | 0 }} →
{{ Str left | Lorem ipsum dolor sit amet | }} →
{{ Str left | Lorem ipsum dolor sit amet }} → L
{{ Str left | Lorem ipsum dolor sit amet | 40 }} → Lorem ipsum dolor sit ametLorem ipsum do
{{ Str left | àçé | 2 }} → àç
This example is demonstrating the safety of this template with the UTF-8 encoding (this should work now) :

Examples of limitations

All the limitations of use for this template and shown below are caused by the current implementation of the {{padleft:}} parser function used in this template, which does not filter its third parameter containing the characters used for padding a string to the specified length (it currently counts incorrectly the characters to extract from the padding string, and incorrectly measures its effective length; in addition this parameter is limited to 500 bytes).

The following examples are demonstrating that this template is not safe with character entity references found in its string parameter :

{{ Str left | a c | 3 }} → a&n
This should display "a c", but the named character entity was partially truncated, leaving no length available for the final "c".
{{ Str left | aBc | 3 }} → a&#
This should display "abc", but the named character entity was partially truncated, leaving no length available for the final "c".
{{ Str left | a c | 3 }} → a c
The result is correct, as expected.
{{ Str left | a c | 3 }} → a&#
This last example should be equivalent to the previous one, but it is not.

The following example shows that the presence of some wiki markup that should be transparent and ignored, does not allow this template to work as expected (the nowiki section is replaced by a unique index string in the effective runtime value of the parameter; this unique (43-bytes long) string starts by a control character (which will be finally filtered out from the generated HTML page if it remains in the result of this template), followed by "UNIQ" and some unique sequence and terminated by "QINU" and a final control character; it is partially visible below, because the unique string is not complete after truncation, and then cannot be eliminated from the output in the first two lines):

{{ Str left | a<nowiki/>bc | 3 }} → abc
It effectively returns 3 bytes, but the \x07 (BELL) control in the second position is stripped out when generating the HTML displayed here.
{{ Str left | a<nowiki/>bc | 43 }} → abcabcabcabcabcabcabcabcabcabcabcabcabcabca
It effectively returns 43 bytes, but the \x07 (BELL) control in the second position is stripped out when generating the HTML displayed here, and the final \x07 was truncated
{{ Str left | a<nowiki/>bc | 44 }} → abcabcabcabcabcabcabcabcabcabcabcabcabcabcab
It effectively returns 44 bytes, but the complete 43-bytes sequence is filtered out from the output wiki code when generating the final HTML, so there just remains the first leading "a" character .
{{ Str left | a<nowiki/>bc | 45 }} → abcabcabcabcabcabcabcabcabcabcabcabcabcabcabc

On the opposite, the HTML comments, and the "noinclude", "includeonly" and "onlyinclude" wiki markup tags are safe, because they are preprocessed in template parameters, before including it and substituting parameters:

{{ Str left | a<noinclude/>bc | 3 }} → abc
{{ Str left | abc | 3 }} → abc

Note also that the specified length will cause the input string to be padded by repeating it, if this length is larger than the input string length:

{{ Str left | Abc. | 10 }} → Abc.Abc.Ab

Template data

A template to give the <count> substring of characters from the start of the trimmed string

Vorlagenparameter[Vorlagendaten bearbeiten]
Parameter		Beschreibung	Typ	Status
String	`1`	The string to be trimmed and counted	Mehrzeiliger Text	erforderlich
Count	`2`	Gives the <count> substring of characters from the start of the trimmed string	Zahlenwert	erforderlich

Siehe auch

Hinweise

Die obige Dokumentation wurde aus der Seite Vorlage:Str left/Doku eingefügt. (bearbeiten | Versionsgeschichte) Die Kategorien für diese Vorlage sollten in der Dokumentation eingetragen werden. Die Interwiki-Links sollten auf Wikidata eingepflegt werden.
Liste der Unterseiten

a d b Vorlagen zur Zeichenkettenmanipulation

Diese Funktionen benutzen ein Lua-Modul.

Trimmen nach Anzahl	{{Str mid}} – Gibt einen Teilstring unter Angabe von Position und Länge zurück. {{Trunc}} – Reduziert eine Zeichenkette auf eine Solllänge. {{Str left}} – Reduziert eine Zeichenkette auf eine Sollänge von links an gezählt oder füllt eine Zeichenkette durch Duplizierung auf eine Solllänge auf. {{Str crop}} – Schneidet eine bestimmte Anzahl von Zeichen am Ende ab. {{Chop head and tail}} – Schneidet eine bestimmte Anzahl von Zeichen am Anfang und Ende ab. {{Str right}} – Schneidet eine bestimmte Anzahl von Zeichen am Ende ab. {{Str rightc}} – Gibt die übergebene Anzahl von Zeichen vom Ende der Zeichenkette zurück. {{Str rightmost}} – Kürzt eine Zeichenkette auf die angegebene Anzahl am Ende. {{Str sub old}} – Kürzt eine Zeichenkette auf eine bestimmte Anzahl, gestartet an der angegebenen Position. {{Str sub new}} – Gibt eine Teilzeichenkette unter Angabe von Start- und Endposition zurück. {{Str index}} – Gibt den Buchstaben an einer bestimmten Position zurück.

Trimmen nach Bedingung	{{Trim}} – To trim any leading or trailing whitespace ({{Strip whitespace}} does so too, but is less effective) {{First word}} – To trim down to the first space. {{Remove first word}} – To remove anything before the first space. {{Str letter/trim}} – To trim down to the beginning letters. {{Str number/trim}} – To trim down to the beginning numbers.

Zeichen einfügen	{{Loop}} – Repeat character string n times {{Replace}} – Returns the string, after replacing all occurrences of a specified string with another string. {{Strloc insert}} – Inserts a string at character location strloc, or appends if strloc<=0. {{Strloc prefix}} – Extracts string prefix up to location strloc, or whole string if strloc<=0. {{Str rep}} – Returns the string, after replacing the first occurrence of a specified string with another string.

Längenauswertungen	{{Str len}} – Returns a string's length. {{Str ≥ len}} – To check if a string is "longer or equally long" or "shorter" than a given length. {{Str ≤ len}} – To check if a string is "shorter or equally long" or "longer" than a given length. {{Str ≠ len}} – To check if a string is "not equal" or "equal" to a given length. {{Str ≤ ≥ len}} – To check if a string is "shorter", "equal", or "longer" than a given length.

Analyse	{{Str endswith}} – To check if a string ends with a given string. {{Str find}} – Returns the numerical location of a given string in a string. {{Strfind short}} – Returns the numerical location of a given string in a string. {{Str find0}} – Zero-based substring search. {{Str sub find}} – Searches a substring in a string at the given offset. {{ASCII code}} – Returns the ASCII value of a single character. {{Str letter}} – Returns the number of letters that begin a string. {{Str number}} – Returns the number of numbers that begin a string. {{Str gtr str}} – Compares two strings for alphabetical order, and returns a value accordingly.

Spezialanwendungen	{{Title without disambig}} – To trim off any parenthesis text at the end of a string (disambiguation). {{Title disambig text}} – Returns text in parenthesis at the end of a string (disambiguation). {{Unlink}} – Removes wikilink brackets (wikicode). {{Remove file prefix}}—Removes "File:" or "Image:" from filenames.

Technisches	Module:String mw:Help:Magic words – About `{{padleft:\|}}`. mw:Help:Extension:ParserFunctions – About `{{#titleparts:\|}}, {{#expr:\|}}, {{#ifeq:\|}},` etc.

Kategorie:Vorlagen:Zeichenkettenmanipulation Meta-Wiki Englischsprachige Wikipedia