Module:Text/doc - Revision history

Matt at 21:48, 9 April 2025

2025-04-09T21:48:14Z

← Older revision		Revision as of 17:48, 9 April 2025
Line 1:		Line 1:
	{{wikipedia\|page name}}		{{wikipedia\|page name}}
	~~{{high use}}~~
	{{Lua\|Module:Yesno}}		{{Lua\|Module:Yesno}}
	'''<code>Text</code>''' – Module containing methods for the manipulation of text, wikimarkup and some HTML.		'''<code>Text</code>''' – Module containing methods for the manipulation of text, wikimarkup and some HTML.

Matt at 11:25, 9 April 2025

2025-04-09T11:25:16Z

← Older revision		Revision as of 07:25, 9 April 2025
Line 78:		Line 78:
	:* Returns nothing if the sentence is unterminated.		:* Returns nothing if the sentence is unterminated.
	; ucfirstAll {{Anchor\|ucfirstAll}}		; ucfirstAll {{Anchor\|ucfirstAll}}
	: The first letter of every recognized word is converted to upper case. This contrasts with the parser function ~~{{tlg\|:mw:ucfirst\|alttext=ucfirst:}}~~ which changes only the first character of the whole string passed.		: The first letter of every recognized word is converted to upper case. This contrasts with the parser function which changes only the first character of the whole string passed.
	: A few common HTML entities are protected; the implementation of this may mean that numerical entities passed (e.g. <code>&#38;)</code> are converted to <code>&amp;</code> form		: A few common HTML entities are protected; the implementation of this may mean that numerical entities passed (e.g. <code>&#38;)</code> are converted to <code>&amp;</code> form
	; uprightNonlatin {{Anchor\|uprightNonlatin}}		; uprightNonlatin {{Anchor\|uprightNonlatin}}

Matt at 08:27, 9 April 2025

2025-04-09T08:27:52Z

← Older revision		Revision as of 04:27, 9 April 2025
Line 138:		Line 138:
	* Module:Text/data --- Lua patterns and information about quotes		* Module:Text/data --- Lua patterns and information about quotes

	~~== See also ==~~
	~~{{String-handling templates}}~~
	<includeonly>{{Sandbox other\|\|		<includeonly>{{Sandbox other\|\|
	<!-- Categories below this line; interwikis at Wikidata -->		<!-- Categories below this line; interwikis at Wikidata -->
	[[Category:Modules that manipulate strings]]		[[Category:Modules that manipulate strings]]
	}}</includeonly>		}}</includeonly>

Matt at 13:01, 8 April 2025

2025-04-08T13:01:29Z

Matt at 21:00, 5 March 2025

2025-03-05T21:00:45Z

← Older revision		Revision as of 17:00, 5 March 2025
Line 1:		Line 1:
			{{wikipedia\|page name}}
	{{high use}}		{{high use}}
	{{Lua\|Module:Yesno}}		{{Lua\|Module:Yesno}}

Matt: Protected "Module:Text/doc": Initial wiki setup ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2025-03-05T19:41:16Z

Protected "Module:Text/doc": Initial wiki setup ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision	Revision as of 15:41, 5 March 2025
(No difference)

Matt: Created page with "{{high use}} {{Lua|Module:Yesno}} '''`Text`''' – Module containing methods for the manipulation of text, wikimarkup and some HTML. == {{Anchor|Vorlage}} Functions for templates == All methods have an unnamed parameter containing the text. The return value is an empty string if the parameter does not meet the conditions. When the condition is matched or some result is successfully found, strings of at least one character are returned. ; char {{Anchor|char..."

2025-03-04T20:20:29Z

Created page with "{{high use}} {{Lua|Module:Yesno}} '''<code>Text</code>''' – Module containing methods for the manipulation of text, wikimarkup and some HTML. == {{Anchor|Vorlage}} Functions for templates == All methods have an unnamed parameter containing the text. The return value is an empty string if the parameter does not meet the conditions. When the condition is matched or some result is successfully found, strings of at least one character are returned. ; char {{Anchor|char..."

New page

{{high use}}
{{Lua|Module:Yesno}}
'''<code>Text</code>''' – Module containing methods for the manipulation of text, wikimarkup and some HTML.

== {{Anchor|Vorlage}} Functions for templates ==

All methods have an unnamed parameter containing the text.

The return value is an empty string if the parameter does not meet the conditions. When the condition is matched or some result is successfully found, strings of at least one character are returned.

; char {{Anchor|char}}
: Creates a string from a list of character codes.
::; 1
::: Space-separated list of character codes
::; *
::: Number of repetitions of the list in parameter '''1'''; (Default 1).
::; errors
::: <code>0</code> – Silence errors
; concatParams {{Anchor|concatParams}}
: Combine any number of elements into a list, like <code>table.concat()</code> in Lua.
: From a template:
::; 1
::: First element; missing and empty elements are ignored.
::; 2 3 4 5 6 …
::: Further list elements
: From Lua
::; args
::: ''table (sequence)'' of the elements
::; apply
::: Separator between elements; defaults to <code>|</code>
::; adapt
::: optional formatting, which will be applied to each element; must contain <code>%s</code>.
; containsCJK {{Anchor|containsCJK}}
: Returns whether the input string contains any [[CJK characters]]
:* Returns nothing if there are no CJK characters
; removeDelimited
: Remove all text between delimiters, including the delimiters themselves.
; getPlain{{Anchor|getPlain}}
: Remove wikimarkup (except templates): comments, tags, bold, italic, nbsp
; isLatinRange {{Anchor|isLatinRange}}
: Returns some content, unless the string contains a character that would not normally be found in Latin text.
:* Returns nothing if there is a non-Latin string.
; isQuote {{Anchor|isQuote}}
: Returns some content if the parameter passed is a single character, and that character is a quote, such as <code>'</code>.
:* Returns nothing for multiple characters, or if the character passed is not a quote.
; listToText {{Anchor|listToText}}
: Formats list elements analogously to [[:mw:Extension:Scribunto/Lua_reference_manual#mw.text.listToText|mw.text.listToText()]].
: The elements are separated by a comma and space ; the word "and" appears between the first and last.
: Unnamed parameters become the list items.
: Optional parameters for <code>#invoke</code>:
:* <code>format</code> – Every list element will first be formatted with this format string; see [[:mw:Extension:Scribunto/Lua_reference_manual#string.format|here]] for how to construct this string. The string must contain at least one <code>%s</code> sequence.
:* <code>template=1</code> – List elements should be taken from the calling template.
: Returns the resulting string.
; quote {{Anchor|quote}}
: Wrap the string in quotes; quotes can be chosen for a specific language.
::; 1
::: Input text (will be automatically trimmed); may be empty.
::; 2
::: ''(optional)'' the [[ISO 639]] language code for the quote marks; should be one of the [[:de:Wikipedia:Lua/Modul/Text/Test#Anführungszeichen|supported languages]] {{in lang|de}}
::; 3
::: ''(optional)'' <code>2</code> for second level quotes. This means the single quote marks in a statement such as: Jack said, “Jill said ‘fish’ last Tuesday.”
; quoteUnquoted {{Anchor|quoteUnquoted}}
:
: Wrap the string in quotes; quotes can be chosen for a specific language. Will not quote an empty string, and will not quote if there is a quote at the start or end of the (trimmed) string.
::; 1
::: Input text (will be automatically trimmed); may be empty.
::; 2
::: ''(optional)'' the [[ISO 639]] language code for the quote marks; should be one of the [[:de:Wikipedia:Lua/Modul/Text/Test#Anführungszeichen|supported languages]] {{in lang|de}}
::; 3
::: ''(optional)'' <code>2</code> for second level quotes. This means the single quote marks in a statement such as: Jack said, “Jill said ‘fish’ last Tuesday.”
; removeDiacritics {{Anchor|removeDiacritics}}
: Removes all [[diacritical marks]] from the input.
::; 1
::;: Input text
; sentenceTerminated {{Anchor|sentenceTerminated}}
: Is this sentence terminated? Should work with CJK, and allows quotation marks to follow.
:* Returns nothing if the sentence is unterminated.
; ucfirstAll {{Anchor|ucfirstAll}}
: The first letter of every recognized word is converted to upper case. This contrasts with the parser function {{tlg|:mw:ucfirst|alttext=ucfirst:}} which changes only the first character of the whole string passed.
: A few common HTML entities are protected; the implementation of this may mean that numerical entities passed (e.g. <code>&#38;)</code> are converted to <code>&amp;</code> form
; uprightNonlatin {{Anchor|uprightNonlatin}}
: Takes a string. Italicized non-Latin characters are un-italicized, unless they are a single Greek letter.
; zip {{Anchor|zip}}
: Combines a tuple of lists by [[convolution (computer science)|convolution]]. This is easiest to explain by example: given two lists, list1 = "a b c" and list2 = "1 2 3", then <code>zip(list1, list2, sep = " ", isep = "-", osep = "/")</code> outputs <code>a-1/b-2/c-3</code>
:* 1, 2, 3, … – Lists to be combined
:* <code>sep</code> – A separator (in Lua [[regex]] form) used to split the lists. If empty, the lists are split into individual characters.
:* <code>sep1</code>, <code>sep2</code>, <code>sep3</code>, … – Allows a different separator to be used for each list.
:* <code>isep</code> – Output separator; placed between elements which were at the ''same'' index in their lists.
:* <code>osep</code> – Output separator; placed between elements which had ''different'' original indices; i.e. between the groups joined with <code>isep</code>
; split {{Anchor|split}}
: Splits a string into chunks at the specified delimiter, and returns the first (or user-specified) chunk. This is non-Unicode-aware implementation of [[:mw:Lua_reference_manual#mw.text.split|mw.text.split]] which, for ASCII-only text, can be up to 60 times faster.
:* 1 (or <code>text</code>) – the text to be split
:* 2 (or <code>pattern</code>) – the pattern to use when splitting the text. By default, this can be a [[:mw:Extension:Scribunto/Lua_reference_manual#Patterns|string library pattern]].
:* 3 (or <code>plain</code>) – if set to "true", <code>pattern</code> will be interpreted as plain text, not a pattern.
:* 4 (or <code>index</code>) – The chunk to return. If omitted, the first chunk will be returned. Can be set to a negative number to count from the end (e.g. <code>-1</code> will return the last chunk).

=== Examples and test page ===
There are [[:de:Wikipedia:Lua/Modul/Text/Test|tests available]] {{in lang|de}} to illustrate this in practice.

== {{Anchor|Lua}} Use in another Lua module ==

All of the above functions can be called from other Lua modules. Use <code>require()</code>; the below code checks for errors loading it:
<syntaxhighlight lang="lua">
local lucky, Text = pcall( require, "Module:Text" )
if type( Text ) == "table" then
Text = Text.Text()
else
-- In the event of errors, Text is an error message.
return "" .. Text .. ""
end
</syntaxhighlight>
You may then call:
* <code>Text.char( apply, again, accept )</code>
* <code>Text.concatParams( args, separator, format )</code>
* <code>Text.containsCJK( s )</code>
* <code>Text.removeDelimited( s )</code>
* <code>Text.getPlain( s )</code>
* <code>Text.isLatinRange( s )</code>
* <code>Text.isQuote( c )</code>
* <code>Text.listToText( table, format )</code>
* <code>Text.quote( s, lang, mode )</code>
* <code>Text.quoteUnquoted( s, lang, mode )</code>
* <code>Text.removeDiacritics( s )</code>
* <code>Text.sentenceTerminated( s )</code>
* <code>Text.split( text, pattern, plain )</code> – non Unicode version of [[:mw:Extension:Scribunto/Lua_reference_manual#mw.text.split|mw.text.split]]
* <code>Text.gsplit( text, pattern, plain )</code> – non Unicode version of [[:mw:Extension:Scribunto/Lua_reference_manual#mw.text.gsplit|mw.text.gsplit]]
* <code>Text.ucfirstAll( s )</code>
* <code>Text.uprightNonlatin( s )</code>
* <s><code>Text.zip(…)</code></s>
* ''<code>Text.test( s )</code>''

== Usage ==
This is a general library; use it anywhere.

== Dependencies ==
* [[Module:Yesno]]
* [[Module:Text/data]] --- Lua patterns and information about quotes

== See also ==
{{String-handling templates}}
<includeonly>{{Sandbox other||

[[Category:Modules that manipulate strings]]
}}</includeonly>

← Older revision		Revision as of 09:01, 8 April 2025
Line 33:		Line 33:
	::: optional formatting, which will be applied to each element; must contain <code>%s</code>.		::: optional formatting, which will be applied to each element; must contain <code>%s</code>.
	; containsCJK {{Anchor\|containsCJK}}		; containsCJK {{Anchor\|containsCJK}}
	: Returns whether the input string contains any [[CJK characters]]		: Returns whether the input string contains any CJK characters
	:* Returns nothing if there are no CJK characters		:* Returns nothing if there are no CJK characters
	; removeDelimited		; removeDelimited
Line 46:		Line 46:
	:* Returns nothing for multiple characters, or if the character passed is not a quote.		:* Returns nothing for multiple characters, or if the character passed is not a quote.
	; listToText {{Anchor\|listToText}}		; listToText {{Anchor\|listToText}}
	: Formats list elements analogously to ~~[[:mw:Extension:Scribunto/Lua_reference_manual#mw.text.listToText\|~~mw.text.listToText()]].		: Formats list elements analogously to mw.text.listToText().
	: The elements are separated by a comma and space ; the word "and" appears between the first and last.		: The elements are separated by a comma and space ; the word "and" appears between the first and last.
	: Unnamed parameters become the list items.		: Unnamed parameters become the list items.
	: Optional parameters for <code>#invoke</code>:		: Optional parameters for <code>#invoke</code>:
	:* <code>format</code> – Every list element will first be formatted with this format string; see ~~[[:mw:Extension:Scribunto/Lua_reference_manual#string.format\|~~here]] for how to construct this string. The string must contain at least one <code>%s</code> sequence.		:* <code>format</code> – Every list element will first be formatted with this format string; see here for how to construct this string. The string must contain at least one <code>%s</code> sequence.
	:* <code>template=1</code> – List elements should be taken from the calling template.		:* <code>template=1</code> – List elements should be taken from the calling template.
	: Returns the resulting string.		: Returns the resulting string.
Line 58:		Line 58:
	::: Input text (will be automatically trimmed); may be empty.		::: Input text (will be automatically trimmed); may be empty.
	::; 2		::; 2
	::: ''(optional)'' the [[ISO 639]] language code for the quote marks; should be one of the ~~[[:de:Wikipedia:Lua/Modul/Text/Test#Anführungszeichen\|~~supported languages]] {{in lang\|de}}		::: ''(optional)'' the ISO 639 language code for the quote marks; should be one of the supported languages {{in lang\|de}}
	::; 3		::; 3
	::: ''(optional)'' <code>2</code> for second level quotes. This means the single quote marks in a statement such as: Jack said, “Jill said ‘fish’ last Tuesday.”		::: ''(optional)'' <code>2</code> for second level quotes. This means the single quote marks in a statement such as: Jack said, “Jill said ‘fish’ last Tuesday.”
Line 67:		Line 67:
	::: Input text (will be automatically trimmed); may be empty.		::: Input text (will be automatically trimmed); may be empty.
	::; 2		::; 2
	::: ''(optional)'' the [[ISO 639]] language code for the quote marks; should be one of the ~~[[:de:Wikipedia:Lua/Modul/Text/Test#Anführungszeichen\|~~supported languages]] {{in lang\|de}}		::: ''(optional)'' the ISO 639 language code for the quote marks; should be one of the supported languages {{in lang\|de}}
	::; 3		::; 3
	::: ''(optional)'' <code>2</code> for second level quotes. This means the single quote marks in a statement such as: Jack said, “Jill said ‘fish’ last Tuesday.”		::: ''(optional)'' <code>2</code> for second level quotes. This means the single quote marks in a statement such as: Jack said, “Jill said ‘fish’ last Tuesday.”
	; removeDiacritics {{Anchor\|removeDiacritics}}		; removeDiacritics {{Anchor\|removeDiacritics}}
	: Removes all [[diacritical marks]] from the input.		: Removes all diacritical marks from the input.
	::; 1		::; 1
	::;: Input text		::;: Input text
Line 83:		Line 83:
	: Takes a string. Italicized non-Latin characters are un-italicized, unless they are a single Greek letter.		: Takes a string. Italicized non-Latin characters are un-italicized, unless they are a single Greek letter.
	; zip {{Anchor\|zip}}		; zip {{Anchor\|zip}}
	: Combines a tuple of lists by [[convolution ~~(computer science)\|convolution]]~~. This is easiest to explain by example: given two lists, list1 = "a b c" and list2 = "1 2 3", then<br><code>zip(list1, list2, sep = " ", isep = "-", osep = "/")</code><br>outputs<br><code>a-1/b-2/c-3</code>		: Combines a tuple of lists by convolution. This is easiest to explain by example: given two lists, list1 = "a b c" and list2 = "1 2 3", then<br><code>zip(list1, list2, sep = " ", isep = "-", osep = "/")</code><br>outputs<br><code>a-1/b-2/c-3</code>
	:* 1, 2, 3, … – Lists to be combined		:* 1, 2, 3, … – Lists to be combined
	:* <code>sep</code> – A separator (in Lua [[regex]] form) used to split the lists. If empty, the lists are split into individual characters.		:* <code>sep</code> – A separator (in Lua regex form) used to split the lists. If empty, the lists are split into individual characters.
	:* <code>sep1</code>, <code>sep2</code>, <code>sep3</code>, … – Allows a different separator to be used for each list.		:* <code>sep1</code>, <code>sep2</code>, <code>sep3</code>, … – Allows a different separator to be used for each list.
	:* <code>isep</code> – Output separator; placed between elements which were at the ''same'' index in their lists.		:* <code>isep</code> – Output separator; placed between elements which were at the ''same'' index in their lists.
	:* <code>osep</code> – Output separator; placed between elements which had ''different'' original indices; i.e. between the groups joined with <code>isep</code>		:* <code>osep</code> – Output separator; placed between elements which had ''different'' original indices; i.e. between the groups joined with <code>isep</code>
	; split {{Anchor\|split}}		; split {{Anchor\|split}}
	: Splits a string into chunks at the specified delimiter, and returns the first (or user-specified) chunk. This is non-Unicode-aware implementation of ~~[[:mw:Lua_reference_manual#mw.text.split\|~~mw.text.split]] which, for ASCII-only text, can be up to 60 times faster.		: Splits a string into chunks at the specified delimiter, and returns the first (or user-specified) chunk. This is non-Unicode-aware implementation of mw.text.split which, for ASCII-only text, can be up to 60 times faster.
	:* 1 (or <code>text</code>) – the text to be split		:* 1 (or <code>text</code>) – the text to be split
	:* 2 (or <code>pattern</code>) – the pattern to use when splitting the text. By default, this can be a ~~[[:mw:Extension:Scribunto/Lua_reference_manual#Patterns\|~~string library pattern]].		:* 2 (or <code>pattern</code>) – the pattern to use when splitting the text. By default, this can be a string library pattern.
	:* 3 (or <code>plain</code>) – if set to "true", <code>pattern</code> will be interpreted as plain text, not a pattern.		:* 3 (or <code>plain</code>) – if set to "true", <code>pattern</code> will be interpreted as plain text, not a pattern.
	:* 4 (or <code>index</code>) – The chunk to return. If omitted, the first chunk will be returned. Can be set to a negative number to count from the end (e.g. <code>-1</code> will return the last chunk).		:* 4 (or <code>index</code>) – The chunk to return. If omitted, the first chunk will be returned. Can be set to a negative number to count from the end (e.g. <code>-1</code> will return the last chunk).

	=== Examples and test page ===		=== Examples and test page ===
	There are ~~[[:de:Wikipedia:Lua/Modul/Text/Test\|~~tests available]] {{in lang\|de}} to illustrate this in practice.		There are tests available {{in lang\|de}} to illustrate this in practice.

	== {{Anchor\|Lua}} Use in another Lua module ==		== {{Anchor\|Lua}} Use in another Lua module ==
Line 124:		Line 124:
	* <code>Text.removeDiacritics( s )</code>		* <code>Text.removeDiacritics( s )</code>
	* <code>Text.sentenceTerminated( s )</code>		* <code>Text.sentenceTerminated( s )</code>
	* <code>Text.split( text, pattern, plain )</code> – non Unicode version of ~~[[:mw:Extension:Scribunto/Lua_reference_manual#mw.text.split\|~~mw.text.split]]		* <code>Text.split( text, pattern, plain )</code> – non Unicode version of mw.text.split
	* <code>Text.gsplit( text, pattern, plain )</code> – non Unicode version of ~~[[:mw:Extension:Scribunto/Lua_reference_manual#mw.text.gsplit\|~~mw.text.gsplit]]		* <code>Text.gsplit( text, pattern, plain )</code> – non Unicode version of mw.text.gsplit
	* <code>Text.ucfirstAll( s )</code>		* <code>Text.ucfirstAll( s )</code>
	* <code>Text.uprightNonlatin( s )</code>		* <code>Text.uprightNonlatin( s )</code>
Line 135:		Line 135:

	== Dependencies ==		== Dependencies ==
	* [[Module:Yesno]]		* Module:Yesno
	* [[Module:Text/data]] --- Lua patterns and information about quotes		* Module:Text/data --- Lua patterns and information about quotes

	== See also ==		== See also ==