Template:Str count

Template documentationview edit history purge

Warning This template is used on approximately 166,000 pages .
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:String (sandbox)

This string handling template returns the number of times that a pattern or search-string occurs in a source string. Counts non-overlapping matches only.

Usage

{{Str count|source string|pattern|plain_flag}}

If there is no occurrence of the source string in the pattern, this template returns 0.

Parameters

There are three parameters; the first two are required:

|source= – the source string. Required; alias: |1=.
|pattern= – the search-string or pattern to look for in the source string. Required; alias: |2=.
|plain= – a boolean flag indicating that pattern should be understood as plain text and not as a Scribunto ustring pattern (a unicode-friendly Lua-style regular expression). Optional; default: true.

Examples

{{str count|aabbacccaddaeeeeaffff|a}} → 5
{{str count|0123456789ABCDEF|X}} → 0
{{str count|Wikipedia:Manual of Style/Words to watch|:}} → 1
{{str count|Wikipedia:Manual of Style/Words to watch|a}} → 4
{{str count|abababa|aba}} → 2 // counts non-overlapping occurrences (matches must be disjoint)

Substring (select chunk of string by its position)
{{str sub new }} Select a substring based on starting and ending index counted in either direction. {{str left }} Keep the first N characters of a string, or duplicate it to N characters. {{str crop }} Return all but the last N characters of a string. {{str index }} Return the N-th character of a string.		{{str right }} Return substring starting at N-th character to end of string. {{str rightc }} Return the last N characters of a string; or a given value if empty. {{str sub old }} Return substring of given length starting at N-th character.

Trimming (select/remove chunk of string by character type)
{{trim }} Trim any leading or trailing whitespace {{str letter/trim }} Trim down to the beginning letters. {{str number/trim }} Trim down to the beginning numbers. {{trim brackets }} Trim any leading or trailing square brackets. {{trim quotes }} Trim leading or trailing matching quotes. {{trim leading }} Trim up to six instances of specified <prefix>.		{{string split }} Extract a short string from a long string. {{first word }} Trim down to the first space. {{remove first word }} Remove anything before the first space. {{last word }} Trim down from the last space. {{remove last word }} Remove anything after the last space.

Select/remove specific item from string
{{delink }}, {{trim brackets }} Removes wikilink brackets (wikicode); all or outer only. {{Plain text }} Removes wikicode (formatting and brackets) {{PAGENAMEBASE }} Trim off any parenthesis text at the end of a string (disambiguation). {{title disambig text }} Returns text in parentheses at the end of a string (disambiguation).		{{title year }} Returns the 3-or-4-digit year from a pagename, if any. {{title decade }} Returns the 4-digit decade from a pagename (e.g. "1740" from "Foo 1740s bar"), if any. {{title number }} Returns any number from a pagename. {{WikiProjectbasename }} Removes "WikiProject" from a pagename.

Insertion, replacement, and length
{{loop }} Repeat character string a specified number of times. {{replace }} Returns the string, after replacing all occurrences of a specified string with another string. {{str rep }} Returns the string, after replacing the first occurrence of a specified string with another string. {{digits }} Returns the string, after removing all characters that are not digits 0–9 {{Nowiki }} Displays wikitext as plain text.		{{str len }} Returns a string's length. {{str ≥ len }} Check if a string is "longer or equally long" or "shorter" than a given length. {{str ≤ len }} Check if a string is "shorter or equally long" or "longer" than a given length. {{str ≠ len }} Check if a string is "not equal" or "equal" to a given length.

Analysis and searching
{{str startswith }} {{str endswith }} Check if a string starts or ends with a given string. {{str find }}, {{strfind short }} Returns the numerical location of a given string in a string. {{str count }} Count the number of occurrences of a pattern within a string. {{string count in page }} Count the number of occurrences of a string within a given page's wikitext.		{{Array }} Array item manipulation and retrieval. {{a or an }} Takes a noun and produces the appropriate indefinite article, based on whether the first letter is a vowel. {{in string }} Returns optional string when given string is not found {{Isnumeric }} Returns number when true, blank when not numeric. {{str letter }} Returns the number of letters that begin a string. {{str number }} Returns the number of numbers that begin a string.

Modules and built-in functions
Module:String, Module:String2, Module:Ustring, Module:Text, wikitext handling: modules that together contain most necessary string functions. Magic words: About `{{padleft:\|}}`, `{{lc:\|}}`, `{{formatnum:\|}}` etc. ParserFunctions: About `{{#titleparts:\|}}, {{#expr:\|}}, {{#ifeq:\|}},` etc.

Category:String manipulation templates

Category:Modules that manipulate strings

Usage

Parameters

Examples

See also