W3cubDocs

/Rust

Function std::fs::symlink_metadata

pub fn symlink_metadata<P: AsRef<Path>>(path: P) -> Result<Metadata>

Query the metadata about a file without following symlinks.

Platform-specific behavior

This function currently corresponds to the lstat function on Unix and the GetFileAttributesEx function on Windows. Note that, this may change in the future.

Errors

This function will return an error in the following situations, but is not limited to just these cases:

  • The user lacks permissions to perform metadata call on path.
  • path does not exist.

Examples

use std::fs;

fn main() -> std::io::Result<()> {
    let attr = fs::symlink_metadata("/some/file/path.txt")?;
    // inspect attr ...
    Ok(())
}

© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/fs/fn.symlink_metadata.html