Template:First word

{{{1}}}

Template documentation[view] [edit] [history] [purge]

Warning This template is used on approximately 595,000 pages, or roughly 1% of all 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 template returns the first word of the first parameter. Use |1= for the first parameter if the string may contain an equals sign (=). By default, words are delimited by spaces, but the optional parameter |sep= can set the separator to any character.

Usage

One parameter (space as separator):

{{First word|string}}
{{First word|1=string}}

Two parameters (user-defined character as separator):

{{First word|string|sep=character}}
{{First word|1=string|sep=character}}

Examples

{{First word|Foo bar baz}} → Foo
{{First word| Foo bar baz}} → Foo
{{First word|Foo}} → Foo
{{First word|Foo-bar-baz}} → Foo-bar-baz
{{First word|Foo-bar-baz|sep=-}} → Foo
{{First word|34,000,500|sep=,}} → 34
{{First word|Hear ye, users|sep=,}} → Hear ye
{{First word|1=len = a+b|sep==}} → len

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.		{{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

Examples

See also