Каждое его изменение создаёт дополнительную нагрузку на серверы проекта. Пожалуйста, убедитесь в адекватности и правильности ваших изменений, проверьте их на тестовых страницах. Узнать число включений.
Этот модуль предназначен для обеспечения доступа к основным строковым функциям.
Большая часть функций, имеющихся в модуле, может быть вызвана именованными, неименованными параметрами или обоими вариантами. Если используются именованные параметры, движок Mediawiki автоматически удаляет любые начальные или конечные пробелы из параметра. В зависимости от предполагаемого использования может быть предпочтительным либо сохранение, либо удаление таких пробелов. Экспериментировать с модулем можно на странице Модуль:String/песочница.
Если параметру присвоено значение true или 1, вместо любого сообщения об ошибке выводится пустая строка.
error_category:
В случае возникновения ошибки определяет название категории, в которую помещается страница с сообщением об ошибке. По умолчанию помещается в категорию «Страницы с ошибками модуля String».
no_category:
Если параметру присвоено значение true или 1, то в случае сообщения об ошибке страница не будет помещена в соответствующую категорию.
subcount
Функция возвращает количество подстрок внутри строки.
Порядковый номер символа, начиная с которого необходимо вывести строку. Значение по умолчанию — 1.
j:
Порядковый номер символа, до которого необходимо вывести строку. Значение по умолчанию — порядковый номер последнего символа.
Первому символу строки присваивается индекс 1. Если параметрам i или j присвоено отрицательное значение, то оно распознается модулем как порядковый номер символа, отсчитываемый с конца строки. Другими словами, значение -1 распознается модулем как порядковый номер последнего символа в строке.
Если введённые индексы по модулю больше длины целевой строки, то выводится сообщение об ошибке.
sublength
С помощью этой функции реализован шаблон {{Str sub}}, она сохраняется для поддержания его работоспособности.
match
Функция возвращает часть целевой строки, которая соответствует заданной строке.
Строка, совпадение с которой необходимо найти в целевой строке.
start:
Порядковый номер символа, начиная с которого необходимо произвести поиск совпадения. По умолчанию — 1. Если начиная с заданного символа совпадений не найдено, функция возвращает сообщение об ошибке.
match:
В некоторых случаях может оказаться несколько совпадений с заданной строкой в одной целевой строке. Параметр задает номер совпадения, которое необходимо вывести. Если параметру присвоено отрицательное значение, то оно распознается модулем как порядковый номер совпадения, отсчитываемый с конца строки. Другими словами, значение -1 распознается модулем как порядковый номер последнего совпадения в строке. По умолчанию — 1.
plain:
Если параметру присвоено значение true, функция воспринимает заданную строку как обычный текст, а не регулярное выражение. По умолчанию — false.
nomatch:
Последовательность символов, выводимая строкой в случае отсутствия совпадений вместо сообщения об ошибке.
Если введённый индекс по модулю больше длины целевой строки или совпадений найдено меньше, чем число, заданное в параметре match, то выводится сообщение об ошибке.
Если добавить параметр ignore_errors=true, то вместо любого из сообщений об ошибке будет возвращена пустая строка.
Если параметру pos присвоено отрицательное значение, то оно распознается модулем как порядковый номер символа, отсчитываемый с конца строки. Другими словами, значение -1 распознается модулем как порядковый номер последнего символа в строке.
Если заданный порядковый номер равен 0 или больше длины строки, функция возвращает сообщение об ошибке.
str_find
Эта фунция предназначена для поддержания функционирования шаблона {{str find}}. Она сохраняется для того, чтобы поддерживать существующие шаблоны, но она крайне не рекомендуется для использования в новых шаблонах. Рекомендуется вместо неё использовать функцию find.
Возвращает порядковый номер символа, начиная с которого целевая строка, заданная параметром source совпадает со строкой в параметре target. Функция возвращает −1, если совпадений между строками не найдено.
Важно: Если в параметре target не задана строка, либо отсутствует сам параметр, функция возвращает 1, что, как правило, является полной неожиданностью для пользователей.
find
Функция позволяет выполнить поиск целевой строки в другой строке.
Порядковый номер символа, начиная с которого ведется поиск совпадений. Значение по умолчанию — 1.
plain:
Если параметру присвоено значение true, функция воспринимает заданную строку как обычный текст, а не регулярное выражение. По умолчанию — true.
Функция возвращает значение, большее либо равное значению параметра start. Если совпадений не найдено, функция возвращает 0, если одна из строк пустая или не задана, функция также возвращает 0.
replace
Функция позволяет заменить целевую строку в другой строке.
