Dzmuh в 06:08, 10 января 2022

2022-01-10T06:08:57Z

← Предыдущая версия		Версия от 06:08, 10 января 2022
Строка 3:		Строка 3:
	{{Модуль из википедии\|String}}		{{Модуль из википедии\|String}}
	</includeonly>		</includeonly>
	~~{{СИШ}}~~
	~~{{Используйте песочницу}}~~

	Этот модуль предназначен для обеспечения доступа к основным строковым функциям.		Этот модуль предназначен для обеспечения доступа к основным строковым функциям.

Dzmuh: Новая страница: «{{docpage}} {{Модуль из википедии|String}} {{СИШ}} {{Используйте песочницу}} Этот мод...»

2022-01-10T06:08:16Z

Новая страница: «{{docpage}} <includeonly> {{Модуль из википедии|String}} </includeonly> {{СИШ}} {{Используйте песочницу}} Этот мод...»

Новая страница

{{docpage}}
<includeonly>
{{Модуль из википедии|String}}
</includeonly>
{{СИШ}}
{{Используйте песочницу}}

Этот модуль предназначен для обеспечения доступа к основным строковым функциям.

Большая часть функций, имеющихся в модуле, может быть вызвана именованными, неименованными параметрами или обоими вариантами. Если используются именованные параметры, движок Mediawiki автоматически удаляет любые начальные или конечные пробелы из параметра. В зависимости от предполагаемого использования может быть предпочтительным либо сохранение, либо удаление таких пробелов. Экспериментировать с модулем можно на странице [[Модуль:String/песочница]].

== Глобальные параметры ==
{|
|{{code|ignore_errors}}:
|Если параметру присвоено значение {{code|true}} или {{code|1}}, вместо любого сообщения об ошибке выводится пустая строка.
|-
|{{code|error_category}}:
|В случае возникновения ошибки определяет название категории, в которую помещается страница с сообщением об ошибке. По умолчанию помещается в {{c|Страницы с ошибками модуля String|В}}.
|-
|{{code|no_category}}:
|Если параметру присвоено значение {{code|true}} или {{code|1}}, то в случае сообщения об ошибке страница не будет помещена в соответствующую категорию.
|}

== subcount ==
Функция возвращает количество подстрок внутри строки.

; Использование

