mpvrc/rustix/fs/trait.StatExt.html

16 lines
No EOL
6.5 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Extension trait for accessing timestamp fields of `Stat`."><title>StatExt in rustix::fs - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../static.files/rustdoc-42caa33d.css"><meta name="rustdoc-vars" data-root-path="../../" data-static-root-path="../../static.files/" data-current-crate="rustix" data-themes="" data-resource-suffix="" data-rustdoc-version="1.84.1 (e71f9a9a9 2025-01-27)" data-channel="1.84.1" data-search-js="search-92e6798f.js" data-settings-js="settings-0f613d39.js" ><script src="../../static.files/storage-59e33391.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../static.files/main-5f194d8c.js"></script><noscript><link rel="stylesheet" href="../../static.files/noscript-893ab5e7.css"></noscript><link rel="alternate icon" type="image/png" href="../../static.files/favicon-32x32-6580c154.png"><link rel="icon" type="image/svg+xml" href="../../static.files/favicon-044be391.svg"></head><body class="rustdoc trait"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle" title="show sidebar"></button></nav><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../rustix/index.html">rustix</a><span class="version">0.38.42</span></h2></div><div class="sidebar-elems"><section id="rustdoc-toc"><h2 class="location"><a href="#">StatExt</a></h2><h3><a href="#required-methods">Required Methods</a></h3><ul class="block"><li><a href="#tymethod.atime" title="atime">atime</a></li><li><a href="#tymethod.ctime" title="ctime">ctime</a></li><li><a href="#tymethod.mtime" title="mtime">mtime</a></li></ul><h3><a href="#implementors">Implementors</a></h3></section><div id="rustdoc-modnav"><h2><a href="index.html">In rustix::<wbr>fs</a></h2></div></div></nav><div class="sidebar-resizer"></div><main><div class="width-limiter"><rustdoc-search></rustdoc-search><section id="main-content" class="content"><div class="main-heading"><span class="rustdoc-breadcrumbs"><a href="../index.html">rustix</a>::<wbr><a href="index.html">fs</a></span><h1>Trait <span class="trait">StatExt</span><button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../src/rustix/fs/mod.rs.html#156-163">Source</a> </span></div><pre class="rust item-decl"><code>pub trait StatExt {
// Required methods
fn <a href="#tymethod.atime" class="fn">atime</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.84.1/std/primitive.i64.html">i64</a>;
<span class="item-spacer"></span> fn <a href="#tymethod.mtime" class="fn">mtime</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.84.1/std/primitive.i64.html">i64</a>;
<span class="item-spacer"></span> fn <a href="#tymethod.ctime" class="fn">ctime</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.84.1/std/primitive.i64.html">i64</a>;
}</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Extension trait for accessing timestamp fields of <code>Stat</code>.</p>
<p>Rustixs <code>Stat</code> type on some platforms has unsigned <code>st_mtime</code>,
<code>st_atime</code>, and <code>st_ctime</code> fields. This is incorrect, as Unix defines
these fields to be signed, with negative values representing dates before
the Unix epoch. Until the next semver bump, these unsigned fields are
deprecated, and this trait provides accessors which return their values
as signed integers.</p>
</div></details><h2 id="required-methods" class="section-header">Required Methods<a href="#required-methods" class="anchor">§</a></h2><div class="methods"><details class="toggle method-toggle" open><summary><section id="tymethod.atime" class="method"><a class="src rightside" href="../../src/rustix/fs/mod.rs.html#158">Source</a><h4 class="code-header">fn <a href="#tymethod.atime" class="fn">atime</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.84.1/std/primitive.i64.html">i64</a></h4></section></summary><div class="docblock"><p>Return the value of the <code>st_atime</code> field, casted to the correct type.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="tymethod.mtime" class="method"><a class="src rightside" href="../../src/rustix/fs/mod.rs.html#160">Source</a><h4 class="code-header">fn <a href="#tymethod.mtime" class="fn">mtime</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.84.1/std/primitive.i64.html">i64</a></h4></section></summary><div class="docblock"><p>Return the value of the <code>st_mtime</code> field, casted to the correct type.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="tymethod.ctime" class="method"><a class="src rightside" href="../../src/rustix/fs/mod.rs.html#162">Source</a><h4 class="code-header">fn <a href="#tymethod.ctime" class="fn">ctime</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.84.1/std/primitive.i64.html">i64</a></h4></section></summary><div class="docblock"><p>Return the value of the <code>st_ctime</code> field, casted to the correct type.</p>
</div></details></div><h2 id="implementors" class="section-header">Implementors<a href="#implementors" class="anchor">§</a></h2><div id="implementors-list"><section id="impl-StatExt-for-stat" class="impl"><a class="src rightside" href="../../src/rustix/fs/mod.rs.html#170-185">Source</a><a href="#impl-StatExt-for-stat" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.StatExt.html" title="trait rustix::fs::StatExt">StatExt</a> for <a class="type" href="type.Stat.html" title="type rustix::fs::Stat">Stat</a></h3></section></div><script src="../../trait.impl/rustix/fs/trait.StatExt.js" async></script></section></div></main></body></html>