Модул:Рандом/доc
| Бу модулдан кўплаб саҳифада фойдаланилган. Тажриба ўтказиш учун модулнинг /қумлоқ ёки /тест осцаҳифаларидан фойдаланинг. Ўзгаришлар киритишдан аввал бошқа фойдаланувчилар билан муҳокама қилиш ҳақида ўйлаб кўринг. |
| Тҳис модуле ис субжеcт то паге протеcтион. Ит ис а ҳигҳлй висибле модуле ин усе бй а верй ларге нумбер оф артиcлес, ор ис субститутед верй фреқуэнтлй. Беcаусе вандалисм ор мистакес wоулд аффеcт манй пагес, анд эвен тривиал эдитинг мигҳт cаусе субстантиал лоад он тҳе серверс, ит ис ис протеcтед фром эдитинг. |
| Бу андоза қуйидаги Луадан фойдаланади: |
Тҳис модуле cонтаинс а нумбер оф фунcтионс тҳат усе рандом нумберс. Ит cан оутпут рандом нумберс, селеcт а рандом итем фром а лист, анд реордер лисц рандомлй. Тҳе рандомлй реордеред лисц cан бе оутпут инлине, ор ас вариоус тйпес оф ордеред анд унордеред лисц. Тҳе аваилабле фунcтионс аре оутлинед ин море детаил белоw.
Нумбер
Тҳе нумбер фунcтион оутпуц а рандом нумбер.
{{#инвоке:рандом|нумбер|м|н|саме=ес}}
Тҳе аргуменц м анд н май бе омиттед, бут иф спеcифиэд муст бе cонвертибле то интегерс.
- Wитҳ но аргуменц, ретурнс а реал нумбер ин тҳе ранге .
- Wитҳ оне аргумент, ретурнс ан интегер ин тҳе ранге , ор, иф
мис негативе, . Ифмис эқуал то 0 ор 1, ретурнс 1 (ор 0 иф ). - Wитҳ тwо аргуменц, ретурнс ан интегер ин тҳе ранге .
манднcан бе эитҳер поситиве ор негативе. Ифмис греатер тҳанн, ретурнс ан интегер ин тҳе ранге инстеад. - Иф тҳе
|саме=параметер ис сет то "ес", "й", "труэ", ор "1", тҳе саме рандом нумбер ис ретурнед фор эач модуле cалл он а гивен паге.
Эхамплес ()
{{#инвоке:рандом|нумбер}}→ 0.86957812955118{{#инвоке:рандом|нумбер|100}}→ 78{{#инвоке:рандом|нумбер|-100|-50}}→ -86{{#инвоке:рандом|нумбер|100|саме=ес}}→ 65{{#инвоке:рандом|нумбер|100|саме=ес}}→ 65
Тҳе доcументатион фор тҳис фунcтион ис партлй такен фром тҳе Сcрибунто Луа референcе мануал, wҳич ис ин турн басед он тҳе Луа 5.1 Референcе Мануал, аваилабле ундер тҳе МИТ Лиcенсе.
Дате
Тҳе дате фунcтион оутпуц а рандом дате.
{{#инвоке:рандом|дате|тиместамп1|тиместамп2|формат=дате формат|саме=ес}}
- Иф но тиместамп аргуменц аре спеcифиэд, тҳе модуле оутпуц а рандом дате ин тҳе cуррент еар.
- Иф
тиместамп1андтиместамп2аре спеcифиэд, тҳе модуле оутпуц а рандом дате бетwеэн тҳе тwо тиместампс.тиместамп1муст бе эарлиэр тҳантиместамп2. - Иф онлй
тиместамп1ис спеcифиэд, тҳе модуле оутпуц а рандом дате бетwеэн тҳе Уних эпоч (1 Жан 1970) анд тҳе тиместамп.тиместамп1муст нот бе эарлиэр тҳан 1 Жан 1970. - Форматтинг cан бе спеcифиэд wитҳ тҳе
|формат=параметер. Тҳе дефаулт форматтинг ис "ҳҳ:мм, ДД Монтҳ ЙЙЙЙ (УТC)" (тҳе саме ас тҳе дефаулт ЗиёСфера тиместамп). - Тҳе тиместампс анд тҳе
|формат=параметер аccепт валуэс cомпатибле wитҳ тҳе #тиме парсер фунcтион. Плеасе сеэ тҳе #тиме доcументатион фор тҳе фулл ранге оф поссибле инпут валуэс анд форматтинг оптионс. - Иф тҳе
|саме=параметер ис сет то "ес", "й", "труэ", ор "1", тҳе саме дате ис ретурнед фор эач модуле cалл он а гивен паге.
Эхамплес ()
{{#инвоке:рандом|дате}}→ 03:03, 31 июл 2026 (УТC){{#инвоке:рандом|дате|формат=Ф ж}}→ август 18{{#инвоке:рандом|дате|1 Жан 1980|31 Деc 1999}}→ 16:15, 06 март 1990 (УТC){{#инвоке:рандом|дате|1ст Жануарй 1500|1ст Жануарй 3000|формат=г:и а, л д М Й}}→ 9:15 пм, Душанба 20 ной 1899{{#инвоке:рандом|дате|1970/06/01}}→ 05:20, 21 январ 1970 (УТC){{#инвоке:рандом|дате|саме=ес}}→ 02:44, 26 август 2026 (УТC){{#инвоке:рандом|дате|саме=ес}}→ 02:44, 26 август 2026 (УТC)
Итем
Тҳе итем фунcтион оутпуц а рандом итем фром а лист.
{{#инвоке:рандом|итем|лист итем 1|лист итем 2|лист итем 3|...|саме=ес}}
Иф тҳе |саме= параметер ис сет то "ес", "й", "труэ", ор "1", тҳе саме итем ис ретурнед фор эач модуле cалл он а гивен паге.
Эхампле ()
{{#инвоке:рандом|итем|эгг|беанс|саусаге|баcон|спам}}→ эгг{{#инвоке:рандом|итем|эгг|беанс|саусаге|баcон|спам|саме=ес}}→ саусаге{{#инвоке:рандом|итем|эгг|беанс|саусаге|баcон|спам|саме=ес}}→ саусаге
Лист
Тҳе лист фунcтион оутпуц а лист ин а рандом ордер.
{{#инвоке:рандом|лист|лист итем 1|лист итем 2|лист итем 3|...|сеп=сепаратор|лимит=нумбер оф итемс то дисплай|саме=ес}}
Намед параметерс
|сеп=ор|сепаратор=- ан оптионал сепаратор фор тҳе лист итемс. Соме валуэс аре спеcиал; сеэ тҳе табле белоw.|лимит=- тҳе махимум нумбер оф лист итемс то дисплай. Тҳе лоwест поссибле ис 0 анд тҳе ҳигҳест поссибле ис тҳе ленгтҳ оф тҳе лист.|саме=- иф тҳис ис сет то "ес", "й", "труэ", ор "1", тҳе лист ордер ис тҳе саме фор эач модуле cалл он а гивен паге.
| Cоде | Оутпут |
|---|---|
дот |
· |
пипе
|
| |
cомма |
, |
тпт-лангуагес |
⧼тпт-лангуагес-сепаратор⧽ |
спаcе |
а спаcе |
неwлине |
а неwлине чараcтер |
| анй отҳер валуэ | отҳер валуэс аре усед wитҳоут модифиcатион |
Ёу cаннот инпут спаcес диреcтлй то тҳе |сеп= параметер дуэ то лимитатионс ин МедиаWики'с темплате сйнтах. Ҳоwевер, ит ис поссибле то wорк ароунд тҳис бй усинг ҲТМЛ энтитиэс. Ёу cан усе   то репресент а нормал спаcе, анд &нбсп; то репресент а нон-бреакинг спаcе.
Эхамплес ()
{{#инвоке:рандом|лист|эгг|беанс|саусаге|баcон|спам}}→ беанссаусагебаcонеггспам{{#инвоке:рандом|лист|эгг|беанс|саусаге|баcон|спам|сеп=дот}}→ саусаге · беанс · спам · баcон · эгг{{#инвоке:рандом|лист|эгг|беанс|саусаге|баcон|спам|сеп=спаcе}}→ спам эгг беанс баcон саусаге{{#инвоке:рандом|лист|эгг|беанс|саусаге|баcон|спам|сеп=; }}→ беанс; эгг; баcон; саусаге; спам{{#инвоке:рандом|лист|эгг|беанс|саусаге|баcон|спам|сеп=фоо}}→ спамфообеансфоосаусагефообаcонфооэгг{{#инвоке:рандом|лист|эгг|беанс|саусаге|баcон|спам|лимит=3}}→ баcонбеансспам{{#инвоке:рандом|лист|эгг|беанс|саусаге|баcон|спам|саме=ес}}→ баcонбеансеггспамсаусаге{{#инвоке:рандом|лист|эгг|беанс|саусаге|баcон|спам|саме=ес}}→ баcонбеансеггспамсаусаге
Техт лист
Тҳе техт_лист фунcтион оутпуц а лист ин а рандом ордер, техт-стйле. Ин отҳер wордс, ит ис лике тҳе лист фунcтион, бут wитҳ а дифферент сепаратор бефоре тҳе ласт итем.
{{#инвоке:рандом|техт_лист|лист итем 1|лист итем 2|лист итем 3|...|сеп=сепаратор|cонж=cонжунcтион|лимит=нумбер оф итемс то дисплай|саме=ес}}
Тҳе сепаратор cан бе спеcифиэд wитҳ эитҳер тҳе |сеп= ор |сепаратор= параметерс; иц дефаулт валуэ ис ", ". Тҳе cонжунcтион cан бе спеcифиэд wитҳ эитҳер тҳе |cонж= ор |cонжунcтион= параметерс; иц дефаулт валуэ ис " анд ". Тҳе сепаратор анд тҳе cонжунcтион cан бе спеcифиэд wитҳ тҳе саме валуэс ас тҳе сепаратор ин тҳе лист фунcтион.
Тҳе махимум нумбер оф лист итемс то дисплай cан бе сет wитҳ тҳе |лимит= параметер. Тҳе лоwест поссибле ис 0 анд тҳе ҳигҳест поссибле ис тҳе ленгтҳ оф тҳе лист.
Иф тҳе |саме= параметер ис сет то "ес", "й", "труэ", ор "1", тҳе лист ордер ис тҳе саме фор эач модуле cалл он а гивен паге.
Эхамплес ()
{{#инвоке:рандом|техт_лист|эгг|беанс|саусаге|баcон|спам}}→ беанс, саусаге, баcон, эггва спам{{#инвоке:рандом|техт_лист|эгг|беанс|саусаге|баcон|спам|сеп=; }}→ эгг; спам; баcон; беансва саусаге{{#инвоке:рандом|техт_лист|эгг|беанс|саусаге|баcон|спам|сеп=; |cонж= ор }}→ спам; саусаге; беанс; баcон ор эгг{{#инвоке:рандом|техт_лист|эгг|беанс|саусаге|баcон|спам|лимит=3}}→ спам, эггва баcон{{#инвоке:рандом|техт_лист|эгг|беанс|саусаге|баcон|спам|саме=ес}}→ баcон, беанс, эгг, спамва саусаге{{#инвоке:рандом|техт_лист|эгг|беанс|саусаге|баcон|спам|саме=ес}}→ баcон, беанс, эгг, спамва саусаге
ҲТМЛ лисц
Иф ёу wиш то оутпут ан ҲТМЛ лист ин а рандом ордер, ёу cан чоосе бетwеэн фиве дифферент фунcтионс: буллетед_лист, унбуллетед_лист, ҳоризонтал_лист, ордеред_лист, анд ҳоризонтал_ордеред_лист. Тҳесе фунcтионс алл усе Модуле:Лист.
| Фунcтион наме | Продуcес | Эхампле cоде | Эхампле оутпут () |
|---|---|---|---|
буллетед_лист
|
Буллетед лисц | {{#инвоке:рандом|буллетед_лист|эгг|саусаге|спам}}
|
|
унбуллетед_лист
|
Унбуллетед лисц | {{#инвоке:рандом|унбуллетед_лист|эгг|саусаге|спам}}
|
|
ҳоризонтал_лист
|
Ҳоризонтал буллетед лисц | {{#инвоке:рандом|ҳоризонтал_лист|эгг|саусаге|спам}}
|
|
ордеред_лист
|
Ордеред лисц (нумберед лисц анд алпҳабетиcал лисц) | {{#инвоке:рандом|ордеред_лист|эгг|саусаге|спам}}
|
|
ҳоризонтал_ордеред_лист
|
Ҳоризонтал ордеред лисц | {{#инвоке:рандом|ҳоризонтал_ордеред_лист|эгг|саусаге|спам}}
|
|
- Басиc усаге
{{#инвоке:рандом|фунcтион|лист итем 1|лист итем 2|лист итем 3|...|лимит=нумбер оф итемс то дисплай|саме=ес}}
- Алл параметерс
{{#инвоке:рандом|''фунcтион''
|''фирст итем''|''сеcонд итем''|''тҳирд итем''|...
|старт = ''старт нумбер фор ордеред лисц''
|тйпе = ''тйпе оф маркер фор ордеред лисц''
|лист_стйле_тйпе = ''тйпе оф маркер фор ордеред лисц (усес CСС)''
|cласс = ''cласс''
|стйле = ''стйле''
|лист_стйле = ''стйле фор тҳе лист''
|итем_стйле = ''стйле фор алл лист итемс''
|итем_стйле1 = ''стйле фор тҳе фирст лист итем'' |итем_стйле2 = ''стйле фор тҳе сеcонд лист итем'' |...
|индент = ''индент фор ҳоризонтал лисц''
}}
Тҳе махимум нумбер оф лист итемс то дисплай cан бе сет wитҳ тҳе |лимит= параметер. Тҳе лоwест поссибле ис 0 анд тҳе ҳигҳест поссибле ис тҳе ленгтҳ оф тҳе лист.
Иф тҳе |саме= параметер ис сет то "ес", "й", "труэ", ор "1", тҳе лист ордер ис тҳе саме фор эач модуле cалл он а гивен паге.
Плеасе сеэ Модуле:Лист фор а фулл эхпланатион оф тҳе отҳер параметерс.