185 lines
86 KiB
Plaintext
185 lines
86 KiB
Plaintext
|
rust
|
|||
|
|
ïT #rustc 1.96.0 (ac68faa20 2026-05-25)ÁÀ뉊 ]!ÜÛê(¹Þ—šên -5be7b69c3ff7b5b8Á íàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ ¤²XctÔ'ÐÓ©z¨É½Ó -a4945860e1c53b00Á ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁ–�òÖÀ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Á crossbeam_utilsÁ\€v€*˜‚³aÑl®Ø{Í -580ebf62485b3066Á once_cellÁ6ÿ]�Ô¯q4c]kÂÓ‹ -a47cd60ec4e2e104Á –æ\‹±Ôcd�-»ùÀTƒ -f86f80b348d33b13Á â<" ú⬠MonotonicÁL` úâ¬1 wasm_browserÁd« ì×´v ìL� ì×´Ã wasm_wasiÁLØ ì×´¦ ìL´ ì×´í has_counter_supportÁœXìõ´ õ œÆ ìõ´Ïðµ¼çüÎ1 쀼‰ú iosÁŒ¦œ¥üˆ1üÅvüÁ{0 testsÁ,ˆM‚ $ýLYù
|
|||
|
|
,¨4‚ $�4{ù
|
|||
|
|
,¸ ‚ $ ù
|
|||
|
|
,·°‚ $¬° À clocksÁ counterÁ
|
|||
|
|
nowÁ monotonicÁ ú “ detectionÁ õ mockÁ IntoNanosecondsÁ
|
|||
|
|
into_nanosÁ Ÿ
|
|||
|
|
"Ÿ
|
|||
|
|
$æ $ incrementÁ &Ÿ & $ decrementÁ )Ÿ ) $»
|
|||
|
|
instantÁ 0 000000000 0
|
|||
|
|
0 <“ < recentÁ < duration_sinceÁ < checked_duration_sinceÁ < saturating_duration_sinceÁ < elapsedÁ < checked_addÁ < checked_subÁ 0E° E• 0H– 0J° JÚ 0MÛ 0O° OÚ 0Rï
|
|||
|
|
0T‹ 0V×
|
|||
|
|
upkeepÁ Y YYYYYYYYY Y
|
|||
|
|
Y Y Y
|
|||
|
|
YY GLOBAL_UPKEEP_RUNNINGÁ Y j× Yl sourceÁ Ynæ n new_with_clockÁ n¹ q q Ytã u statsÁ { |• | meanÁ |
|
|||
|
|
mean_errorÁ | mean_with_errorÁ | has_significant_resultÁ | samplesÁ GLOBAL_CLOCKÁ
|
|||
|
|
GLOBAL_RECENTÁ GLOBAL_CALIBRATIONÁ MINIMUM_CAL_ROUNDSÁ MAXIMUM_CAL_ERROR_NSÁ MAXIMUM_CAL_TIME_NSÁ Šæ Š reset_timebasesÁ Š scale_src_to_refÁ Š calibrateÁ Š adjust_cal_ratioÁ � ‘> “æ ” “î ““ “@ “ scaledÁ “ delta_as_nanosÁ “ deltaÁ “ß �> Ÿƒ
|
|||
|
|
with_clockÁ ¡¥ ¡ impl FnOnce() -> TÁ ¡
|
|||
|
|
set_recentÁ get_nowÁ ¦
|
|||
|
|
get_recentÁ mul_div_po2_u64Á
|
|||
|
|
CounterÁ ª
|
|||
|
|
|
|||
|
|
¬ƒ
|
|||
|
|
®×
|
|||
|
|
°> ì ² _defaultÁ µƒ ¸× º> MockÁ ¼ž
|
|||
|
|
¾× Àƒ 0 InstantÁ Â
|
|||
|
|
ˆ 0 0
|
|||
|
|
ƃ 0 0 0
|
|||
|
|
Ê� 0ÌÖ Y UpkeepÁ Î intervalÁ Î clockÁ YÑ× Y HandleÁ Ó doneÁ Ó handleÁ YÖ× Y ErrorÁ Ø
|
|||
|
|
UpkeepRunningÁ Ù
|
|||
|
|
Ø FailedToSpawnUpkeepThreadÁ Û
|
|||
|
|
Ûˆ YÞ× { VarianceÁ àÇ à mean2Á ๠{ä> CLOCK_OVERRIDEÁ æ __rust_std_internal_init_fnÁ æ è é __RUST_STD_INTERNAL_VALÁ è ëÖ ClockTypeÁ íì î
|
|||
|
|
îˆ í¥ ñ
|
|||
|
|
ñˆ ñ‰ ñŠ í� ö
|
|||
|
|
öˆ ù× CalibrationÁ û ref_timeÁ û src_timeÁ û scale_factorÁ û scale_shiftÁ €× „ƒ ClockÁ † innerÁ
|
|||
|
|
ˆ× Šƒ
|
|||
|
|
&
|
|||
|
|
)
|
|||
|
|
,
|
|||
|
|
?
|
|||
|
|
@
|
|||
|
|
A
|
|||
|
|
B
|
|||
|
|
C
|
|||
|
|
D
|
|||
|
|
I
|
|||
|
|
N
|
|||
|
|
S
|
|||
|
|
S
|
|||
|
|
U
|
|||
|
|
U
|
|||
|
|
W
|
|||
|
|
W
|
|||
|
|
W
|
|||
|
|
k
|
|||
|
|
k
|
|||
|
|
k
|
|||
|
|
m
|
|||
|
|
u
|
|||
|
|
}
|
|||
|
|
~
|
|||
|
|
|
|||
|
|
€
|
|||
|
|
�
|
|||
|
|
‚
|
|||
|
|
Œ
|
|||
|
|
Œ
|
|||
|
|
�
|
|||
|
|
Ž
|
|||
|
|
Ž
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
—
|
|||
|
|
˜
|
|||
|
|
™
|
|||
|
|
š
|
|||
|
|
›
|
|||
|
|
œ
|
|||
|
|
|
|||
|
|
¡
|
|||
|
|
|
|||
|
|
¯
|
|||
|
|
¯
|
|||
|
|
¯
|
|||
|
|
¶
|
|||
|
|
¹
|
|||
|
|
¹
|
|||
|
|
¹
|
|||
|
|
¿
|
|||
|
|
¿
|
|||
|
|
¿
|
|||
|
|
Á
|
|||
|
|
Ç
|
|||
|
|
Ë
|
|||
|
|
Ë
|
|||
|
|
Í
|
|||
|
|
Ò
|
|||
|
|
Ò
|
|||
|
|
Ò
|
|||
|
|
×
|
|||
|
|
×
|
|||
|
|
×
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
ú
|
|||
|
|
ú
|
|||
|
|
ú
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
…
|
|||
|
|
‰
|
|||
|
|
‰
|
|||
|
|
‰
|
|||
|
|
‹
|
|||
|
|
Ø ª ª «¥ ÌÖT—3s% ¿c’" ³ ’" Û ² ² ì ³ã ¸3–pZÅί ØÓ" Š Ó" ¿cÓ" ³ Ó" ÖÖ DurationÁ ®Ö secsÁâ} ¯Ö nanosÁâ} :²Zµ–²ª ¿c ¼ ¼ � ½ž
|
|||
|
|
Õ#»'*
|
|||
|
|
Ø�$ Û Â Â ÃÈ Äˆ _yOjaú¯^ ØË$ Š Ë$ ÐìË$ µßË$Ë$ ™Ë$ Ä Ë$·# ÙõË$·# �ïË$·# œöË$·# �ïË$Ë$ íßË$Ë$ ºË$ ¿cË$ ¿c Î Î “ Ï¡ Y б Y $I NeÛÅ’ ¿c Ó Ó É Ô× Y Õã Y ¬ÔÁwp€E ¿c Ø Ù Ú‰ Û Ü£ ݈ ¡_ߪ‰Áò ÄcŸ' ¾ Ÿ' Œ"à& ³ à à Ü áÇ { âô { ã¹ { ú~îÈ\ä ¿c í î ïì ðˆ ñ ò¥ óˆ ô‰ õŠ ö ÷� øˆ û>3ÄK+ôe ¿c û û ì üÿ ý� þŸ ÿ³ ó�Eó«¡² Š Ñ) ÛÑ) ØÑ) ³ Ñ) ¿c † † å ‡ò Ò €Ä V• ØÎ* ³ Î* ØÍ( ¬ ªµ ²À ¼Æ „ ûŠ †Ÿ í® ª¸ ²¾ ¼V ÂÑ ÎÖ ÓÞ Øù í€ ûˆ †° ªº ²ä à‘ û� †´ ²Å ƒ û· ²È ‚ û "ÖÉ ÂÊ ÂÌ ÂE ÂH ÂJ ÂO ÂM ÂR ÂT Âj Øl Øt ÓØŸ¿c
|
|||
|
|
1³ EÛ#Š Ðì µß™Ä Ùõ�ïœö íߺÄc¾ Œ"ù-· ™e
|
|||
|
|
|
|||
|
|
é-· e
|
|||
|
|
¾Ë/Ë/ É Í/ borrowÁÌ- Î/»Ì- ð…ž�f+4šÛ¼Ý¼Þ¼© ß¼ à¼ÛἈ cSñŸ«‡zÙÎ*ù-Õ úe è ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡z٠ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ¾. ¾. Ö/± d ù,�f�a æ ®® £ °ò ¨ it§ÅLS¶¾. á,¢fa X èÖ/ Ö/ _Á ù-ð e
|
|||
|
|
é-ð e
|
|||
|
|
о. / 5 ù-¦ ®e é Û/î0 / Ö/ -¿ e ù-í Ôe ù-‚!e ëÞ2á2ð2 # Ö/ -›!e M -À$e ù-Û ôe è Ö/ éÞ2á2ð2 å ëÞ2á2ð2 Ÿ S _Á ô ®# 500Á
|
|||
|
|
®# 10ÁT‘H ‘H È ®#$—H è ®# ; 8 È ®#6 è ®# p ®# Œ‘H $žH è ®# $ ' è ®# J ®# ¡H üðG3 ‰ ®# ‹H ®# ®# �7 › ? _Á ”õ
|
|||
|
|
 à % Ë$ 0 ®# 7 > ̶ Ø Ü % Ÿ' 0 ßß ü à… ¬
