# 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

####
ⓘImportant traits for &'a mut I

### Important traits for &'a mut I

`impl<'a, I> Iterator for &'a mut I where
I: Iterator + ?Sized, type Item = <I as Iterator>::Item;impl<'a, R: Read + ?Sized> Read for &'a mut Rimpl<'a, W: Write + ?Sized> Write for &'a mut W`
`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. Read more

### `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
`↹`
  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`)