std::os::linux::fs::MetadataExt - Rust
Description: API documentation for the Rust `MetadataExt` trait in crate `std`.
Keywords: rust, rustlang, rust-lang, MetadataExt

# 1.1.0[−][src]Trait std::os::linux::fs::MetadataExt

    pub trait MetadataExt {
        fn as_raw_stat(&self) -> &stat;
        fn st_dev(&self) -> u64;
        fn st_ino(&self) -> u64;
        fn st_mode(&self) -> u32;
        fn st_nlink(&self) -> u64;
        fn st_uid(&self) -> u32;
        fn st_gid(&self) -> u32;
        fn st_rdev(&self) -> u64;
        fn st_size(&self) -> u64;
        fn st_atime(&self) -> i64;
        fn st_atime_nsec(&self) -> i64;
        fn st_mtime(&self) -> i64;
        fn st_mtime_nsec(&self) -> i64;
        fn st_ctime(&self) -> i64;
        fn st_ctime_nsec(&self) -> i64;
        fn st_blksize(&self) -> u64;
        fn st_blocks(&self) -> u64;
    }

This is supported on Linux only.

OS-specific extensions to `fs::Metadata`.

## Required methods

### `fn as_raw_stat(&self) -> &stat`

Deprecated since 1.8.0:

deprecated in favor of the accessor methods of this trait

This is supported on Linux only.

Gain a reference to the underlying `stat` structure which contains the raw information returned by the OS.

The contents of the returned `stat` are not consistent across Unix platforms. The `os::unix::fs::MetadataExt` trait contains the cross-Unix abstractions contained within the raw stat.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        let stat = meta.as_raw_stat();
        Ok(())
    }Run

### `fn st_dev(&self) -> u64`1.8.0

This is supported on Linux only.

Returns the device ID on which this file resides.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_dev());
        Ok(())
    }Run

### `fn st_ino(&self) -> u64`1.8.0

This is supported on Linux only.

Returns the inode number.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_ino());
        Ok(())
    }Run

### `fn st_mode(&self) -> u32`1.8.0

This is supported on Linux only.

Returns the file type and mode.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_mode());
        Ok(())
    }Run

### `fn st_nlink(&self) -> u64`1.8.0

This is supported on Linux only.

Returns the number of hard links to file.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_nlink());
        Ok(())
    }Run

### `fn st_uid(&self) -> u32`1.8.0

This is supported on Linux only.

Returns the user ID of the file owner.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_uid());
        Ok(())
    }Run

### `fn st_gid(&self) -> u32`1.8.0

This is supported on Linux only.

Returns the group ID of the file owner.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_gid());
        Ok(())
    }Run

### `fn st_rdev(&self) -> u64`1.8.0

This is supported on Linux only.

Returns the device ID that this file represents. Only relevant for special file.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_rdev());
        Ok(())
    }Run

### `fn st_size(&self) -> u64`1.8.0

This is supported on Linux only.

Returns the size of the file (if it is a regular file or a symbolic link) in bytes.

The size of a symbolic link is the length of the pathname it contains, without a terminating null byte.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_size());
        Ok(())
    }Run

### `fn st_atime(&self) -> i64`1.8.0

This is supported on Linux only.

Returns the last access time of the file, in seconds since Unix Epoch.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_atime());
        Ok(())
    }Run

### `fn st_atime_nsec(&self) -> i64`1.8.0

This is supported on Linux only.

Returns the last access time of the file, in nanoseconds since `st_atime`.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_atime_nsec());
        Ok(())
    }Run

### `fn st_mtime(&self) -> i64`1.8.0

This is supported on Linux only.

Returns the last modification time of the file, in seconds since Unix Epoch.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_mtime());
        Ok(())
    }Run

### `fn st_mtime_nsec(&self) -> i64`1.8.0

This is supported on Linux only.

Returns the last modification time of the file, in nanoseconds since `st_mtime`.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_mtime_nsec());
        Ok(())
    }Run

### `fn st_ctime(&self) -> i64`1.8.0

This is supported on Linux only.

Returns the last status change time of the file, in seconds since Unix Epoch.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_ctime());
        Ok(())
    }Run

### `fn st_ctime_nsec(&self) -> i64`1.8.0

This is supported on Linux only.

Returns the last status change time of the file, in nanoseconds since `st_ctime`.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_ctime_nsec());
        Ok(())
    }Run

### `fn st_blksize(&self) -> u64`1.8.0

This is supported on Linux only.

Returns the "preferred" blocksize for efficient filesystem I/O.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_blksize());
        Ok(())
    }Run

### `fn st_blocks(&self) -> u64`1.8.0

This is supported on Linux only.

Returns the number of blocks allocated to the file, 512-byte units.

# Examples

    use std::fs;
    use std::io;
    use std::os::linux::fs::MetadataExt;

    fn main() -> io::Result<()> {
        let meta = fs::metadata("some_file")?;
        println!("{}", meta.st_blocks());
        Ok(())
    }Run

Loading content...

## Implementors

### `impl MetadataExt for Metadata`[src]

#### `fn as_raw_stat(&self) -> &stat`[src]

Deprecated since 1.8.0:

deprecated in favor of the accessor methods of this trait

This is supported on Linux only.

#### `fn st_dev(&self) -> u64`[src]

This is supported on Linux only.

#### `fn st_ino(&self) -> u64`[src]

This is supported on Linux only.

#### `fn st_mode(&self) -> u32`[src]

This is supported on Linux only.

#### `fn st_nlink(&self) -> u64`[src]

This is supported on Linux only.

#### `fn st_uid(&self) -> u32`[src]

This is supported on Linux only.

#### `fn st_gid(&self) -> u32`[src]

This is supported on Linux only.

#### `fn st_rdev(&self) -> u64`[src]

This is supported on Linux only.

#### `fn st_size(&self) -> u64`[src]

This is supported on Linux only.

#### `fn st_atime(&self) -> i64`[src]

This is supported on Linux only.

#### `fn st_atime_nsec(&self) -> i64`[src]

This is supported on Linux only.

#### `fn st_mtime(&self) -> i64`[src]

This is supported on Linux only.

#### `fn st_mtime_nsec(&self) -> i64`[src]

This is supported on Linux only.

#### `fn st_ctime(&self) -> i64`[src]

This is supported on Linux only.

#### `fn st_ctime_nsec(&self) -> i64`[src]

This is supported on Linux only.

#### `fn st_blksize(&self) -> u64`[src]

This is supported on Linux only.

#### `fn st_blocks(&self) -> u64`[src]

This is supported on Linux only.
Loading content...

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g., `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g., `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g., `str,u8` or `String,struct:Vec,test`)