Модуль:Random/doc

Этот модуль содержит ряд функций, использующих случайные числа. Он может вернуть случайное число, выбрать случайный элемент списка или перемешать список случайным образом. Перемешанные списки могут быть выведены в строчку или в виде нумерованных или ненумерованных списков различных видов. Доступные функции описаны более подробно ниже.

Number

Функция number возвращает случайное число.

{{#invoke:random|number|m|n|same=yes}}

Аргументы m и n могут быть опущены, однако в случае, если они заданы, они должны быть приводимы к целым числам.

• При вызове без параметров возвращает вещественное число в полуинтервале $[0,1)$.
• При вызове с одним параметром возвращает целое число из интервала $[1,m]$. m должно быть положительным.
• При вызове с двумя параметрами возвращает целое число из интервала $[m,n]$. m и n могут быть как положительными, так и отрицательными. Если m больше n, возвращает целое число из интервала $[n,m]$.
• Если параметру |same = присвоено одно из значений «yes», «y», «true» или «1», одно и то же случайное число возвращается для каждого вызова модуля на данной странице.

Примеры ()

• {{#invoke:random|number}} → 0.96543342525392
• {{#invoke:random|number|100}} → 18
• {{#invoke:random|number|-100|-50}} → -68
• {{#invoke:random|number|100|same=yes}} → 79
• {{#invoke:random|number|100|same=yes}} → 79

Документация этой функции частично скопирована из справки по Scribunto Lua, в свою очередь основанной на справке по Lua 5.1, доступной под лицензией MIT.

Date

Функция date возвращает случайную дату.

{{#invoke:random|date|метка1|метка2|format=формат даты|same=yes}}

• Если ни одна из временных меток не задана, модуль возвращает случайную дату текущего года.
• Если заданы параметры метка1 и метка2, модуль возвращает случайную дату между данными двумя временными метками. метка1 должна быть раньше метка2.
• Если задан только параметр метка1, модуль возвращает случайную дату между «эрой Unix» (1 января 1970) и временной меткой. Метка метка1 не должна быть раньше 1 января 1970.
• Форматирование может быть задано параметром |format =. Форматирование по умолчанию — «hh:mm, DD Month YYYY (UTC)» (аналогично форматированию по умолчанию временных меток Википедии).
• Временные метки и параметр |format = поддерживают значения, совместимые с функцией парсера #time. Обратитесь к документации #time для получения полного списка возможных входных значений и опций форматирования.
• Если параметру |same = присвоено одно из значений «yes», «y», «true» или «1», одна и та же дата возвращается для каждого вызова модуля на данной странице.

Примеры ()

• {{#invoke:random|date}} → 06:17, 20 январь 2024 (UTC)
• {{#invoke:random|date|format=F j}} → декабрь 13
• {{#invoke:random|date|1 Jan 1980|31 Dec 1999}} → 13:06, 03 сентябрь 1984 (UTC)
• {{#invoke:random|date|1st January 1500|1st January 3000|format=g:i a, l d M Y}} → 2:36 am, четверг 01 окт 2854
• {{#invoke:random|date|1970/06/01}} → 19:28, 20 февраль 1970 (UTC)
• {{#invoke:random|date|same=yes}} → 02:07, 13 октябрь 2024 (UTC)
• {{#invoke:random|date|same=yes}} → 02:07, 13 октябрь 2024 (UTC)

Item

Функция item возвращает случайный элемент списка.

{{#invoke:random|item|элемент списка 1|элемент списка 2|элемент списка 3|...|same=yes}}

Если параметру |same = присвоено одно из значений «yes», «y», «true» или «1», один и тот же элемент возвращается для каждого вызова модуля на данной странице.

Пример ()

• {{#invoke:random|item|egg|beans|sausage|bacon|spam}} → egg
• {{#invoke:random|item|egg|beans|sausage|bacon|spam|same=yes}} → sausage
• {{#invoke:random|item|egg|beans|sausage|bacon|spam|same=yes}} → sausage

List

Функция list возвращает список в случайном порядке.

{{#invoke:random|list|элемент списка 1|элемент списка 2|элемент списка 3|...|sep=разделитель|limit=сколько элементов отображать|same=yes}}

Именованные параметры

• |sep = или |separator = — опциональный разделитель списка элементов. Некоторые значения зарезервированы, см. таблицу ниже.
• |limit = — максимальное число отображаемых элементов списка. Наименьшее возможное значение — 0, наибольшее — число элементов в списке.
• Если параметру |same = присвоено одно из значений «yes», «y», «true» или «1», один и тот же список возвращается для каждого вызова модуля на данной странице.

Возможные значения разделителя

Код	Вывод
dot	·
pipe	|
comma	,
tpt-languages	⧼tpt-languages-separator⧽
space	пробел
newline	символ перевода строки
любое другое значение	остальные значения используются без изменения

Передать пробелы в параметр |sep = невозможно из-за ограничений, накладываемых синтаксисом шаблонов в MediaWiki. Однако их можно обойти, используя мнемоники HTML. Используйте   для представления обычного пробела и   для представления неразрывного пробела.

Примеры ()

• {{#invoke:random|list|egg|beans|sausage|bacon|spam}} → beansspameggbaconsausage
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|sep=dot}} → bacon · beans · egg · spam · sausage
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|sep=space}} → beans bacon sausage egg spam
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|sep=; }} → beans; bacon; spam; sausage; egg
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|sep=foo}} → baconfoobeansfoospamfooeggfoosausage
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|limit=3}} → eggbaconsausage
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|same=yes}} → spameggbeansbaconsausage
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|same=yes}} → spameggbeansbaconsausage

Text list

Функция text_list возвращает список в случайном порядке в виде связанного текста. Другими словами, эта функция работает так же, как функция list, но использует другой разделитель перед последним элементом.

{{#invoke:random|text_list|элемент списка 1|элемент списка 2|элемент списка 3|...|sep=разделитель|conj=союз|limit=сколько элементов отображать|same=yes}}

Разделитель может быть задан параметрами |sep = или |separator =; значение по умолчанию — «, ». Союз может быть задан параметрами |conj = или |conjunction =; значение по умолчанию — « и ». В параметры разделителя и союза могут быть переданы те же значения, что и в параметр разделителя в функции list.

Максимальное число отображаемых элементов списка может быть задано параметром |limit =. Наименьшее возможное значение — 0, наибольшее — число элементов в списке.

Если параметру |same = присвоено одно из значений «yes», «y», «true» или «1», один и тот же список возвращается для каждого вызова модуля на данной странице.

Примеры ()

• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam}} → bacon, spam, egg, beans и sausage
• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam|sep=; }} → bacon; spam; sausage; beans и egg
• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam|sep=; |conj= или }} → spam; egg; beans; sausage или bacon
• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam|limit=3}} → egg, bacon и spam
• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam|same=yes}} → spam, egg, beans, bacon и sausage
• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam|same=yes}} → spam, egg, beans, bacon и sausage

HTML-списки

Если вы хотите вывести HTML-список в случайном порядке, вы можете выбрать одну из пяти функций: bulleted_list, unbulleted_list, horizontal_list, ordered_list, и horizontal_ordered_list. Все эти функции используют Модуль:List.

Название функции	Создаёт	Код примера	Вывод примера ()
bulleted_list	Маркированный список	{{#invoke:random|bulleted_list|egg|sausage|spam}}	egg spam sausage
unbulleted_list	Немаркированный список	{{#invoke:random|unbulleted_list|egg|sausage|spam}}	sausage spam egg
horizontal_list	Горизонтальный маркированный список	{{#invoke:random|horizontal_list|egg|sausage|spam}}	egg spam sausage
ordered_list	Упорядоченный список (нумерованные и алфавитные списки)	{{#invoke:random|ordered_list|egg|sausage|spam}}	egg spam sausage
horizontal_ordered_list	Горизонтальный упорядоченный список	{{#invoke:random|horizontal_ordered_list|egg|sausage|spam}}	egg sausage spam

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

{{#invoke:random|функция|элемент списка 1|элемент списка 2|элемент списка 3|...|limit=сколько элементов отображать|same=yes}}

Все параметры

{{#invoke:random|функция
|первый элемент|второй элемент|третий элемент|...
|start           = начальное число для упорядоченного списка
|type            = тип маркера для упорядоченного списка
|list_style_type = тип маркера для упорядоченного списка (использует CSS)
|class           = класс
|style           = стиль
|list_style      = стиль списка
|item_style      = стиль всех элементов списка
|item_style1     = стиль первого элемента списка |item_style2 = стиль второго элемента списка |...
|indent          = отступ для горизонтальных списков
}}

Максимальное число отображаемых элементов списка может быть задано параметром |limit =. Наименьшее возможное значение — 0, наибольшее — число элементов в списке.

Если параметру |same = присвоено одно из значений «yes», «y», «true» или «1», один и тот же список возвращается для каждого вызова модуля на данной странице.

Посетите документацию Модуля:List для получения полной информации по остальным параметрам.

См. также

• {{случайное число}}
• {{случайный элемент}}
• {{очищать кэш}} — для периодической пересборки страницы