Template:String-handling templates - Revision history

Amc-admin: 87 revisions imported

2016-11-19T04:54:06Z

87 revisions imported

← Older revision	Revision as of 04:54, 19 November 2016
(No difference)

Amc-admin: 1 revision imported

2016-11-19T00:55:52Z

1 revision imported

New page

{{Navbox with collapsible groups
| name = String-handling templates
| state = {{{state|expanded}}}
| bodyclass = plainlist
| title = String-handling templates
| selected = {{{selected|{{{expanded|{{{1|}}}}}}}}}


| abbr1 = trim
| sect1 = [[Trimming (computer programming)|Trimming]]
| content1 =
{{Navbox |child

| group1 = By counting
| list1 =
{{Aligned table |fullwidth=on |style=text-align:left; |col1width=50%;
| {{Aligned table |style=padding-right:2.5em;
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|str mid}} | To return a substring specified by position and length.
| {{tl|trunc}} | To trim down to a specified number of characters.
| {{tl|str left}} | To trim down to a specified number of characters or duplicate the string to a specified number.
| {{tl|str crop}} | To crop a specified number of characters off the end.
| {{tl|chop head and tail}} | To crop a specified number of characters off the beginning and end.
}}
| {{Aligned table
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|str right}} | To trim the first specified number of characters.
| {{tl|str rightc}} | To return a number of characters from the end, returns a parameter if the string is empty.
| {{tl|str rightmost}} | To trim down to the last specified number of characters.
| {{tl|str sub old}} | To trim down to a specified number, starting at a given number from the left.
| {{tl|str sub new}} | Select a substr based on starting and ending index.
| {{tl|str index}} | Returns a given character from a string, but not accented letters.
}} }}

| group2 = By checking
| list2 =
{{Aligned table |fullwidth=on |style=text-align:left; |col1width=50%;
| {{Aligned table |style=padding-right:2.5em;
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|trim}} | To trim any leading or trailing whitespace
| {{tl|str letter/trim}} | To trim down to the beginning letters.
| {{tl|str number/trim}} | To trim down to the beginning numbers.
| {{tl|trim brackets}} | To trim any leading or trailing square brackets.
}}
| {{Aligned table
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|first word}} | To trim down to the first space.
| {{tl|remove first word}} | To remove anything before the first space.
| {{tl|last word}} | To trim down from the last space.
| {{tl|remove last word}} | To remove anything after the last space.
}} }}

| group3 = Dedicated
| list3 =
{{Aligned table |fullwidth=on |style=text-align:left; |col1width=50%;
| {{Aligned table |style=padding-right:2.5em;
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|delink}} | Removes wikilink brackets (wikicode).
| {{tl|remove file prefix}} | Removes "File:" (or "Image:") from filenames.
| {{tl|PAGENAMEBASE}} | To trim off any parenthesis text at the end of a string (disambiguation).
| {{tl|title disambig text}} | Returns text in parenthesis at the end of a string (disambiguation).
}}
| {{Aligned table
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|WikiProjectbasename}} | Removes "WikiProject" from a pagename.
| {{tl|remove unranked}} | Removes the string "unranked_" from the left of a string (taxonomy).
| {{tl|ship prefix}} | Returns the length of a ship's name prefix, if listed (ship names).
| {{tl|title year}} | Returns the 4-digit year from a pagename, if any.
}} }}
}}


| abbr2 = IRL
| sect2 = Insertion, replacement and length
| content2 =
{{Aligned table |style=margin:0 auto 0;text-align:left;
| 
{{Aligned table |style=padding-right:2.5em;
|col1style=text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|strloc insert}} | Inserts a string at character location strloc, or appends if strloc<{{=}}0.
| {{tl|loop}} | Repeat character string a specified number of times.
| {{tl|repeat}} | Repeat a string a specified number of times.
| {{tl|replace}} | Returns the string, after replacing ''all'' occurrences of a specified string with another string.
| {{tl|str rep}} | Returns the string, after replacing the first occurrence of a specified string with another string.
}}
| 
{{Aligned table
|col1style=text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|str len}} | Returns a string's length.
| {{tl|iflenge}} | [if len]gth [g]reater than or [e]qual to.
| {{tl|str ≥ len}} | To check if a string is "longer or equally long" or "shorter" than a given length.
| {{tl|str ≤ len}} | To check if a string is "shorter or equally long" or "longer" than a given length.
| {{tl|str ≠ len}} | To check if a string is "not equal" or "equal" to a given length.
| {{tl|str ≤ ≥ len}} | To check if a string is "shorter", "equal", or "longer" than a given length.
}} }}


