置顶公告:【置顶】关于临时开启评论区所有功能的公告(2022.10.22) | 【置顶】关于本站Widget恢复使用的公告
  • 你好~!欢迎来到萌娘百科镜像站!如需查看或编辑,请联系本站管理员注册账号。
  • 本镜像站和其他萌娘百科的镜像站无关,请注意分别。

模組:Sandbox/Amahikari Hakuryuu/Random/doc

萌娘百科,萬物皆可萌的百科全書!轉載請標註來源頁面的網頁連結,並聲明引自萌娘百科。內容不可商用。
跳至導覽 跳至搜尋

此頁面為 Module:Sandbox/Amahikari Hakuryuu/Random 的說明文件

這個模塊包含了可以使用隨機數的函數。它能輸出隨機數,從列表中隨機選擇一個項目,對列表隨機重新排序。隨機重新排序列表可以有序輸出,也可以用來輸出各種有徐和無序列表。可用函數參見下文。

Number

number函數能夠產生隨機數.

{{#invoke:Sandbox/Amahikari Hakuryuu/Random|number|m|n|same=yes}}

The arguments m and n may be omitted, but if specified must be convertible to integers.

  • With no arguments, returns a real number in the range <math>[0,1)</math>.
  • With one argument, returns an integer in the range <math>[1,m]</math>. m must be positive.
  • With two arguments, returns an integer in the range <math>[m,n]</math>. m and n can be either positive or negative. If m is greater than n, returns an integer in the range <math>[n,m]</math> instead.
  • If the |same= parameter is set to "yes", "y", "true", or "1", the same random number is returned for each module call on a given page.

本模組所採用的機率分佈均勻分佈(有給參數的則是離散型均勻分佈,未給參數的則是連續型均勻分佈)。

注意:使用Module:Random的函數所產生的隨機數不夠隨機

Examples (refresh)

  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|number}} → 0.9245060672632
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|100}} → 79
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|-100|-50}} → -68
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|100|same=yes}} → 100
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|number|100|same=yes}} → 100

The documentation for this function is partly taken from the Scribunto Lua reference manual, which is in turn based on the Lua 5.1 Reference Manual, available under the MIT License.

Date

date函數可以輸出隨機文檔。

{{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|timestamp1|timestamp2|format=date format|same=yes}}
  • If no timestamp arguments are specified, the module outputs a random date in the current year.
  • If timestamp1 and timestamp2 are specified, the module outputs a random date between the two timestamps. timestamp1 must be earlier than timestamp2.
  • If only timestamp1is specified, the module outputs a random date between the Unix epoch (1 Jan 1970) and the timestamp. timestamp1 must not be earlier than 1 Jan 1970.
  • Formatting can be specified with the |format= parameter. The default formatting is "hh:mm, DD Month YYYY (UTC)" (the same as the default Wikipedia timestamp).
  • The timestamps and the |format= parameter accept values compatible with the #time parser function. Please see the #time documentation for the full range of possible input values and formatting options.
  • If the |same= parameter is set to "yes", "y", "true", or "1", the same date is returned for each module call on a given page.

Examples (refresh)

  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|date}} → 01:04, 04 2月 2024 (UTC)
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|format=F j}} → 1月 29
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|1 Jan 1980|31 Dec 1999}} → 11:42, 06 4月 1999 (UTC)
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|1st January 1500|1st January 3000|format=g:i a, l d M Y}} → 4:02 am, 星期二 27 5月 2403
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|1970/06/01}} → 17:08, 14 4月 1970 (UTC)
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|same=yes}} → 08:00, 30 12月 2024 (UTC)
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|same=yes}} → 08:00, 30 12月 2024 (UTC)

Item

item可以輸出隨機的物品列表

{{#invoke:Sandbox/Amahikari Hakuryuu/Random|item|list item 1|list item 2|list item 3|...|same=yes}}

If the |same= parameter is set to "yes", "y", "true", or "1", the same item is returned for each module call on a given page.

Example (refresh)

  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|item|egg|beans|sausage|bacon|spam}} → sausage
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|item|egg|beans|sausage|bacon|spam|same=yes}} → bacon
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|item|egg|beans|sausage|bacon|spam|same=yes}} → bacon

List

list可以隨機輸出一個物品列表。

{{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|list item 1|list item 2|list item 3|...|sep=separator|limit=number of items to display|same=yes}}

