157 lines
62 KiB
Plaintext
157 lines
62 KiB
Plaintext
|
rust
|
|||
|
|
ðõ #rustc 1.96.0 (ac68faa20 2026-05-25)ÁíàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ ¤²XctÔ'ÐÓ©z¨É½Ó -a4945860e1c53b00Á ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁÀ뉊 ]!ÜÛê(¹Þ—šên -5be7b69c3ff7b5b8Á –�òÖÀH•‘P IÓHã#£ -055f30b747f859b6Á rustc_std_workspace_coreÁCçß^ò½èÝ$Çÿ+Cé -c4878ee60b2242c9Á ŸÃï+Ñ]ŠqB<ÏïW# -8dd1dd90e70d0b6aÁ miniz_oxideÁ€š»J(P>àö÷g\K -1eb618da2918ab7fÁ adler2ÁÆ;+Þ®5¥ÌýÝ°¦ÛLˆ -f7919172d268e069Á hashbrownÁPäV9ÒÆèÜ�"ÊÖVŽ\ -0fc2184a5da6723aÁ rustc_std_workspace_allocÁs&ØòØy¯s•bæ!‰ýŠ -97e4bf30be240674Á
|
|||
|
|
std_detectÁhŠBîÙºÌI®Ë�Å�š -9dbbf8346ba7ac8bÁ rustc_demangleÁûë9´Ç×@Œ�’ùXFº -f33013f239bf9f14Á cfg_ifÁÜLh�ž§Œaã¯>� -0a71c8f33a838301Á addr2lineÁ׎Þ!]8V$É@@T· -e618e6be60e87ba2Á gimliÁ¸
|
|||
|
|
°µ~Î1‹Ñt ðÁ€w -1f7768a68858f670Á objectÁ
|
|||
|
|
áPÃ?À¶¼QHJ¥� -914cd6a4dbe590d1Á memchrÁ›º«8Ór2Ù $¨ûib‚ -cf21ca6f2bb15dcdÁë
|
|||
|
|
‹ás «LÖ€îâƒ×ɯŒ -ee6f3747e38367f0Á random_seedÁ\, ì×´Ç+ ìØ´ß+ üÆ+0 Å\î. ì×´ƒ. ìØ´›. ü‚.0 í ¤ À
|
|||
|
|
global_rngÁ DEFAULT_RNG_SEEDÁ > æ with_rngÁ £ impl FnOnce(&mut Rng) -> RÁ try_with_rngÁ £ Ã
|
|||
|
|
RestoreOnDropÁ 'aÁ rngÁ currentÁ #ã seedÁ % get_seedÁ ' º )
|
|||
|
|
alphabeticÁ + alphanumericÁ - lowercaseÁ / uppercaseÁ 1 choiceÁ 3š 3 digitÁ 6 shuffleÁ 8¥ 8 fillÁ ; ã ® >
|
|||
|
|
f32_inclusiveÁ @ ° B
|
|||
|
|
f64_inclusiveÁ D choose_multipleÁ Fš F Å I IIIII Qƒ S gen_u32Á S gen_u64Á U
|
|||
|
|
WY_CONST_0Á U
|
|||
|
|
WY_CONST_1Á S gen_u128Á S gen_mod_u32Á S gen_mod_u64Á S gen_mod_u128Á mul_high_u32Á mul_high_u64Á
|
|||
|
|
mul_high_u128Á rng_integerÁ ` with_seedÁ ` forkÁ `ú
|
|||
|
|
c CHARSÁ `� e´ `º `æ `° i MULÁ `® `Ó lã `° `ë oš `¦ q´ `Í
|
|||
|
|
`Ü
|
|||
|
|
`Î uš `ö w¥ `� `º z´ `ÿ | impl RangeBounds<char>Á | | | RNGÁ � __rust_std_internal_init_fnÁ � ƒ „ __RUST_STD_INTERNAL_VALÁ ƒ †Ì È ˆ impl RangeBounds<u8>Á ˆ ¶ ‹ impl RangeBounds<i8>Á ‹ Î Ž impl RangeBounds<u16>Á Ž · ‘ impl RangeBounds<i16>Á ‘ Ô ” impl RangeBounds<u32>Á ” ¸ — impl RangeBounds<i32>Á — Ú š impl RangeBounds<u64>Á š ¹ � impl RangeBounds<i64>Á � à impl RangeBounds<u128>Á º £ impl RangeBounds<i128>Á £ ¬ ¦ impl RangeBounds<usize>Á ¦ ó © impl RangeBounds<isize>Á © ÿ ¬ë ¬ RngÁ ¯
|
|||
|
|
¯ˆ ²× µ� ·Ö `¶ ¹§ ¹ `· ¼ø ¼ `¸ ¿Ê ¿ `¹ Âœ  `º Åï Å `ó ÈÄ È `È Ëÿ Ë `Î ÎÏ Î `Ô Ñ¡ Ñ `Ú Ôó Ô `à ×Å × `¬ Ú™ Ú
|
|||
|
|
|
|||
|
|
#
|
|||
|
|
$
|
|||
|
|
8
|
|||
|
|
;
|
|||
|
|
R
|
|||
|
|
T
|
|||
|
|
U
|
|||
|
|
X
|
|||
|
|
Y
|
|||
|
|
Z
|
|||
|
|
[
|
|||
|
|
b
|
|||
|
|
c
|
|||
|
|
e
|
|||
|
|
g
|
|||
|
|
h
|
|||
|
|
i
|
|||
|
|
k
|
|||
|
|
l
|
|||
|
|
n
|
|||
|
|
o
|
|||
|
|
q
|
|||
|
|
s
|
|||
|
|
t
|
|||
|
|
u
|
|||
|
|
w
|
|||
|
|
w
|
|||
|
|
y
|
|||
|
|
y
|
|||
|
|
z
|
|||
|
|
|
|
|||
|
|
³
|
|||
|
|
³
|
|||
|
|
³
|
|||
|
|
¶
|
|||
|
|
¶
|
|||
|
|
¸
|
|||
|
|
¹
|
|||
|
|
¼
|
|||
|
|
¿
|
|||
|
|
Â
|
|||
|
|
Å
|
|||
|
|
È
|
|||
|
|
Ë
|
|||
|
|
Î
|
|||
|
|
Ñ
|
|||
|
|
Ô
|
|||
|
|
×
|
|||
|
|
Ú
|
|||
|
|
³ ¯ ¯ °û ±ˆ å™Í„´ÄÌ: Œ" �
|
|||
|
|
!ª
|
|||
|
|
"´
|
|||
|
|
©â,ÆÚª,© 8 ¿c‰ Ðì‰ µß‰‰ ™‰ ؉ ¯# ² ¯´ ¯µ ¯· ¯Q ¯³ -Œ"¿cÐìµß™Ø Z§ Óž÷ö 0xef6f79ed30ba75aÁù
|
|||
|
|
· ™e
|
|||
|
|
|
|||
|
|
é
|
|||
|
|
· e
|
|||
|
|
¾á.á. a ã.»Ì- IÜž�B2®‰ù
|
|||
|
|
Õ úe ƒ ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡z٠ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÍ Í � ± ù �f�a � ®® £ ° innerÁ¨ it§ÅLS¶Í á ¢fa ]! ƒ� � _Á ù
|
|||
|
|
ð e
|
|||
|
|
é
|
|||
|
|
ð e
|
|||
|
|
ÐÍ / 5 ù
|
|||
|
|
¦ ®e „ ’ ¥ / �
|
|||
|
|
¿ e ù
|
|||
|
|
í Ôe ù
|
|||
|
|
‚!e †š!�!¬! # �
|
|||
|
|
›!e M
|
|||
|
|
À$e ù
|
|||
|
|
Û ôe ƒ � „š!�!¬! å †š!�!¬! Ÿ S _Á ¥xlªÌ�5-� 0x2d35_8dcc_aa6c_78a5Á ɬ.–“K¸‹� 0x8bb8_4b93_962e_acc9Á$ÀF L¼F ¯ ÄF ËF a üˆFC ‰ $F � $ŸF � b Í
|
|||
|
|
4 üçO7 4 6 C
|
|||
|
|
Œ% �P üÒOM d ·% ,ßO ‰% ‹ ‰% ’ 2 7b"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"Á üêQA Œ%�% > 6 C ·% ªR üÕQW f ·% ,âQ ì& ‡ ì& Ž 2 Ab"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"Á œªc dªc ³c ? # / @ Û( ? $«c � M ? Ù( o . � y ? Ù( ¼c ̤c ¤c €?Þ) & ü“c+ j Þ) žc Þ) � Û( C _Á œ´h d´h ½h ? Ù(Û( # / @ Û( ? $µh � M ? Ù( o . � y ? Ù( Æh Ì®h ®h ð?‘, * ü�h+ m ‘, ¨h ‘, � Û( C _Á ìÛƒ Œ%�% 6 C ·% ÷ƒ üƃ3 r ·% ,Óƒ ¿- Š ¿- ‘ 4 b"abcdefghijklmnopqrstuvwxyz"Á ìŸ ¿- % 2 ·% ÞŸ üŸ3 { ·% ,ºŸ ¿- y ¿- € 4 b"ABCDEFGHIJKLMNOPQRSTUVWXYZ"Á tÎ ¯ ° % ‰ 0 � 7 > \]^¯°í ¤,‡ À ³ í<Í ð î<Ö ì BoundÁ,ð ç£ RangeBoundsÁ\÷ ¤#
|
|||
|
|
ö ° ªB Í
|
|||
|
|
$¥
|
|||
|
|
% PÜ
|
|||
|
|
D½ ' Pº$£ ) Pú
|
|||
|
|
T˜ + P� dž - P¦ Lš / Pº L� 1 PÎ 4× 3 Pæ ,� 6 Pö <‹ 8 P� $ˆ ; P® ·# > P° l™$ @ P° Ž% B PÓ lð% D Pë |ÿ& F PÈÍ ˆ P¶Š ‹ PÎ Ç Ž P· † ‘ PÔ Å ” P¸ „ — PÚ Ã š P¹ ‚ � Pà$Á Pº$‚! £ P¬,Ã! ¦ Pó,†" © Pÿ$É" ¬ Pü Ю ü . + A simple and fast random number generator.Á /ú ü3_ \ The implementation uses [Wyrand](https://github.com/wangyi-fudan/wyhash), a simple and fastÁ ü“3 0 generator but **not** cryptographically secure.Á Çú tË # ExamplesÁ Úú „Þ
|
|||
|
|
Flip a coin:Á ïú <ó ```Á Ìû if fastrand::bool() {Á Ô• println!("heads");Á d° } else {Á Ô½ println!("tails");Á ,Ø }Á <Þº7 æú äê Generate a random `i32`:Á ‡ú <‹º7 ü“ let num = fastrand::i32(..);Á <´º7 ¼ú üÀ( % Choose a random element in an array:Á éú <íº7 üõ let v = vec![1, 2, 3, 4, 5];Á ü–' $ let i = fastrand::usize(..v.len());Á ¤¾ let elem = v[i];Á <Óº7 Ûú üßT Q Sample values from an array with `O(n)` complexity (`n` is the length of array):Á ´ú <¸º7 üÀ, ) fastrand::choose_multiple([1, 4, 5], 2);Á üí) & fastrand::choose_multiple(0..20, 12);Á <—º7 Ÿú £ú ¬§ Shuffle an array:Á ½ú <Áº7 üÉ$ ! let mut v = vec![1, 2, 3, 4, 5];Á ôî fastrand::shuffle(&mut v);Á <�º7 •ú ü™C @ Generate a random [`Vec`] or [`String`](alloc::string::String):Á Ýú <áº7 üé use std::iter::repeat_with;Á ‰ú ü�K H let v: Vec<i32> = repeat_with(|| fastrand::i32(..)).take(10).collect();Á üÙK H let s: String = repeat_with(fastrand::alphanumeric).take(10).collect();Á <¥ º7 ú ü± S P To get reproducible results on every run, initialize the generator with a seed:Á …
|
|||
|
|
ú <‰
|
|||
|
|
º7 ü‘
|
|||
|
|
( % // Pick an arbitrary number as seed.Á ´º
|
|||
|
|
fastrand::seed(7);Á Ñ
|
|||
|
|
ú üÕ
|
|||
|
|
4 1 // Now this prints the same number on every run:Á üŠ & # println!("{}", fastrand::u32(..));Á <± º7 ¹ ú ü½ Y V To be more efficient, create a new [`Rng`] instance instead of using the thread-localÁ t— generator:Á ¦ ú <ª º7 ü² Ò? Ò ú üÖ ' $ let mut rng = fastrand::Rng::new();Á üþ O L let mut bytes: Vec<u8> = repeat_with(|| rng.u8(..)).take(10_000).collect();Á <Î
|
|||
|
|
º7 Ö
|
|||
|
|
ú üÚ
|
|||
|
|
d a This crate aims to expose a core set of useful randomness primitives. For more niche algorithms,Á ü¿E B consider using the [`fastrand-contrib`] crate alongside this one.Á …ú t‰ # FeaturesÁ ˜ú üœ\ Y - `std` (enabled by default): Enables the `std` library. This is required for the globalÁ üù` ] generator and global entropy. Without this feature, [`Rng`] can only be instantiated usingÁ üÚ/ , the [`with_seed`](Rng::with_seed) method.Á üŠ_ \ - `js`: Assumes that WebAssembly targets are being run in a JavaScript environment. See theÁ üêK H [WebAssembly Notes](#webassembly-notes) section for more information.Á ¶ú ¼º # WebAssembly NotesÁ Òú üÖf c For non-WASI WASM targets, there is additional subtlety to consider when utilizing the global RNG.Á ü½f c By default, `std` targets will use entropy sources in the standard library to seed the global RNG.Á ü¤X U However, these sources are not available by default on WASM targets outside of WASI.Á ýú ü�] Z If the `js` feature is enabled, this crate will assume that it is running in a JavaScriptÁ üße b environment. At this point, the [`getrandom`] crate will be used in order to access the availableÁ üÅd a entropy sources and seed the global RNG. If the `js` feature is not enabled, the global RNG willÁ Ôª use a predefined seed.Á Åú üÉC @ [`fastrand-contrib`]: https://crates.io/crates/fastrand-contribÁ ü�5 2 [`getrandom`]: https://crates.io/crates/getrandomÁ ahttps://raw.githubusercontent.com/smol-rs/smol/master/assets/images/logo_fullsize_transparent.pngÁ„âSlè \]^¯°í@ ¤A À@ í? ð î> ì É08 ç£ â0, ¤#
|
|||
|
|
ö+ ªB Í
|
|||
|
|
* % PÜ
|
|||
|
|
) ' Pº( ) Pú
|
|||
|
|
' + P� & - P¦ % / Pº $ 1 PÎ # 3 Pæ " 6 Pö ! 8 P� ; P® > P° @ P° B PÓ D Pë F PÈ ˆ P¶ ‹ PÎ Ž P· ‘ PÔ ” P¸ — PÚ š P¹ � Pà Pº £ P¬ ¦ Pó © Pÿ ¬ P‹Ž‘”úˆ„¦ }l½ ruehLä WZ>A|¤ 5tÎ »À|¼ ¼¶ TÒ %')+-/1368;>@BDFI�ˆ‹Ž‘”—š� £¦©¬û @ ¯
|
|||
|
|
û °
|
|||
|
|
a$U á. â0\i ¤# ö „ ªB T9 [|J <¬_ /lz "Ü° „¶ � ¤â ‰ ´ œ‰ üýC @ Initialize the `Rng` from the system's random number generator.Á Å ú üÍ) & This is equivalent to [`Rng::new()`].Á<Œ ‰
|
|||
|
|
D» ‰ œ‡ üÊ* ' Creates a new random number generator.Á Ž ‰
|
|||
|
|
Ì <closure_kind>Á <closure_signature>Á <upvars>Á Ù( åHåHæH AccessErrorÁ –úrì$šÙ0 ‰ ¬!ü´2 D· à £ £ à Íì¹` À Íì´` ÔÆ Ý –"´` ݉ ¬Ë Ý ´`“a˜" ¹` ß
|
|||
|
|
¹`´`± à bd _a ,ö ý] •^ ²^ ¹`´`Ù( Í ¹` ´`üÞX dá ´`Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¹`Ú_ £ Ã ä` î ô`Ôô Þ –"´` Þ‰ ¬ù Þ ´`‘d˜" ¹` �
|
|||
|
|
¹`´`± ñ Y[ _a ,Ê ý] •^ ²^ ¹`´`Ù(½bÓbÄ� l¤ ¡
|
|||
|
|
�
|
|||
|
|
!ª
|
|||
|
|
"´
|
|||
|
|
©â,ÆÚª,© ¡
|
|||
|
|
©â,ÆÚª,© !" $² ”¼ ¼ ¡
|
|||
|
|
Í dÔ <Ô ‰üå 8 ß ß Á$ �" $ ”‹ $Ž à àÁ¬! # “ #
|
|||
|
|
$ 8$˜ ´ž
|
|||
|
|
üÔ ? < Initializes the thread-local generator with the given seed.Á• � ¬!
|
|||
|
|
% Í
|
|||
|
|
$ª
|
|||
|
|
Ä
|
|||
|
|
% ý] & •^ & ²^ & & % &Ù( ‰¬! � Ķ üÚ
|
|||
|
|
Q N Gives back **current** seed that is being held by the thread-local generator.Á¥ �
|
|||
|
|
' Þ ' ý] ( •^ ( ²^ ( ( ' (Ù( ½i� ¬!¬œ ôó Generates a random `bool`.Áµ
|
|||
|
|
) Á ) ý] * •^ * ²^ * * ) *Ù( ½i ¬!Ü‘ üÒ4 1 Generates a random `char` in ranges a-z and A-Z.ÁÅ
|
|||
|
|
+ ¼ + ý] , •^ , ²^ , , + ,Ù( ½i ¬!ì— üÓ9 6 Generates a random `char` in ranges a-z, A-Z and 0-9.ÁÕ
|
|||
|
|
- Ä - ý] . •^ . ²^ . . - .Ù(žn¬!Ô“ üÝ+ ( Generates a random `char` in range a-z.Áå
|
|||
|
|
/ ½ / ý] 0 •^ 0 ²^ 0 0 / 0Ù(žn¬!Ô‰ üÓ+ ( Generates a random `char` in range A-Z.Áõ
|
|||
|
|
1 ³ 1 ý] 2 •^ 2 ²^ 2 2 1 2Ù(žn¬!üÐk üÉ. + Choose an item from an iterator at random.Á ø ú üüN K This function may have an unexpected result if the `len()` property of theÁ üËJ G iterator does not match the actual number of items in the iterator. IfÁ ü–/ , the iterator is empty, this returns `None`.Á šÛ¼Ý¼Þ¼© ß¼ à¼ÛἈ cSñŸ«‡zÙ›u ÈL š 4 4 Íì›u Þ ÇL›u dŠ ÃM›u ÉL Œ©
|
|||
|
|
3›uù$á 8: Ë 3ý] 5 •^ 5 ²^ 5 5 3 5›uÙ( ½i u ›uü– üâ1 . Generates a random digit in the given `base`.Á ” ú ü˜< 9 Digits are represented by `char`s in ranges 0-9 and a-z.Á Õ ú üÙ2 / Panics if the base is zero or greater than 36.Á Û(
|
|||
|
|
6 baseÁ$£ Å 6 ý] 7 •^ 7 ²^ 7 7 6 7Ù(žn Û( ü„" ôÛ Shuffles a slice randomly.Á% á á
|
|||
|
|
¥¬! ¥ 9 9 � Íìóz “
|
|||
|
|
8ózž,– ¶ 8ý] : •^ : ²^ : : 8 :ózÙ(¸i òzì� üÏ' $ Fill a byte slice with random data.Á5 â â¹%¬! ”
|
|||
|
|
; ž,� ® ; ý] < •^ < ²^ < < ; <Ù(¸i ¹%¤Ä <Ñ Ù Á ß î , à 8¿ á & â 8¯ ã $ å , ç 8Ó è & ë 8¯ ì *ð ó ¾ + ý þ ‰ 8Ó ÿ ƒ , … 8Ó † < ú “ < Panics if the range is empty.ÁüŸ! + É Ê Ñ 8Ý 4Ë 8 Û 8 ß , â 8¿ ã ä € 8 rangeÁ ,å & ê 8 $ì 8â0 \ñ ü , ý 8¿ þ ÿ (‚ , … 8¿ † ˆ ¸ 8 D– ž ® Ÿ 8½ ¡ 8½ £ ¤ , ¥ 8¿ ¦ § 8¼ ,¨ % ¿ œ°# ü‚#- * Generates a random `f32` in range `0..1`.ÁE Þ)
|
|||
|
|
> Ó# > ý] ? •^ ? ²^ ? ? > ?Ù( ½iÞ) ¬!ì’$ üã#. + Generates a random `f32` in range `0..=1`.ÁU Þ)
|
|||
|
|
@ ¿$ @ ý] A •^ A ²^ A A @ AÙ(Ѓ¬!œ‡% üÙ$- * Generates a random `f64` in range `0..1`.Áe ‘,
|
|||
|
|
B ª% B ý] C •^ C ²^ C C B CÙ( ½i‘, ¬!ìé% üº%. + Generates a random `f64` in range `0..=1`.Áu ‘,
|
|||
|
|
D –& D ý] E •^ E ²^ E E D EÙ(Ȇ¬!üø&Q ü°&G D Collects `amount` values at random from the iterable into a vector.Á… ›u�%ªBªB ö B bufÁ÷< ®B‘÷< 9)
|
|||
|
|
-ÜnLåuçEçEèE GlobalÁ ¿±‡§í# š G G ‡v �' —vd’'
|
|||
|
|
F›u sourceÁ4 ' amountÁ4«' .0 ,Ù' Fý] H •^ H ²^ H H F H›uÙ( ½iƒ‰ ›u �% üî( ì×´ž( ìØ´¶( ü�(0 ú unknownÁ¬Ó( ü”(V ü�([ ü‡(f \ñ( ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ�
|
|||
|
|
I ü˜)) l´) LË) $×) 4Ý) \î) 4ó) ”ƒ* <Ž* Tÿ ”ä ‰R Ù R ´Ê üý H E Clones the generator by creating a new generator with the same seed.Á,Í ã ㉠‰ Q Ó Q
|
|||
|
|
R $Ô D‹ ‰TUXYZ[ äÊ <Í ä ä‰Û( S Õ S
|
|||
|
|
T $Ú äÂ!<Å! å å‰� S Í! S
|
|||
|
|
U $Ò!¬¾#TÄ# � ¬õ#Tû# � ôˆ&D‹& æ æ‰ S ”& S
|
|||
|
|
X $™&ü¶'(\¹' ç ç‰Û(Û( S Å' S
|
|||
|
|
Y $Ê'¹ Ð'üÞ+(\á+ è è‰� � S í+ S
|
|||
|
|
Z $ò+¹ ø+ü‡0+dŠ0 é é‰ S —0 S
|
|||
|
|
[ $œ0¹ ¢0ü¢4&d¥4 Û(Û(Û(
|
|||
|
|
\ ¬ ²4 º4ü£5&d¦5 � � �
|
|||
|
|
] ¬ ³5 »5ü§6*lª6
|