Википедия:Функции парсера: различия между версиями

{{shortcut|ВП:ПАРС|ВП:Парсер}}

{{о|расширении для MediaWiki|базовых функциях парсера|mw:Help:Magic words/ru#Функции парсера}}

 

{{''#функция'': ''аргумент 1'' | ''аргумент 2'' | ''аргумент 3'' ... }}

 

 

Для формирования таблицы можно также использовать язык [[HTML]]:

 

=== #expr ===

Функция <tt>#expr</tt> производит математические вычисления над числами или переменными/параметрами, приводимыми к числам. Синтаксис:

 

|-

! round

| <tt><nowiki>{{#expr: 30 / 7 round 3 }}</nowiki></tt> = {{#expr: 30 / 7 round 3 }}<br>

<tt><nowiki>{{#expr: 30 / 7 round 0 }}</nowiki></tt> = {{#expr: 30 / 7 round 0 }}<br>

 

=== #if ===

Функция <tt>#if</tt> («если») служит для создания конструкций вида if-then-else. Её синтаксис таков:

 

<nowiki>{{</nowiki>#if: ''тестовая строка'' | ''текст, если непуста'' | ''текст, если пуста'' <nowiki>}}</nowiki>

 

 

 

 

=== #ifeq ===

Функция <tt>#ifeq</tt> («if equal», «если равны») сравнивает две строки, возвращая ещё одну строку в зависимости от результата сравнения. Её синтаксис таков:

 

 

=== #ifexist ===

Функция <tt>#ifexist</tt> («if exist», «если существует») похожа по синтаксису на <tt>#if</tt>, только вместо условия проверяется существование статьи с указанным заголовком. Проверка выполняется с учётом регистра после приведения проверяемого заголовка к каноническому виду (если в начале стоит строчная буква, то она преобразуется в прописную). Например:

: <tt><nowiki>{{#ifexist: User:Js | Участник есть | Участника нет }}</nowiki></tt> вернёт <tt>{{#ifexist: User:Js | Участник есть | Участника нет }}</tt>, поскольку страница [[User:Js]] существует.

<nowiki>{{#ifexist}}</nowiki> не работает с относительными путями типа [[/подстраница]].

 

 

Пример (файл [[:Файл:Example.png|Example.png]] загружен только на Викисклад):

Также работает с параметрами шаблонов.

 

 

=== #ifexpr ===

<tt>#ifexpr</tt> вычисляет математическое выражение и возвращает одну из двух строк в зависимости от результата.

 

 

=== #switch ===

<tt>#switch</tt> сравнивает одно значение со многими, возвращая результат, если найдено совпадение. Если совпадение не найдено, то возвращается указанный в конце записи результат по умолчанию (он обязательно должен быть последним). Наличие этого результата необязательно, и в случае отсутствия его и совпадений ничего возвращено не будет.

 

 

=== #time ===

<nowiki>{{</nowiki>#time: ''формат'' <nowiki>}}</nowiki>

<nowiki>{{</nowiki>#time: ''формат'' | ''время'' <nowiki>}}</nowiki>

| {{#time: U }}

|}

{| cellpadding="6" class="standard"

! Символ

|--------------

| xr

|--------------

| xx

|}

Все другие символы будут выведены без изменений.

** <tt><nowiki>{{#time: "Сегодня" l }}</nowiki></tt></tt> → {{#time: "Сегодня" l }}

* Наклонная черта влево работает так же, как и в PHP-функции [http://ru2.php.net/date date()]. <tt>\H</tt> выводит <tt>H</tt>, <tt>\<nowiki>"</nowiki></tt> выводит <tt><nowiki>"</nowiki></tt>{{прояснить}}.

 

Формат параметра ''время'' идентичен используемому в PHP-функции [http://ru2.php.net/strtotime strtotime()]. Это могут быть абсолютные и относительные даты, например «December 11»<ref group=t>Русские даты типа «11 декабря» на данный момент не работают, если очень нужно их обработать, попробуйте шаблон {{tl|Date Converter}}.</ref> и/или «+10 hours», что может использоваться для перевода временных зон. Если вам нужно перевести в дату метку времени UNIX, поставьте перед ней <tt>@</tt>.

 

* <tt><nowiki>{{#time: H:i | +4 hours }}</nowiki></tt> → {{#time: H:i | +4 hours }} ''(UTC+4)''

* <tt><nowiki>{{#time: H:i | 8:15 +6 hours }}</nowiki></tt> → {{#time: H:i | 8:15 +6 hours }}

* <tt><nowiki>{{#time: r | @1483057398 }}</nowiki></tt> → {{#time: r | @1483057398 }}

<div style="padding-left:1em;"><references group=t/></div>

 

=== #rel2abs ===

Функция <tt>#rel2abs</tt> преобразует относительный путь ссылки в абсолютный.

 

 

Если путь, передаваемый функции в качестве параметра, не идентифицирован как относительный путь, функция вернёт в качестве результата его. Например:

 

=== #titleparts ===

Функция <tt>#titleparts</tt> возвращает подстроку до нужного слэша. Основной целью является возможность получения страниц всех уровней, для которых данная является подстраницей.

 

: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/<span style="color: blue;">bar/baz/quok</span> <nowiki>| | 2 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | | 2 }}'''

 

: <code><nowiki>{{#titleparts:</nowiki> <span style="color: blue;">{{ns:1}}:Foo/bar/baz</span>/quok <nowiki>| -1 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | -1 }}''' {{nbsp}}<small>Опускает один сегмент с конца строки. См. также {{mwmw|BASEPAGENAME}}.</small>

: <code><nowiki>{{#titleparts:</nowiki> {{ns:1}}:Foo/bar/baz/quok <nowiki>| -4 }}</nowiki></code> → '''{{#titleparts: {{ns:1}}:Foo/bar/baz/quok | -4 }} ''' <small>Опускает все 4 сегмента с конца строки.</small>

 

----

 

Строки более 255 символов всегда возвращаются как переданы.

 

=== #iferror ===

<nowiki>{{</nowiki>#iferror: ''выражение'' | ''ошибка'' | ''удачно'' <nowiki>}}</nowiki>

Возвращает ''ошибку'', если ''выражение'' содержит строку <tt><nowiki><strong class="error"></nowiki></tt>, которая генерируется функциями <tt>#expr</tt>, <tt>#ifexpr</tt>, <tt>#time</tt>, <tt>#rel2abs</tt> и в некоторых других ситуациях в MediaWiki (такими как глубокая рекурсия). Это самый удобный способ отлавливать неправильный ввод, который должен быть передан некоторым другим функциям парсера. Например:

 

См. также: [[rev:29774|r29774]], [[rev:29775|r29775]], [[rev:29877|r29877]].

<!--== Установка ==

Скачайте указанные ниже файлы и установите их в новую директорию ''ParserFunctions'' в [[m:Mediawiki extensions|директории расширений MediaWiki]].

* [[Википедия:Шаблоны/Работа со строками]]

* [[Википедия:Переменные]]

 

== История установки расширения ==