因各种原因页面内容可能和源页面有所出入,非本站特有页面内容请以萌娘百科为准。
- 你好~!欢迎来到萌娘百科镜像站!如需查看或编辑,请联系本站管理员注册账号。
- 本镜像站和其他萌娘百科的镜像站无关,请注意分别。
模块:Sandbox/Amahikari Hakuryuu/Random/doc
这是Module:Sandbox/Amahikari Hakuryuu/Random的文档页面
![]() |
本页面之全部或部分原来自中文维基百科的[1],依 CC BY-SA 3.0 授权引入;原贡献者可以在这里看到。 |
这个模块包含了可以使用随机数的函数。它能输出随机数,从列表中随机选择一个项目,对列表随机重新排序。随机重新排序列表可以有序输出,也可以用来输出各种有徐和无序列表。可用函数参见下文。
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
andn
can be either positive or negative. Ifm
is greater thann
, 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 (
){{#invoke:Sandbox/Amahikari Hakuryuu/Random|number}}
→ 0.10501501574415{{#invoke:Sandbox/Amahikari Hakuryuu/Random|100}}
→ 65{{#invoke:Sandbox/Amahikari Hakuryuu/Random|-100|-50}}
→ -75{{#invoke:Sandbox/Amahikari Hakuryuu/Random|100|same=yes}}
→ 12{{#invoke:Sandbox/Amahikari Hakuryuu/Random|number|100|same=yes}}
→ 12
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
andtimestamp2
are specified, the module outputs a random date between the two timestamps.timestamp1
must be earlier thantimestamp2
. - If only
timestamp1
is 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 (
){{#invoke:Sandbox/Amahikari Hakuryuu/Random|date}}
→ 05:50, 13 12月 2024 (UTC){{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|format=F j}}
→ 5月 24{{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|1 Jan 1980|31 Dec 1999}}
→ 06:50, 06 10月 1987 (UTC){{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|1st January 1500|1st January 3000|format=g:i a, l d M Y}}
→ 12:06 am, 星期六 17 10月 1987{{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|1970/06/01}}
→ 00:53, 10 2月 1970 (UTC){{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|same=yes}}
→ 23:37, 10 2月 2024 (UTC){{#invoke:Sandbox/Amahikari Hakuryuu/Random|date|same=yes}}
→ 23:37, 10 2月 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 (
){{#invoke:Sandbox/Amahikari Hakuryuu/Random|item|egg|beans|sausage|bacon|spam}}
→ beans{{#invoke:Sandbox/Amahikari Hakuryuu/Random|item|egg|beans|sausage|bacon|spam|same=yes}}
→ spam{{#invoke:Sandbox/Amahikari Hakuryuu/Random|item|egg|beans|sausage|bacon|spam|same=yes}}
→ spam
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.
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  
to represent a normal space, and
to represent a non-breaking space.
Examples (
){{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam}}
→ baconspamsausageeggbeans{{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|sep=dot}}
→ bacon⧼dot-separator⧽sausage⧼dot-separator⧽beans⧼dot-separator⧽egg⧼dot-separator⧽spam{{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|sep=space}}
→ bacon beans sausage egg spam{{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|sep=; }}
→ egg; beans; sausage; spam; bacon{{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|sep=foo}}
→ baconfoospamfoosausagefoobeansfooegg{{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|limit=3}}
→ spameggbacon{{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|same=yes}}
→ sausagebaconbeanseggspam{{#invoke:Sandbox/Amahikari Hakuryuu/Random|list|egg|beans|sausage|bacon|spam|same=yes}}
→ sausagebaconbeanseggspam
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 (
){{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam}}
→ beans、bacon、spam、sausage和egg{{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam|sep=; }}
→ egg; sausage; beans; bacon和spam{{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam|sep=; |conj= or }}
→ spam; beans; sausage; bacon or egg{{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam|limit=3}}
→ egg、beans和spam{{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam|same=yes}}
→ sausage、bacon、beans、egg和spam{{#invoke:Sandbox/Amahikari Hakuryuu/Random|text_list|egg|beans|sausage|bacon|spam|same=yes}}
→ sausage、bacon、beans、egg和spam
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 ( | )
---|---|---|---|
bulleted_list
|
Bulleted lists | {{#invoke:Sandbox/Amahikari Hakuryuu/Random|bulleted_list|egg|sausage|spam}}
|
|
unbulleted_list
|
Unbulleted lists | {{#invoke:Sandbox/Amahikari Hakuryuu/Random|unbulleted_list|egg|sausage|spam}}
|
|
horizontal_list
|
Horizontal bulleted lists | {{#invoke:Sandbox/Amahikari Hakuryuu/Random|horizontal_list|egg|sausage|spam}}
|
|
ordered_list
|
Ordered lists (numbered lists and alphabetical lists) | {{#invoke:Sandbox/Amahikari Hakuryuu/Random|ordered_list|egg|sausage|spam}}
|
|
horizontal_ordered_list
|
Horizontal ordered lists | {{#invoke:Sandbox/Amahikari Hakuryuu/Random|horizontal_ordered_list|egg|sausage|spam}}
|
|
- 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
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.