Function std::fs::create_dir_all 1.0.0
[−]
[src]
pub fn create_dir_all<P: AsRef<Path>>(path: P) -> Result<()>
Recursively create a directory and all of its parent components if they are missing.
Platform-specific behavior
This function currently corresponds to the mkdir function on Unix and the CreateDirectory function on Windows. Note that, this [may change in the future][changes]. [changes]: ../io/index.html#platform-specific-behavior
Errors
This function will return an error in the following situations, but is not limited to just these cases:
- If any directory in the path specified by
pathdoes not already exist and it could not be created otherwise. The specificerror conditions for when a directory is being created (after it isdetermined to not exist) are outlined byfs::create_dir.
Notable exception is made for situations where any of the directories specified in the path could not be created as it was created concurrently. Such cases are considered success. In other words: calling create_dir_all concurrently from multiple threads or processes is guaranteed to not fail due to race itself.
Examples
use std::fs; fs::create_dir_all("/some/dir")?;Run