Шаблон:Str mid/doc

Материал из Тептар — свободной энциклопедии
< Шаблон:Str mid
Версия от 23:44, 31 января 2022; Mansur700 (обсуждение | вклад) (Новая страница: «{{docpage}} {{onLua|String|pos}} * {{tl|Str mid}} * {{tl|Str mid/core}} * {{tl|Str mid/testcases}} == Использование == Символы в исход...»)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску
  • {{Str mid}}
  • {{Str mid/core}}
  • {{Str mid/testcases}}

Использование[править код]

Символы в исходной строке нумеруются с единицы до длины строки. Подстрока определятся двумя индексами. {{str mid|<строка>|<индекс первого символа>|<длина подстроки>|<индекс последнего символа>}}

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|5|3}} → efg

Если второй параметр опущен, подстрока берётся с начала строки:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz||5}} → Abcde

Если третий параметр опущен, подстрока берётся до конца строки:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|15}} → opqrstuvwxyz

Если вместо третьего параметра задать четвёртый, то будет возвращена подстрока по символ с таким номером:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|5||7}} → efg

Подсчёт с конца[править код]

При введении отрицательных значений, индексы считаются с обратной стороны:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|-7|4}} → tuvw
  • {{str mid|Abcdefghijklmnopqrstuvwxyz|-7}} → tuvwxyz

Пробелы[править код]

В результирующей строке пробелы обрезаются:

  • >{{str mid|I like this.|2|6}}< → >like<

Исходная строка до обработки от них тоже избавляется:

  • >{{str mid| I like this. |2|6}}< → >like<

Сообщения об ошибках[править код]

При выходе за границы строки выбрасывается ошибка:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|30}}Ошибка модуля String: Значение индекса подстроки выходит за допустимые границы
  • {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45}}Ошибка модуля String: Значение индекса подстроки выходит за допустимые границы

При установке |ignore errors=true вместо ошибки возвращается пустая строка:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45|ignore errors=true}}

Категория ошибок[править код]

  • |no category=true отключает добавление в категорию.
  • |error category=[[Категория:Название категории]] позволяет заменять категорию, в которую заносятся страницы с ошибками.
По умолчанию используется Категория:Страницы с ошибками модуля String.

См. также[править код]

  • {{str sub}} — индексы нумеруются с нуля.