bjoernager/rust
bjoernager/rust
1
Fork 0
Code Activity

Rollup merge of #130168 - juliusl:pr/fix-win-fs-change-time-links, r=ChrisDenton

Browse source 
maint: update docs for change_time ext and doc links

maint: update docs for change_time ext and doc links

Related: https://github.com/rust-lang/rust/issues/121478
r? tgross35
This commit is contained in:
Jubilee 2024-09-11 15:53:23 -07:00 • committed by GitHub
commit eb9a4f7ab8
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 14 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

24
library/std/src/os/windows/fs.rs
View file

@ -298,7 +298,7 @@ impl OpenOptionsExt for OpenOptions {
/// of the [`BY_HANDLE_FILE_INFORMATION`] structure. /// of the [`BY_HANDLE_FILE_INFORMATION`] structure.
/// ///
/// [`BY_HANDLE_FILE_INFORMATION`]: /// [`BY_HANDLE_FILE_INFORMATION`]:
/// https://docs.microsoft.com/en-us/windows/win32/api/fileapi/ns-fileapi-by_handle_file_information /// https://docs.microsoft.com/windows/win32/api/fileapi/ns-fileapi-by_handle_file_information
#[stable(feature = "metadata_ext", since = "1.1.0")] #[stable(feature = "metadata_ext", since = "1.1.0")]
pub trait MetadataExt { pub trait MetadataExt {
/// Returns the value of the `dwFileAttributes` field of this metadata. /// Returns the value of the `dwFileAttributes` field of this metadata.
@ -322,7 +322,7 @@ pub trait MetadataExt {
/// ``` /// ```
/// ///
/// [File Attribute Constants]: /// [File Attribute Constants]:
/// https://docs.microsoft.com/en-us/windows/win32/fileio/file-attribute-constants /// https://docs.microsoft.com/windows/win32/fileio/file-attribute-constants
#[stable(feature = "metadata_ext", since = "1.1.0")] #[stable(feature = "metadata_ext", since = "1.1.0")]
fn file_attributes(&self) -> u32; fn file_attributes(&self) -> u32;
@ -351,7 +351,7 @@ pub trait MetadataExt {
/// } /// }
/// ``` /// ```
/// ///
/// [`FILETIME`]: https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime /// [`FILETIME`]: https://docs.microsoft.com/windows/win32/api/minwinbase/ns-minwinbase-filetime
#[stable(feature = "metadata_ext", since = "1.1.0")] #[stable(feature = "metadata_ext", since = "1.1.0")]
fn creation_time(&self) -> u64; fn creation_time(&self) -> u64;
@ -386,7 +386,7 @@ pub trait MetadataExt {
/// } /// }
/// ``` /// ```
/// ///
/// [`FILETIME`]: https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime /// [`FILETIME`]: https://docs.microsoft.com/windows/win32/api/minwinbase/ns-minwinbase-filetime
#[stable(feature = "metadata_ext", since = "1.1.0")] #[stable(feature = "metadata_ext", since = "1.1.0")]
fn last_access_time(&self) -> u64; fn last_access_time(&self) -> u64;
@ -419,11 +419,11 @@ pub trait MetadataExt {
/// } /// }
/// ``` /// ```
/// ///
/// [`FILETIME`]: https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime /// [`FILETIME`]: https://docs.microsoft.com/windows/win32/api/minwinbase/ns-minwinbase-filetime
#[stable(feature = "metadata_ext", since = "1.1.0")] #[stable(feature = "metadata_ext", since = "1.1.0")]
fn last_write_time(&self) -> u64; fn last_write_time(&self) -> u64;
/// Returns the value of the `nFileSize{High,Low}` fields of this /// Returns the value of the `nFileSize` fields of this
/// metadata. /// metadata.
/// ///
/// The returned value does not have meaning for directories. /// The returned value does not have meaning for directories.
@ -462,7 +462,7 @@ pub trait MetadataExt {
#[unstable(feature = "windows_by_handle", issue = "63010")] #[unstable(feature = "windows_by_handle", issue = "63010")]
fn number_of_links(&self) -> Option<u32>; fn number_of_links(&self) -> Option<u32>;
/// Returns the value of the `nFileIndex{Low,High}` fields of this /// Returns the value of the `nFileIndex` fields of this
/// metadata. /// metadata.
/// ///
/// This will return `None` if the `Metadata` instance was created from a /// This will return `None` if the `Metadata` instance was created from a
@ -471,10 +471,14 @@ pub trait MetadataExt {
#[unstable(feature = "windows_by_handle", issue = "63010")] #[unstable(feature = "windows_by_handle", issue = "63010")]
fn file_index(&self) -> Option<u64>; fn file_index(&self) -> Option<u64>;
/// Returns the change time, which is the last time file metadata was changed, such as /// Returns the value of the `ChangeTime` fields of this metadata.
/// renames, attributes, etc
/// ///
/// This will return `None` if the `Metadata` instance was not created using the `FILE_BASIC_INFO` type. /// `ChangeTime` is the last time file metadata was changed, such as
/// renames, attributes, etc.
///
/// This will return `None` if `Metadata` instance was created from a call to
/// `DirEntry::metadata` or if the `target_vendor` is outside the current platform
/// support for this api.
#[unstable(feature = "windows_change_time", issue = "121478")] #[unstable(feature = "windows_change_time", issue = "121478")]
fn change_time(&self) -> Option<u64>; fn change_time(&self) -> Option<u64>;
} }