|
|||
|
|
ÑøÿËO Ÿ b i LËH í ï % Í( 0 Ó" 7 > <åH í ò + Í( 6 Ó" = ’" D Ñ) K R $“I í ÷ % Í( 0 †J†J K ‰Jµ �7 ŠJ phantomÁ�7 ‹J¤�7 ·0ØQd�è�$çEçEèE GlobalÁ ¿±‡§í# ¯ ¶ 0Y{„…†‡ˆ‰¡¥¦¨©†æíûÀ
|
|||
|
|
AtomicCellÁT³> E Ã"DÎ> Ö É<è> Ë/ K ÷> †J OnceCellÁD“? ¯ ¥<½? ª
|
|||
|
|
¥ «
|
|||
|
|
ìLÆ? ² ‰
|
|||
|
|
|€@ .�$‘@ ¼ /È<¼@  XÈ Ã Xü,è@ Ø xÉ4ï@ Ó y“4÷@ Î zÜDœA à ƒü £å ü 2 / Performant cross-platform timing with goodies.Á 3ú ü7c ` `quanta` provides a simple and fast API for measuring the current time and the duration betweenÁ ü›` ] events. It does this by providing a thin layer on top of native OS timing functions, or, ifÁ üüI F available, using the Time Stamp Counter feature found on modern CPUs.Á Æú dÊ # DesignÁ ×ú üÛd a Internally, `quanta` maintains the concept of two potential clock sources: a reference clock andÁ œÀ a source clock.Á Ôú üØa ^ The reference clock is provided by the OS, and always available. It is equivalent to what isÁ üºd a provided by the standard library in terms of the underlying system calls being made. As it usesÁ üŸa ^ the native timing facilities provided by the operating system, we ultimately depend on the OSÁ ü�1 . itself to give us a stable and correct value.Á ³ú ü·_ \ The source clock is a potential clock source based on the [Time Stamp Counter][tsc] featureÁ ü—` ] found on modern CPUs. If the TSC feature is not present or is not reliable enough, `quanta`Á üø; 8 will transparently utilize the reference clock instead.Á ´ú ü¸] Z Depending on the underlying processor(s) in the system, `quanta` will figure out the mostÁ ü– c ` accurate/efficient way to calibrate the source clock to the reference clock in order to provideÁ üú + ( measurements scaled to wall clock time.Á ¦
|
|||
|
|
ú üª
|
|||
|
|
@ = Details on TSC support, and calibration, are detailed below.Á ë
|
|||
|
|
ú tï
|
|||
|
|
# FeaturesÁ þ
|
|||
|
|
ú ü‚ ^ [ Beyond simply taking measurements of the current time, `quanta` provides features for moreÁ üá U R easily working with clocks, as well as being able to enhance performance further:Á ü· ' $ - `Clock` can be mocked for testingÁ üß ? < - globally accessible "recent" time with amortized overheadÁ Ÿ
|
|||
|
|
ú ”£
|
|||
|
|
## Mocked timeÁ ¶
|
|||
|
|
ú üº
|
|||
|
|
[ X For any code that uses a `Clock`, a mocked version can be substituted. This allows forÁ ü–a ^ application authors to control the time in tests, which allows simulating not only the normalÁ üøa ^ passage of time but provides the ability to warp time forwards and backwards in order to testÁ üÚb _ corner cases in logic, etc. Creating a mocked clock can be acheived with [`Clock::mock`], andÁ ü½1 . [`Mock`] contains more details on mock usage.Á ïú üó( % ## Coarsely-updated, or recent, timeÁ œú ü c ` `quanta` also provides a "recent" time feature, which allows a slightly-delayed version of timeÁ ü„b _ to be provided to callers, trading accuracy for speed of access. An upkeep thread is spawned,Á üçb _ which is responsible for taking measurements and updating the global recent time. Callers thenÁ üÊd a can access the cached value by calling `Clock::recent`. This interface can be 4-10x faster thanÁ ü¯c ` directly calling `Clock::now`, even when TSC support is available. As the upkeep thread is theÁ ü“d a only code updating the recent time, the accuracy of the value given to callers is limited by howÁ üø^ [ often the upkeep thread updates the time, thus the trade off between accuracy and speed ofÁ \× access.Á ãú œç # Feature FlagsÁ ûú üÿ_ \ `quanta` comes with feature flags that enable convenient conversions to time types in otherÁ äß popular crates, such as:Á üüY V - `prost` - provides an implementation into [`Timestamp`][prost_types_timestamp] fromÁ œÖ `prost_types`Á êú ´î # Platform SupportÁ …ú ü‰^ [ At a high level, `quanta` carries support for most major operating systems out of the box:Á üèD A - Windows ([`QueryPerformanceCounter`][QueryPerformanceCounter])Á üA > - macOS/OS X/iOS ([`mach_absolute_time`][mach_absolute_time])Á üï; 8 - Linux/*BSD/Solaris ([`clock_gettime`][clock_gettime])Á «ú ü¯` ] These platforms are supported in the "reference" clock sense, and support for using the TimeÁ ü� G D Stamp Counter as a clocksource is more subtle, and explained below.Á Ø ú œÜ ## WASM supportÁ ð ú üô _ \ This library can be built for WASM targets, but in this case the resolution and accuracy ofÁ üÔ [ X measurements can be limited by the WASM environment. In particular, when running on theÁ ü° ` ] `wasm32-unknown-unknown` target in browsers, `quanta` will use [window.performance.now] as aÁ ü‘ ` ] clock. This mean the accuracy is limited to milliseconds instead of the usual nanoseconds onÁ üò a ^ other targets. When running within a WASI environment (target `wasm32-wasi`), the accuracy ofÁ üÔ / , the clock depends on the VM implementation.Á „!ú Œˆ! # TSC SupportÁ š!ú üž!W T Accessing the TSC requires being on the `x86_64` architecture, with access to SSE2.Á üö!d a Additionally, the processor must support either constant or nonstop/invariant TSC. This ensuresÁ üÛ"E B that the TSC ticks at a constant rate which can be easily scaled.Á ¡#ú ü¥#b _ A caveat is that "constant" TSC doesn't account for all possible power states (levels of powerÁ üˆ$a ^ down or sleep that a CPU can enter to save power under light load, etc) and so a constant TSCÁ üê$] Z can lead to drift in measurements over time, after they've been scaled to reference time.Á È%ú üÌ%c ` This is a limitation of the TSC mode, as well as the nature of `quanta` not being able to know,Á ü°&[ X as the OS would, when a power state transition has
|
|||
|
|
# CaveatsÁ Ÿ4ú ü£4b _ Utilizing the TSC can be a tricky affair, and so here is a list of caveats that may or may notÁ ü†5' $ apply, and is in no way exhaustive:Á ü®5' $ - CPU hotplug behavior is undefinedÁ ôÖ5 - raw values may time warpÁ üõ5W T - measurements from the TSC may drift past or behind the comparable reference clockÁ Í6ú üÑ6a ^ Another important caveat is that `quanta` does not track time across system suspends. SimplyÁ ü³7b _ put, if a time measurement (such as using [`Instant::now`][crate::Instant::now]) is taken, andÁ ü–8_ \ then the system is suspended, and then another measurement is taken, the difference betweenÁ üö8G D those the two would not include the time the system was in suspend.Á ¾9ú üÂ9; 8 [tsc]: https://en.wikipedia.org/wiki/Time_Stamp_CounterÁ üþ9^ [ [QueryPerformanceCounter]: https://msdn.microsoft.com/en-us/library/ms644904(v=VS.85).aspxÁ üÝ:e b [mach_absolute_time]: https://developer.apple.com/documentation/kernel/1462446-mach_absolute_timeÁ üÃ;> ; [clock_gettime]: https://linux.die.net/man/3/clock_gettimeÁ ü‚<` ] [prost_types_timestamp]: https://docs.rs/prost-types/0.7.0/prost_types/struct.Timestamp.htmlÁ üã<^ [ [window.performance.now]: https://developer.mozilla.org/en-US/docs/Web/API/Performance/nowÁ 0Y{„…†‡ˆ‰¡¥¦¨©†æíûÀ� ž;ª E Ã"¼ Ö ÉÐ Ë/ Kâ †J ó;ý ¯ ¥ ª
|
|||
|
|
¥ «
|
|||
|
|
ì< ² ‰
|
|||
|
|
U .�e ¼ /Èv  XÈv à Xüš Ø xÉ« Ó y“¼ Î zÜÍ à ƒ� � � üš>#ª œÃ>¼ Ü>lâ>Ð Lñ>â Ì‚?ý Tž? 4¢?
|
|||
|
|
¥<$ ª
|
|||
|
|
¥ «
|
|||
|
|
ìLV ² \ < ª«dü 쀼âüÜ ’" Ä� – Œ Œ’" ®# š
|
|||
|
|
$›´¸l. L2 ìLÞ ² D€ úâ¬Î ì×´å üÍ/ üÉ4 üÀ? $„ ²tS Ó" ¼� ” Ó"®#
|
|||
|
|
$˜¬Ò ›ÔEGd®? < < lÒ? LÖ? üŒ$ 쀼ÙúÙ
|
|||
|
|
ŒöœõüØ1üÏ<œ“
|
|||
|
|
Dá? $å? ¼ž;T E K 9 †J Ã"DD Ö ü# 6 - L3 .t> !̤ üPA > Type which can be converted into a nanosecond representation.Á ’ ú ü–O L This allows users of [`Mock`] to increment/decrement the time both with rawÁ üæ= : integer values and the more convenient [`Duration`] type.Á |® Îì ü¤ˆ ·� ·� Ü� üÄF C Consumes this value, converting it to a nanosecond representation.ÁT’ ¿�®#
|
|||
|
|
¿�$� ä® ®#! ! ÔÑ TÔ ®#®#
|
|||
|
|
! $ß ü„! ·## # Ô¬ T¯ ·#®# " "
|
|||
|
|
# $º LÐ �$%&), Üà î �$ $ $
|
|||
|
|
% ü… 6 üÔ
|
|||
|
|
, ) Increments the time by the given amount.ÁLŒ � ��$ Ÿð2 $ Ÿ ' ' ª $ ÍìÝ“ – Ý“ |™
|
|||
|
|
&Ý“$« amountÁ4± 02 L– & <closure_kind>Á ( <closure_signature>Á ( <upvars>Á ( ( & (Ý“ ®#ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ®# ®# ü©
|
|||
|
|
6 üø , ) Decrements the time by the given amount.ÁL°
|
|||
|
|
Ž Ž�$ Ý“ð2 $ Ÿ * * Î
|
|||
|
|
$ …” º
|
|||
|
|
–”|½
|
|||
|
|
|
|||
|
|
)Ý“$Ï
|
|||
|
|
µ“4Õ
|
|||
|
|
$& Lº )ë“ + ƒ” + ” + + ) +Ý“Ç•™–ÔË üœ* ' Gets the current value of this `Mock`.Á,Ò � ��$ ®# $ Ø $
|
|||
|
|
, $Ù Tó?U U e e \˜@ <œ@ Âà º 0 2 ¿ 0 2®D ¿ß 0 3³T íß 0 4³ Ä 0 4× 4 ¤, 0 5 AddÁ H Ä 0 7 AddAssignÁLM Ùõ 0 8 SubÁ X �ï 0 9 SubAssignÁL] œö 0 :Ã"Dx Ö 0 ;DäæÄƵ·D/—D=‡‰pr^`FHœm:dš Ë$=>?@ABCD ¼Î ü 4 1 Gets the current time, scaled to reference time.Á æ ú üî [ X This method depends on a lazily initialized global clock, which can take up to 200ms toÁ üÎ $ ! initialize and calibrate itself.Á ÷ ú üÿ b _ This method is the spiritual equivalent of [`Instant::now`][instant_now]. It is guaranteed toÁ üæ
|
|||
|
|
, ) return a monotonically increasing value.Á —ú üŸ* ' [instant_now]: std::time::Instant::nowÁ Õ Ë$ < <
|
|||
|
|
= Ôë üŒ@ = Gets the most recent current time, scaled to reference time.Á Ñú üÙ_ \ This method provides ultra-low-overhead access to a slightly-delayed version of the currentÁ ü½^ [ time. Instead of querying the underlying source clock directly, a shared, global value isÁ ü > ; read directly without the need to scale to reference time.Á ãú üëd a The value is updated by running an "upkeep" thread or by calling [`set_recent`][set_recent]. AnÁ üÔG D upkeep thread can be configured and spawned via [`Upkeep`][upkeep].Á ú ü¨Z W If the upkeep thread has not been started, or no value has been set manually, a lazilyÁ ü‡] Z initialized global clock will be used to get the current time. This clock can take up toÁ üé- * 200ms to initialize and calibrate itself.Á ›ú ü£# [set_recent]: crate::set_recentÁ ÜË [upkeep]: crate::UpkeepÁ4ò Ë$ < <
|
|||
|
|
> üŸ : ü¯H E Returns the amount of time elapsed from another instant to this one.Á üú d„ # PanicsÁ •ú ü�\ Y Previous versions of this method panicked when earlier was later than `self`. Currently,Á üþT Q this method saturates to zero. Future versions may reintroduce the panic in someÁ ü×& # circumstances. See [Monotonicity].Á ‚ú üŠ( % [Monotonicity]: Instant#monotonicityÁ ·ú t¿ # ExamplesÁ Òú lÚ
|
|||
|
|
```no_runÁ ´ì use quanta::Clock;Á ä‡ use std::time::Duration;Á ܨ use std::thread::sleep;Á Èú üÐ! let mut clock = Clock::new();Á Ôö let now = clock.now();Á ü• sleep(Duration::new(1, 0));Á ô¹ let new_now = clock.now();Á üÜ2 / println!("{:?}", new_now.duration_since(now));Á <“ ```Át¦ � �Ë$ Ë$·# < µ <
|
|||
|
|
? $¶ earlierÁ<¼ ü³#J ü¨ Z W Returns the amount of time elapsed from another instant to this one, or `None` if thatÁ ü‡ % " instant is earlier than this one.Á ± ú ü¹ ] Z Due to [monotonicity bugs], even under correct logical ordering of the passed `Instant`s,Á ü› " this method can return `None`.Á  ú üÊ - * [monotonicity bugs]: Instant#monotonicityÁ ü ú t„ ±ª — ú lŸ Ôª ´± êª äÌ ‰« Üí ®« �!ú ü•!!ß« Ô»!‰¬ üÚ! ¬ ôþ!Õ¬ ü¡": 7 println!("{:?}", new_now.checked_duration_since(now));Á üà"B ? println!("{:?}", now.checked_duration_since(new_now)); // NoneÁ <§#¸´º# ‘ ‘Ë$ Ë$ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ·# < Ñ# <
|
|||
|
|
@ $Ò#�®<Ø#üâ*E üË$\ Y Returns the amount of time elapsed from another instant to this one, or zero duration ifÁ ü¬%* ' that instant is earlier than this one.Á Û%ú üã%]ɯ üÅ&"°° ì&ú üô&-è° ¦'ú t®'±ª Á'ú lÉ'Ôª ´Û'êª äö'‰« Ü—(®« ·(ú ü¿(!ß« Ôå(‰¬ ü„) ¬ ô¨)Õ¬ üË)= : println!("{:?}", new_now.saturating_duration_since(now));Á ü�*D A println!("{:?}", now.saturating_duration_since(new_now)); // 0nsÁ <Ö*¸Ìé* ’ ’Ë$ Ë$·# < ƒ+ <
|
|||
|
|
A $„+�®<Š+üà1! üö+F C Returns the amount of time elapsed since this instant was created.Á Á,ú dÉ,Ò§ Ú,ú üâ,_ \ Previous `quanta` versions panicked when the current time was earlier than self. CurrentlyÁ üÆ-] Z this method returns a Duration of zero in that case. Future versions may reintroduce theÁ ô¨. panic. See [Monotonicity].Á Ë.ú üÓ.(ô© €/ú tˆ/±ª ›/ú l£/Ôª ´µ/êª äÐ/‰« Üñ/®« ‘0ú ü™0!ß« Ô¿0‰¬ üÞ0 ¬ ü‚1 let elapsed = now.elapsed();Á ü§1( % println!("{:?}", elapsed); // ≥ 1sÁ <Ô1¸<ç1 “ “Ë$ ·# < ï1 <
|
|||
|
|
B $ð1ü€4@ ü®2Z W Returns `Some(t)` where `t` is the time `self + duration` if `t` can be represented asÁ ü�3[ X `Instant` (which means it's inside the bounds of the underlying data structure), `None`Á tí3 otherwise.Á\‡4 ” ”Ë$ ·#ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙË$ < “4 <
|
|||
|
|
C $”4 durationÁDš4ü™7@ üÇ5Z W Returns `Some(t)` where `t` is the time `self - duration` if `t` can be represented asÁ ü¦6[œÀ t†7€Á\ 7 • •Ë$ ·#ºÂ < ¬7 <
|
|||
|
|
D $7¡ÂD³7ôÞ8 Ë$FG Æ Ç G \ƒ94ˆ9 E E Ë$üñ:( dŸ9Ò§ °9ú ü¸9W T This function may panic if the resulting point in time cannot be represented by theÁ ü”:X U underlying data structure. See [`Instant::checked_add`] for a version without panic.Á ô: Ë$·#Ë$ E E
|
|||
|
|
G $ø:¹
|
|||
|
|
,þ:ü…<$ Ë$I Ûõ I ü°<)T³< – –Ë$·#ð2 H ¾< H
|
|||
|
|
I $Ã<¹
|
|||
|
|
,É<ôÚ= Ë$KL �ï �ï L \ÿ=4„> J J Ë$ü›>( ž> Ë$·#Ë$ J J
|