Документация

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

Символы в исходной строке нумеруются с единицы до длины строки. Подстрока определятся двумя индексами. {{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}} — индексы нумеруются с нуля.