Named parameters

  • |sep= or |separator= - an optional separator for the list items. Some values are special; see the table below.
  • |limit= - the maximum number of list items to display. The lowest possible is 0 and the highest possible is the length of the list.
  • |same= - if this is set to "yes", "y", "true", or "1", the list order is the same for each module call on a given page.
Possible separator values
Code Output
dot ⧼dot-separator⧽
pipe |
comma 、​
tpt-languages ⧼tpt-languages-separator⧽
space a space
any other value other values are used without modification

You cannot input spaces directly to the |sep= parameter due to limitations in MediaWiki's template syntax. However, it is possible to work around this by using HTML entities. You can use &#32; to represent a normal space, and &nbsp; to represent a non-breaking space.

Examples (refresh)

  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam}} → sausageeggbeansbaconspam
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|sep=dot}} → spam⧼dot-separator⧽bacon⧼dot-separator⧽sausage⧼dot-separator⧽egg⧼dot-separator⧽beans
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|sep=space}} → bacon spam beans sausage egg
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|sep=;&#32;}} → sausage; beans; spam; bacon; egg
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|sep=foo}} → spamfooeggfoobaconfoobeansfoosausage
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|limit=3}} → sausagebeansegg
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|same=yes}} → beanseggsausagespambacon
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|same=yes}} → beanseggsausagespambacon

Text list

The text_list function outputs a list in a random order, text-style. In other words, it is like the list function, but with a different separator before the last item.

{{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|list item 1|list item 2|list item 3|...|sep=separator|conj=conjunction|limit=number of items to display|same=yes}}

The separator can be specified with either the |sep= or |separator= parameters; its default value is "、​". The conjunction can be specified with either the |conj= or |conjunction= parameters; its default value is " and ". The separator and the conjunction can be specified with the same values as the separator in the list function.

The maximum number of list items to display can be set with the |limit= parameter. The lowest possible is 0 and the highest possible is the length of the list.

If the |same= parameter is set to "yes", "y", "true", or "1", the list order is the same for each module call on a given page.

Examples (refresh)

  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam}} → beans、​egg、​bacon、​spam和sausage
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam|sep=;&#32;}} → bacon; sausage; beans; egg和spam
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam|sep=;&#32;|conj=&#32;or&#32;}} → beans; spam; bacon; sausage or egg
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam|limit=3}} → bacon、​spam和sausage
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam|same=yes}} → beans、​egg、​sausage、​spam和bacon
  • {{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam|same=yes}} → beans、​egg、​sausage、​spam和bacon

HTML lists

If you wish to output an HTML list in a random order, you can choose between five different functions: bulleted_list, unbulleted_list, horizontal_list, ordered_list, and horizontal_ordered_list. These functions all use Module:List.

Function name Produces Example code Example output (refresh)
bulleted_list Bulleted lists {{#invoke:Sandbox/Amahikari Hakuryuu/Random|bulleted_list|egg|sausage|spam}}
  • spam
  • sausage
  • egg
unbulleted_list Unbulleted lists {{#invoke:Sandbox/Amahikari Hakuryuu/Random|unbulleted_list|egg|sausage|spam}}
  • sausage
  • egg
  • spam
horizontal_list Horizontal bulleted lists {{#invoke:Sandbox/Amahikari Hakuryuu/Random|horizontal_list|egg|sausage|spam}}
  • spam
  • sausage
  • egg
ordered_list Ordered lists (numbered lists and alphabetical lists) {{#invoke:Sandbox/Amahikari Hakuryuu/Random|ordered_list|egg|sausage|spam}}
  1. sausage
  2. spam
  3. egg
horizontal_ordered_list Horizontal ordered lists {{#invoke:Sandbox/Amahikari Hakuryuu/Random|horizontal_ordered_list|egg|sausage|spam}}
  1. spam
  2. sausage
  3. egg
Basic usage
{{#invoke:Sandbox/Amahikari Hakuryuu/Random|function|list item 1|list item 2|list item 3|...|limit=number of items to display|same=yes}}
All parameters

Template:Pre2

The maximum number of list items to display can be set with the |limit= parameter. The lowest possible is 0 and the highest possible is the length of the list.

If the |same= parameter is set to "yes", "y", "true", or "1", the list order is the same for each module call on a given page.

Please see Module:List for a full explanation of the other parameters.