Template:Str left/doc: Difference between revisions

Revision as of 07:35, 19 December 2009

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Str left.

العربية ∙ asturianu ∙ Boarisch ∙ беларуская (тарашкевіца) ∙ български ∙ বাংলা ∙ català ∙ čeština ∙ dansk ∙ Deutsch ∙ Zazaki ∙ Ελληνικά ∙ English ∙ Esperanto ∙ español ∙ eesti ∙ euskara ∙ فارسی ∙ suomi ∙ français ∙ galego ∙ עברית ∙ हिन्दी ∙ hrvatski ∙ magyar ∙ Bahasa Indonesia ∙ italiano ∙ 日本語 ∙ ქართული ∙ 한국어 ∙ кыргызча ∙ Lëtzebuergesch ∙ македонски ∙ മലയാളം ∙ ဘာသာမန် ∙ Bahasa Melayu ∙ Mirandés ∙ မြန်မာဘာသာ ∙ norsk bokmål ∙ Plattdüütsch ∙ Nederlands ∙ norsk ∙ polski ∙ português ∙ português do Brasil ∙ русский ∙ sicilianu ∙ Scots ∙ slovenščina ∙ српски / srpski ∙ svenska ∙ ไทย ∙ Türkçe ∙ українська ∙ اردو ∙ oʻzbekcha / ўзбекча ∙ Tiếng Việt ∙ 中文 ∙ 中文（简体） ∙ 中文（繁體） ∙ 中文（臺灣） ∙ +/−

Usage

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

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

If <count> is invalid or empty, 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

@@ Line 1: / Line 1: @@
 {{Documentation subpage}}
 <!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
-This template returns a certain number of characters from the start of a text string.
 === Usage ===
-ggggggggggggggggggggggggggggggggg
-*'''first parameter''' ''(compulsory)'' the text string to truncate
-*'''second parameter''' the number of characters to return. If invalid or empty, an empty string is returned. If undefined, it defaults to 1.
-===Examples===
+: <code>{{Tlx|Str left|<string>|<count>}}</code>
+Gives the <count> substring of characters from the start of the string (the substring has length <count>).
+If <count> is invalid or empty, 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 ===
 *<tt><nowiki>{{Str left| lorem ipsum dolor sit amet | 10 }}</nowiki></tt> &rarr; {{Str left| lorem ipsum dolor sit amet | 10 }}
 *<tt><nowiki>{{Str left| lorem ipsum dolor sit amet | 1 }}</nowiki></tt> &rarr; {{Str left| lorem ipsum dolor sit amet | 1 }}
-*<tt><nowiki>{{Str left| lorem ipsum dolor sit amet | foo }}</nowiki></tt> &rarr; {{Str left| lorem ipsum dolor sit amet | foo }}
+*<tt><nowiki>{{Str left| lorem ipsum dolor sit amet | 0 }}</nowiki></tt> &rarr; {{Str left| lorem ipsum dolor sit amet | 0 }}
 *<tt><nowiki>{{Str left| lorem ipsum dolor sit amet | }}</nowiki></tt> &rarr; {{Str left| lorem ipsum dolor sit amet | }}
 *<tt><nowiki>{{Str left| lorem ipsum dolor sit amet }}</nowiki></tt> &rarr; {{Str left| lorem ipsum dolor sit amet }}
 === See also ===
-Equivalent to [[Template:Trunc]].  One is superior to the other - which?
+* {{Tl|Trunc|<string>|<count>}} - truncate right-side of string
+* {{Tl|Str right|<string>|<count>}} - extract remainder of string
+* {{Tl|Str rightc|<string>|<count>}} - extract right-side of string
+* {{Tl|Str len|<string>}} - get numeric length of string (can be over 300 long)
 <includeonly>
@@ Line 22: / Line 32: @@
 [[Category: String manipulation templates]]
+[[de:Vorlage:Str left]]
+[[es:Plantilla:Str left]]
+[[eo:Ŝablono:Lin mald]]
+[[id:Templat:Str left]]
+[[lv:Veidne:Str left]]
+[[ja:Template:Str left]]
+[[pt:Predefinição:Str left]]
+[[ru:Шаблон:Str left]]
 </includeonly>

commons>Wuhwuzdat

Revision as of 07:35, 19 December 2009

Usage

Limitations

Examples

See also