| abbr3 = anlys/tech
| sect3 = Analysis and technical
| content3 =
{{Aligned table |style=margin:0 auto 0;text-align:left;
| 
{{Aligned table |style=padding-right:2.5em;
|col1style=text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|str endswith}} | To check if a string ends with a given string.
| {{tl|str find}}<br/>{{tl|strfind short}} |style2.2=vertical-align:middle;|''Returns the numerical location of a given string in a string.''
| {{tl|str find0}} | Zero-based substring search.
| {{tl|str sub find}} | Searches a substring in a string at the given offset.
| {{tl|str letter}} | Returns the number of letters that begin a string.
| {{tl|str number}} | Returns the number of numbers that begin a string.
| {{tl|str gtr str}} | Compares two strings for alphabetical order, and returns a value accordingly.
}}
| 
{{Aligned table
|col1style=text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|ASCII code}} | Returns the ASCII value of a single character.
| {{tl|a or an}} | Takes a noun and produces the appropriate indefinite article, based on whether the first letter is a vowel.
|   |  

| [[Module:String]] |
| [[mw:Help:Magic words|...Magic words]] | {{noitalic|About <code><nowiki>{{padleft:|}}</nowiki></code>.}}
| [[mw:Help:Extension:ParserFunctions|...ParserFunctions]] | {{noitalic|About <code><nowiki>{{#titleparts:|}}, {{#expr:|}}, {{#ifeq:|}}, </nowiki></code> etc.}}
}} }}





| belowclass = hlist
| below =
* [[:Category:String manipulation templates]]
* [[m:Category:String templates]]
* [[:commons:Category:String manipulation templates]]

| tracking = no 

}}<noinclude>{{Documentation}}</noinclude>

208.108.154.64 at 12:26, 21 October 2016

2016-10-21T12:26:47Z

New page

{{Navbox with collapsible groups
| name = String-handling templates
| state = {{{state|expanded}}}
| bodyclass = plainlist
| title = String-handling templates
| selected = {{{selected|{{{expanded|{{{1|}}}}}}}}}


| abbr1 = trimmmmm
| sect1 = [[Trimming (computer programming)|Trimming]]
| content1 =
{{Navbox |child

| group1 = By counting
| list1 =
{{Aligned table |fullwidth=on |style=text-align:left; |col1width=50%;
| {{Aligned table |style=padding-right:2.5em;
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|str mid}} | To return a substring specified by position and length.
| {{tl|trunc}} | To trim down to a specified number of characters.
| {{tl|str left}} | To trim down to a specified number of characters or duplicate the string to a specified number.
| {{tl|str crop}} | To crop a specified number of characters off the end.
| {{tl|chop head and tail}} | To crop a specified number of characters off the beginning and end.
}}
| {{Aligned table butterst
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|str right}} | To trim the first specified number of characters.
| {{tl|str rightc}} | To return a number of characters from the end, returns a parameter if the string is empty.
| {{tl|str rightmost}} | To trim down to the last specified number of characters.
| {{tl|str sub old}} | To trim down to a specified number, starting at a given number from the left.
| {{tl|str sub new}} | Select a substr based on starting and ending index.
| {{tl|str index}} | Returns a given character from a string, but not accented letters.
}} }}

| group2 = By checking
| list2 =
{{Aligned table |fullwidth=on |style=text-align:left; |col1width=50%;
| {{Aligned table |style=padding-right:2.5em;
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|trim}} | To trim any leading or trailing whitespace
| {{tl|str letter/trim}} | To trim down to the beginning letters.
| {{tl|str number/trim}} | To trim down to the beginning numbers.
| {{tl|trim brackets}} | To trim any leading or trailing square brackets.
}}
| {{Aligned table
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|first word}} | To trim down to the first space.
| {{tl|remove first word}} | To remove anything before the first space.
| {{tl|last word}} | To trim down from the last space.
| {{tl|remove last word}} | To remove anything after the last space.
}} }}

| group3 = Dedicated
| list3 =
{{Aligned table |fullwidth=on |style=text-align:left; |col1width=50%;
| {{Aligned table |style=padding-right:2.5em;
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|delink}} | Removes wikilink brackets (wikicode).
| {{tl|remove file prefix}} | Removes "File:" (or "Image:") from filenames.
| {{tl|PAGENAMEBASE}} | To trim off any parenthesis text at the end of a string (disambiguation).
| {{tl|title disambig text}} | Returns text in parenthesis at the end of a string (disambiguation).
}}
| {{Aligned table
|col1style=width:12.5em;text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|WikiProjectbasename}} | Removes "WikiProject" from a pagename.
| {{tl|remove unranked}} | Removes the string "unranked_" from the left of a string (taxonomy).
| {{tl|ship prefix}} | Returns the length of a ship's name prefix, if listed (ship names).
| {{tl|title year}} | Returns the 4-digit year from a pagename, if any.
}} }}
}}