: <code><nowiki>{{#invoke:</nowiki>String|subcount|''исходная_строка''|''подстрока''|''true{{\}}false''}}</code>

: или

: <code><nowiki>{{#invoke:</nowiki>String|subcount|s=''исходная_строка''|pattern=''подстрока''|plain=''true{{\}}false''}}</code>

; Параметры
{|
|{{code|s}}:
|Целевая строка, часть которой необходимо найти.
|-
|{{code|pattern}}:
|Строка, совпадение с которой необходимо найти в целевой строке.
|-
|{{code|plain}}:
|Если параметру присвоено значение {{code|false}}, функция воспринимает заданную строку как [[mw:Extension:Scribunto/Lua reference manual#Patterns|регулярное выражение]]. По умолчанию — {{code|true}}.
|-
|}

== len ==
Функция возвращает длину целевой строки.

; Использование

: <code><nowiki>{{#invoke:</nowiki>String|len|''целевая_строка''}}</code>

: или

: <code><nowiki>{{#invoke:</nowiki>String|len|s= ''целевая_строка'' }}</code>

; Параметры
{|
|{{code|s}}:
|Строка, длину которой необходимо найти.
|}
== sub ==
Функция возвращает часть целевой стоки между указанными индексами (порядковыми номерами символов в целевой строке)

; Использование

: <code><nowiki>{{#invoke:</nowiki>String|sub|''целевая_строка''|''начальный_индекс''|''конечный_индекс''}}</code>

: или

: <code><nowiki>{{#invoke:</nowiki>String|sub|s= ''целевая_строка'' |i= ''начальный_индекс'' |j= ''конечный_индекс'' }}</code>

; Параметры
{|
|{{code|s}}:
|Строка, часть которой необходимо вывести.
|-
|{{code|i}}:
|Порядковый номер символа, начиная с которого необходимо вывести строку. Значение по умолчанию — 1.
|-
|{{code|j}}:
|Порядковый номер символа, до которого необходимо вывести строку. Значение по умолчанию — порядковый номер последнего символа.
|}
Первому символу строки присваивается индекс {{code|1}}. Если параметрам {{code|i}} или {{code|j}} присвоено отрицательное значение, то оно распознается модулем как порядковый номер символа, отсчитываемый с конца строки. Другими словами, значение {{code|-1}} распознается модулем как порядковый номер последнего символа в строке.

Если введённые индексы по модулю больше длины целевой строки, то выводится сообщение об ошибке.

== sublength ==
С помощью этой функции реализован шаблон {{t|Str sub}}, она сохраняется для поддержания его работоспособности.

== match ==
Функция возвращает часть целевой строки, которая соответствует заданной строке.

; Использование

: <code><nowiki>{{#invoke:</nowiki>String|match|''исходная_строка''|''заданная_строка''|''начальный_индекс''|''номер_совпадения''|''true{{\}}false''|''значение_если_нет_совпадений''}}</code>

: или

: <code><nowiki>{{#invoke:</nowiki>String|match|s= ''исходная_строка'' |pattern= ''заданная_строка'' |start= ''начальный_индекс''|match= ''номер_совпадения''|plain= ''true{{\}}false'' |nomatch= ''значение_если_нет_совпадений'' }}</code>

; Параметры
{|
|{{code|s}}:
|Целевая строка, часть которой необходимо найти.
|-
|{{code|pattern}}:
|Строка, совпадение с которой необходимо найти в целевой строке.
|-
|{{code|start}}:
|Порядковый номер символа, начиная с которого необходимо произвести поиск совпадения. По умолчанию — {{code|1}}. Если начиная с заданного символа совпадений не найдено, функция возвращает сообщение об ошибке.
|-
|{{code|match}}:
|В некоторых случаях может оказаться несколько совпадений с заданной строкой в одной целевой строке. Параметр задает номер совпадения, которое необходимо вывести. Если параметру присвоено отрицательное значение, то оно распознается модулем как порядковый номер совпадения, отсчитываемый с конца строки. Другими словами, значение {{code|-1}} распознается модулем как порядковый номер последнего совпадения в строке. По умолчанию — 1.
|-
|{{code|plain}}:
|Если параметру присвоено значение {{code|true}}, функция воспринимает заданную строку как обычный текст, а не [[mw:Extension:Scribunto/Lua reference manual#Patterns|регулярное выражение]]. По умолчанию — {{code|false}}.
|-
|{{code|nomatch}}:
|Последовательность символов, выводимая строкой в случае отсутствия совпадений вместо сообщения об ошибке.
|}
Если введённый индекс по модулю больше длины целевой строки или совпадений найдено меньше, чем число, заданное в параметре {{code|match}}, то выводится сообщение об ошибке.
Если добавить параметр {{code|ignore_errors{{=}}true}}, то вместо любого из сообщений об ошибке будет возвращена пустая строка.

Подробнее о [[Регулярное выражение|регулярных выражениях]], используемых в [[Lua]], см. [[mw:Extension:Scribunto/Lua reference manual#Patterns|Руководство по метасимволам]].

== pos ==
Функция возвращает один символ из целевой строки под заданным порядковым номером.

; Использование

: <code><nowiki>{{#invoke:</nowiki>String|pos|''целевая_строка''|''значение_индекса''}}</code>

: или

: <code><nowiki>{{#invoke:</nowiki>String|pos|target= ''целевая_строка'' |pos= ''значение_индекса'' }}</code>

; Параметры
{|
|{{code|target}}:
|Строка, в которой производится поиск символа.
|-
|{{code|pos}}:
|Порядковый номер возвращаемого символа
|}
Если параметру {{code|pos}} присвоено отрицательное значение, то оно распознается модулем как порядковый номер символа, отсчитываемый с конца строки. Другими словами, значение {{code|-1}} распознается модулем как порядковый номер последнего символа в строке.

Если заданный порядковый номер равен 0 или больше длины строки, функция возвращает сообщение об ошибке.

== str_find ==
Эта фунция предназначена для поддержания функционирования шаблона {{t|str find}}. Она сохраняется для того, чтобы поддерживать существующие шаблоны, но она '''крайне не рекомендуется''' для использования в новых шаблонах. Рекомендуется вместо неё использовать функцию {{code|find}}.

Возвращает порядковый номер символа, начиная с которого целевая строка, заданная параметром {{code|source}} совпадает со строкой в параметре {{code|target}}. Функция возвращает <code>−1</code>, если совпадений между строками не найдено.

'''Важно''': Если в параметре {{code|target}} не задана строка, либо отсутствует сам параметр, функция возвращает <code>1</code>, что, как правило, является полной неожиданностью для пользователей.

== find ==
Функция позволяет выполнить поиск целевой строки в другой строке.

; Использование

: <code><nowiki>{{#invoke:</nowiki>String|find|''исходная_строка''|''целевая_строка''|''начальный_индекс''|''true{{\}}false''}}</code>

: или

: <code><nowiki>{{#invoke:</nowiki>String|find|source= ''исходная_строка'' |target= ''целевая_строка'' |start= ''начальный_индекс''|plain= ''true{{\}}false'' }}</code>

; Параметры
{|
|{{code|source}}:
|Строка, в которой ведется поиск целевой строки.
|-
|{{code|target}}:
|Целевая строка, которая ищется в другой строке.
|-
|{{code|start}}:
|Порядковый номер символа, начиная с которого ведется поиск совпадений. Значение по умолчанию — 1.
|-
|{{code|plain}}:
|Если параметру присвоено значение {{code|true}}, функция воспринимает заданную строку как обычный текст, а не [[mw:Extension:Scribunto/Lua reference manual#Patterns|регулярное выражение]]. По умолчанию — {{code|true}}.
|}
Функция возвращает значение, большее либо равное значению параметра {{code|start}}. Если совпадений не найдено, функция возвращает <code>0</code>, если одна из строк пустая или не задана, функция также возвращает <code>0</code>.

== replace ==
Функция позволяет заменить целевую строку в другой строке.

; Использование

: <code><nowiki>{{#invoke:</nowiki>String|replace|''исходная_строка''|''целевая_строка''|''заменяющая_строка''|''количество_замен''|''true{{\}}false''}}</code>

: или

: <code><nowiki>{{#invoke:</nowiki>String|replace|source= ''исходная_строка'' |pattern= ''целевая_строка''|replace= ''заменяющая_строка'' |count= ''количество_замен'' |plain= ''true{{\}}false'' }}</code>

; Параметры
{|сlass="simple"
|{{code|source}}:
|Строка, в которой ведется поиск.
|-
|{{code|pattern}}:
|Строка, которая ищется в исходной строке.
|-
|{{code|replace}}:
|Строка, заменяющая целевую.
|-
|{{code|count}}:
|Количество заменяемых совпадений; по умолчанию — все.
|-
|{{code|plain}}:
|Если параметру присвоено значение {{code|true}}, функция воспринимает заданную строку как обычный текст, а не [[mw:Extension:Scribunto/Lua reference manual#Patterns|регулярное выражение]]. По умолчанию — {{code|true}}.
|}

== rep ==
Функция возвращает строку, состоящую из повторений ''n'' раз исходной строки.

; Использование

: <code><nowiki>{{#invoke:</nowiki>String|rep|''строка''|''количество_повторов''}}</code>

; Параметры
{|
|{{code|source}}:
|Строка, которую необходимо повторить ''n'' раз.
|-
|{{code|count}}:
|Количество повторов.
|}
; Пример
<code><nowiki>{{#invoke:String|rep|привет!|3}}</nowiki></code> → {{#invoke:String|rep|привет!|3}}

<includeonly>
[[Категория:Модули:Базовые]]
[[Категория:Модули:Работа со строками]]
</includeonly>
<noinclude>
[[Категория:Модули:Документация]]
</noinclude>

Модуль:String/doc - История изменений

Dzmuh в 06:08, 10 января 2022

Dzmuh: Новая страница: «{{docpage}} {{Модуль из википедии|String}} {{СИШ}} {{Используйте песочницу}} Этот мод...»