Шаблон:Str sub/doc

Внимание! Это один из самых используемых шаблонов.

Каждое его изменение создаёт дополнительную нагрузку на серверы проекта. Пожалуйста, убедитесь в адекватности и правильности ваших изменений, проверьте их на тестовых страницах.

Прежде чем вносить какие-либо изменения в данный шаблон, просьба оттестировать их в /песочнице и проверить результат на странице с /контрольными примерами. Изменения могут быть внесены после этого в данный шаблон всего одной правкой.

Этот шаблон реализован на основе Lua с использованием функции sublength() из модуля String.

ИспользованиеПравить

{{str sub|text|start|length}} = Подстрока из text, которая начинается со start и имеет длину length символов. Первый символ нумеруется с 0.

ПримерыПравить

{{str sub|20090624130510|8|4}} возвращает 4 символа, начиная с 9-й позиции: 1305

См. такжеПравить

{{str sub new}}

TemplateDataПравить

Шаблон предназначен для получения подстроки символов из исходной строки, указанной в первом параметре, начиная с левой позиции (начиная с нуля), указанной вторым параметром, заданной длины, указанной третьим параметром.

Параметры шаблона
Параметр		Описание	Тип	Статус
text	`1`	исходная строка	Строковый (без форматирования)	обязательный
start	`2`	Номер символа, с которого берется подстрока. Первый символ исходной строки нумеруется с 0. По умолчанию 0	Число	необязательный
length	`3`	длина подстроки По умолчанию 0	Число	необязательный

Шаблоны обработки строк

Обрезка строк

По подсчёту

{{str mid}}	Выводит подстроку длиной L, начиная с позиции N.
{{trunc}}	Выводит символы от начала строки до N или дублирует строку до N символов.
{{str left}}	Выводит символы от начала строки до N или дублирует строку до N символов.
{{str crop}}	Удаляет с правой стороны строки N символов.
{{обрезать слева и справа}}	Удаляет с обеих сторон строки N символов.

{{str right}}	Выводит символы от N до конца строки.
{{str rightc}}	Выводит правую часть строки из заданного количества символов.
{{str sub}}	Удаляет слева N символов и оставляет L.
{{str sub new}}	Выбирает из строки подстроку на основе выбранных индексов.
{{str index}}	Выводит из строки один символ под номером N.

По проверке

{{delink}}	Удаляет из строки Тептар ссылки, оставляя их текст.
{{удалить теги}}	Удаляет из строки все html-теги, оставляя их содержимое.
{{удалить префикс файла}}	Вырезает из названия файла пространство имён.
{{str trim}}	Удаляет пробелы справа и слева.
{{-.}}	Удаляет из конца строки точку (одну).
{{-года}}	Удаляет из строки все вхождения слов «год», «года», «г.» и «гг.».
{{без кв. скобок}}	Удаляет из строки крайние парные квадратные скобки.
{{без начала}}	Удаляет из строки подстроку, совпадающую с началом строки.
{{без пунктуации}}	Удаляет из строки знаки пунктуации.
{{без символа}}	Удаляет из строки первое вхождение символа.

{{без уточнения}}	Удаляет из строки уточнение в скобках, если таковое имеется.
{{без кириллицы}}	Удаляет из строки все кириллические символы.
{{без латиницы}}	Удаляет из строки все латинские символы.
{{без цифр}}	Удаляет из строки все цифры.
{{только цифры}}	Удаляет из строки всё, кроме цифр.
{{только число}}	Извлекает из строки первое число.
{{год из заголовка}}	Выводит первое четырёхзначное число из заголовка.
{{доменное имя}}	Выводит доменное имя сайта по заданному URL.
{{до символа}}	Выводит строку до указанного символа.
{{после символа}}	Выводит строку после указанного символа.
{{первое слово}}	Выводит первое слово в строке.
{{удалить первое слово}}	Удаляет первое слово в строке.
{{последнее слово}}	Выводит последнее слово в строке.
{{удалить последнее слово}}	Удаляет последнее слово в строке.

Вставка и замена строк

{{вставить строку}}	Вставляет подстроку в указанное место строки или приписывает её к концу, если `strloc` <= 0.
{{multi}}	Выводит строку указанное количество раз.
{{replace}}	Заменяет в строке все включения подстроки.
{{multireplace}}	Заменяет в строке несколько символов или групп символов.
{{без кирлата}}	Исправляет текст, набранный смесью визуально неразличимой кириллицы и латиницы, заменяя латинские буквы идентичными по начертанию кириллическими и наоборот.
{{str rep}}	Заменяет в строке указанное количество включений подстроки.
{{в 2 кв. скобках}}	Тептар фицирует первый параметр, если он не Тептар фицирован.
{{вложенные кавычки}}	Заменяет в строке все парные кавычки-ёлочки («») на кавычки-лапки („“).
{{курсив или кавычки}}	Если строка содержит кириллицу, оборачивает её в кавычки, если латиницу, выделяет курсивом.
{{курсив или нет}}	Если строка содержит латиницу, выделяет её курсивом.

{{локатив}}	Переводит слова в предложный падеж (препозитив).
{{в стране}}	Де Тептар фицирует и переводит в предложный падеж название страны с добавлением предлога.
{{страна в родительном падеже}}	Де Тептар фицирует и переводит в родительный падеж название страны.
{{нр}}	Переводит видимую часть ссылки в нижний регистр.
{{первое последним}}	Делает первое слово строки последним.
{{сначала имя}}	Меняет порядок с «Фамилия, Имя Отчество» на «Имя Отчество Фамилия».
{{год-года-лет}}	Добавляет к цифровой записи количества лет слово «год», «года» или «лет» в нужном числе и падеже.
{{+года}}	Добавляет к последней цифре слово «года».
{{±.}}	Добавляет точку к концу произвольного текста, если её там нет.
{{.±}}	Делает то же, что и предыдущий, но различает в конце параметра неразрывный пробел.

Анализ строк

{{str len}}	Выводит длину строки в символах.
{{str ≥ len}}	Проверяет, больше или равна длина строки в символах указанному числу.
{{str ≤ len}}	Проверяет, меньше или равна длина строки в символах указанному числу.
{{str ≠ len}}	Проверяет, равна ли длина строки в символах указанному числу.
{{str ≤ ≥ len}}	Сравнивает длину строки с заданным числом.

{{str endswith}}	Проверяет, заканчивается ли строка указанной подстрокой.
{{str find}}	Выводит позицию первого вхождения подстроки в текст.
{{str sub find}}	Ищет в строке подстроку с заданным отступом от начала.
{{is numeric}}	Проверяет, является ли строка числом.