| abbr2 = IRL
| sect2 = Insertion, replacement and length
| content2 =
{{Aligned table |style=margin:0 auto 0;text-align:left;
| 
{{Aligned table |style=padding-right:2.5em;
|col1style=text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|strloc insert}} | Inserts a string at character location strloc, or appends if strloc<{{=}}0.
| {{tl|loop}} | Repeat character string a specified number of times.
| {{tl|repeat}} | Repeat a string a specified number of times.
| {{tl|replace}} | Returns the string, after replacing ''all'' occurrences of a specified string with another string.
| {{tl|str rep}} | Returns the string, after replacing the first occurrence of a specified string with another string.
}}
| 
{{Aligned table
|col1style=text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|str len}} | Returns a string's length.
| {{tl|iflenge}} | [if len]gth [g]reater than or [e]qual to.
| {{tl|str ≥ len}} | To check if a string is "longer or equally long" or "shorter" than a given length.
| {{tl|str ≤ len}} | To check if a string is "shorter or equally long" or "longer" than a given length.
| {{tl|str ≠ len}} | To check if a string is "not equal" or "equal" to a given length.
| {{tl|str ≤ ≥ len}} | To check if a string is "shorter", "equal", or "longer" than a given length.
}} }}


| abbr3 = anlys/tech
| sect3 = Analysis and technical
| content3 =
{{Aligned table |style=margin:0 auto 0;text-align:left;
| 
{{Aligned table |style=padding-right:2.5em;
|col1style=text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|str endswith}} | To check if a string ends with a given string.
| {{tl|str find}}<br/>{{tl|strfind short}} |style2.2=vertical-align:middle;|''Returns the numerical location of a given string in a string.''
| {{tl|str find0}} | Zero-based substring search.
| {{tl|str sub find}} | Searches a substring in a string at the given offset.
| {{tl|str letter}} | Returns the number of letters that begin a string.
| {{tl|str number}} | Returns the number of numbers that begin a string.
| {{tl|str gtr str}} | Compares two strings for alphabetical order, and returns a value accordingly.
}}
| 
{{Aligned table
|col1style=text-align:right;white-space:nowrap;padding-right:0.75em; |col2style=font-style:italic;
| {{tl|ASCII code}} | Returns the ASCII value of a single character.
| {{tl|a or an}} | Takes a noun and produces the appropriate indefinite article, based on whether the first letter is a vowel.
|   |  

| [[Module:String]] |
| [[mw:Help:Magic words|...Magic words]] | {{noitalic|About <code><nowiki>{{padleft:|}}</nowiki></code>.}}
| [[mw:Help:Extension:ParserFunctions|...ParserFunctions]] | {{noitalic|About <code><nowiki>{{#titleparts:|}}, {{#expr:|}}, {{#ifeq:|}}, </nowiki></code> etc.}}
}} }}





| belowclass = hlist
| below =
* [[:Category:String manipulation templates]]
* [[m:Category:String templates]]
* [[:commons:Category:String manipulation templates]]

| tracking = no 

}}<noinclude>{{Documentation}}</noinclude>

123.54.185.80 at 05:12, 22 January 2013

2013-01-22T05:12:04Z

New page

<noinclude><big>List of templates in {{cat|String manipulation templates}}.</big>
</noinclude>==Templates==
===[[Trim (programming)|Trimming]] templates===

* {{tl|Trunc}} – To trim down to a specified number of characters.
* {{tl|Str left}} – To trim down to a specified number of characters, or duplicate the string to a specified number.
* {{tl|Str crop}} – To crop a specified number of characters off the end.
* {{tl|Chop head and tail}} — To crop a specified number of characters off the beginning and end.
* {{tl|Trim}} — To trim any leading or trailing whitespace.
* {{tl|First word}} — To trim down to the first space.
* {{tl|Remove first word}} — To remove anything before the first space.
* {{tl|Str letter/trim}} — To trim down to the beginning letters.
* {{tl|Str number/trim}} — To trim down to the beginning numbers.
* {{tl|Title without disambig}} — To trim off any parenthesis text at the end of a string.
* {{tl|Title disambig text}} – Returns text in parenthesis at the end of a string.
* {{tl|Str right}} — To trim the first specified number of characters.
* {{tl|Str rightc}} — To return a number of characters from the end, returns a parameter if the string is empty.
* {{tl|Str rightmost}} — To trim down to the last specified number of characters.
* {{tl|Str sub}} — To trim down to a specified number, starting at a given number from the left, less than 50.
* {{tl|Substr any}} — To trim down to a specified number, starting at a given number from the left, less than 50, can extract accented letters.
* {{tl|Str sub long}} — To trim down to a specified number, starting at a given number from the left, less than 100.
* {{tl|trim}} — Removes [[whitespace]] ({{tl|Strip whitespace}} does so too, but is less effective)

