Quelltext der Seite Vorlage:Str crop/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{TemplateData|JSON=
  {
    "description": "Die Vorlage entfernt eine bestimmte [[#templatedata:2|''Anzahl'']] von Zeichen von rechts im angegebenen [[#templatedata:1|''Text'']].",
    "params": {
           "1": { "label":       "Text",
                  "description": "Zeichenkette, die gekürzt werden soll.",
                  "type":        "string",
                  "required":    true,
                  "example":     "Autobahn"
                },
           "2": { "label":       "Anzahl",
                  "description": "Anzahl Zeichen, die in [[#templatedata:1|''Text'']] rechts entfernt werden sollen.<br>Werte kleiner 0 werden wie 0 verarbeitet",
                  "type":        "number",
                  "required":    false,
                  "default":     "0",
                  "example":     "4"
                }
       }
  }
|TOC=1}}

{{Info|Die Vorlage liefert irreführende nicht zutreffende Ergebnisse, wenn [[#templatedata:2|''Anzahl'']] größer als die Länge von [[#templatedata:1|''Text'']] ist! (siehe [[#Beispiele]])}}

== Kopiervorlagen ==
<pre>{{Str&nbsp;crop | | }}</pre>
Falls Gleichheitszeichen (<code>&#61;</code>) in den Parameterinhalten vorkommen und/oder führende und abschließende Leerzeichen in den Parameterinhalten entfernt werden sollen:
<pre>{{Str&nbsp;crop
 |1=
 |2=
}}</pre>

== Beispiele ==
* "<code style="white-space:pre-wrap;"><nowiki>{{str crop||4}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop||4}}</span>" ([[#templatedata:1|''Text'']] ist eine leere Zeichenkette der Länge 0)
* "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  }}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  }}</span>" ([[#templatedata:1|''Text'']] besteht nur aus 2 Leerzeichen, [[#templatedata:2|''Anzahl'']] mit Standardwert)
* "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  |1}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  |1}}</span>"  ([[#templatedata:1|''Text'']] besteht nur aus 2 Leerzeichen)
* "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  |3}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  |3}}</span>"  ([[#templatedata:1|''Text'']] besteht nur aus 2 Leerzeichen)
* "<code style="white-space:pre-wrap;"><nowiki>{{str crop|{{SUBJECTPAGENAME}}|3}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|{{SUBJECTPAGENAME}}|3}}</span>"
* "<code style="white-space:pre-wrap;"><nowiki>{{str crop|{{PAGENAME}}|3}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|{{PAGENAME}}|3}}</span>"
* "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg    |2}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg    |2}}</span>"
* "<code style="white-space:pre-wrap;"><nowiki>{{str crop|1=  Beispiel.jpg    |2=2}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|1=  Beispiel.jpg    |2=2}}</span>" (vorher Entfernung der Leerzeichen links und rechts)
* In den folgenden Beispielen besteht ([[#templatedata:1|''Text'']] aus 16 Zeichen, inkl. 2 führenden und 2 abschließenden Leerzeichen:
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|1=  Beispiel.jpg  }}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|1=  Beispiel.jpg  }}</span>" ([[#templatedata:2|''Anzahl'']] mit Standardwert und Entfernung der Leerzeichen links und rechts)
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  }}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  }}</span>" ([[#templatedata:2|''Anzahl'']] mit Standardwert)
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  |-4}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  |-4}}</span>"
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  | 1}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  | 1}}</span>"
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  | 2}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  | 2}}</span>"
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  | 4}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  | 4}}</span>"
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  |13}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  |13}}</span>"
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  |14}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  |14}}</span>"
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  |15}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  |15}}</span>"
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  |16}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  |16}}</span>"
*; irreführende nicht zutreffende Ergebnisse:
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  |17}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  |17}}</span>" 
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  |20}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  |20}}</span>" 
** "<code style="white-space:pre-wrap;"><nowiki>{{str crop|  Beispiel.jpg  |30}}</nowiki></code>" ergibt "<span style="white-space:pre-wrap;">{{str crop|  Beispiel.jpg  |30}}</span>"

== Siehe auch ==
* [[Hilfe:Vorlagen]]
{{Navigationsleiste Zeichenketten-Vorlagen}}
<includeonly>
{{Dokumentation/Lua |Str}}
[[Kategorie:Vorlage:Syntaxhilfe]]
</includeonly>