std::fs::DirBuilder - Rust
Description: API documentation for the Rust `DirBuilder` struct in crate `std`.
Keywords: rust, rustlang, rust-lang, DirBuilder

# Struct std::fs::DirBuilder 1.6.0 [−] [src]

    pub struct DirBuilder { /* fields omitted */ }

A builder used to create directories in various manners.

This builder also supports platform-specific options.

## Methods

### `impl DirBuilder`
[src]

#### `pub fn new() -> DirBuilder`
[src]

Creates a new set of options with default mode/security settings for all platforms and also non-recursive.

# Examples

    use std::fs::DirBuilder;

    let builder = DirBuilder::new();Run

#### `pub fn recursive(&mut self, recursive: bool) -> &mut Self`
[src]

Indicates that directories should be created recursively, creating all parent directories. Parents that do not exist are created with the same security and permissions settings.

This option defaults to `false`.

# Examples

    use std::fs::DirBuilder;

    let mut builder = DirBuilder::new();
    builder.recursive(true);Run

#### `pub fn create<P: AsRef<Path>>(&self, path: P) -> Result<()>`
[src]

Create the specified directory with the options configured in this builder.

It is considered an error if the directory already exists unless recursive mode is enabled.

# Examples

    use std::fs::{self, DirBuilder};

    let path = "/tmp/foo/bar/baz";
    DirBuilder::new()
        .recursive(true)
        .create(path).unwrap();

    assert!(fs::metadata(path).unwrap().is_dir());Run

## Trait Implementations

### `impl Debug for DirBuilder`
[src]

#### `fn fmt(&self, __arg_0: &mut Formatter) -> Result`
[src]

Formats the value using the given formatter.

### `impl DirBuilderExt for DirBuilder`
[src]

#### `fn mode(&mut self, mode: u32) -> &mut DirBuilder`
[src]

This is supported on Unix only.

Sets the mode to create new directories with. This option defaults to 0o777. Read more

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand 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`)