===Inserting strings===

* {{[[Template:Strloc insert|Strloc insert]]}} - Inserts a string at character location strloc, or appends if strloc<=0.
* {{[[Template:Strloc prefix|Strloc prefix]]}} - Extracts string prefix up to location strloc, or whole string if strloc<=0.
* {{[[Template:Str rep|Str rep]]}} — Returns the string, replacing the first occurrence of a specified string, with another string. Requires a match.
* {{[[Template:Str repc|Str repc]]}} — Returns the string, replacing the first occurrence of a specified string, with another string, if there is one.
* {{[[Template:Repeat|Repeat]]}} — Repeat character string n times

===Analyzing strings templates===

* {{tl|Str endswith}} – To check if a string ends with a given string.
* {{tl|Str find}} – Returns the numerical location of a given string in a string, up to 50 characters.
* {{tl|Str find long}} – Returns the numerical location of a given string in a string, up to 80 characters.
* {{tl|Strfind short}} – Searches for a short string in a longer (up to 99 char) string. Performs faster than {{tl|str find}}
* {{tl|Str find0}} – Very fast zero-based substring search with string support up to 90 characters.
* {{tl|Str sub find}} – Searches a substring in a string at the given offset.
* {{tl|Str index}} – Returns a given character from a string, but not accented letters.
* {{tl|Str index any}} – Returns a given character from a string, but not a space.
* {{tl|Chr}} – Returns a given character from a string, including a space.
* {{tl|Str len}} – Returns a string's length. Can count up to 500 characters.
* {{tl|Strlen quick}} – Gets string length quickly (better performance), up to 70 long.
* {{tl|Strlen short}} – Gets length of short strings (1-50), using only 2 expansion levels.
* {{tl|Str letter}} — Returns the number of letters that begin a string.
* {{tl|Str number}} — Returns the number of numbers that begin a string.
* {{tl|Ship prefix}} — Returns the length of a ship name prefix, if listed.

===String length comparison templates===

* {{tl|Str ≥ len}} – To check if a string is "longer or equally long" or "shorter" than a given length.
* {{tl|Str ≤ len}} – To check if a string is "shorter or equally long" or "longer" than a given length.
* {{tl|Str ≠ len}} – To check if a string is "not equal" or "equal" to a given length.
* {{tl|Str ≤ ≥ len}} – To check if a string is "shorter", "equal", or "longer" than a given length.

==Test cases==
[[Wikipedia:Template sandbox and test cases|Sandboxes and test cases]]:

* {{tl|Str find/sandbox}}
* {{tl|Str index/getchar/sandbox}}
* {{tl|Str index/getchar/testcases}}
* {{tl|Str index/sandbox}}
* {{tl|Str index/testcases}}
* {{tl|Str index any/sandbox}}
* {{tl|Str index any/testcases}}
* {{tl|Str left/sandbox}}
* {{tl|Str len/core/sandbox}}
* {{tl|Str len/sandbox}}
* {{tl|Str len/testcases}}
* {{tl|Str rightc/testcases}}
* {{tl|Str ≠ len/sandbox}}
* {{tl|Str ≠ len/testcases}}

==Technical developments==

* [[mw:Help:Magic words]] – About <code><nowiki>{{padleft:|}}</nowiki></code>.
* [[mw:Help:Extension:ParserFunctions]] – About <code><nowiki>{{#titleparts:|}}, {{#expr:|}}, {{#ifeq:|}}, </nowiki></code> etc.

;Feature requests:

* [[bugzilla:6455]] - Set $wgPFEnableStringFunctions = true on WMF wikis
* [[bugzilla:26092]] - Enable or install string parsing wikimarkup functionality on WMF wikis

Future:
* [[mw:Lua scripting]] ([[mw:Lua scripting/status#catlinks|status]]?)

<noinclude>
[[Category:Documentation shared content templates]]
[[Category:String manipulation templates| ]]

[[bs:Šablon:Niz šabloni]]
[[gu:ઢાંચો:String templates see also text]]
[[jv:Cithakan:String templates see also]]
[[nso:Template:String templates see also text]]
[[zh:Template:字符串模板參見文字]]
</noinclude>