Rollup merge of rust-lang#125112 - tbu-:pr_create_dir_all_empty, r=dt…

…olnay Document behavior of `create_dir_all` wrt. empty path The behavior makes sense because `Path::new("one_component").parent() == Some(Path::new(""))`, so if one naively wants to create the parent directory for a file to be written, it simply works. Closes rust-lang#105108 by documenting the current behavior.
jaisnan · Jun 16, 2024 · 04e46c2 · 04e46c2
2 parents ae7f43e + 8fa3f60
commit 04e46c2
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/std/src/fs.rs b/std/src/fs.rs
@@ -2386,6 +2386,9 @@ pub fn create_dir<P: AsRef<Path>>(path: P) -> io::Result<()> {
 /// If this function returns an error, some of the parent components might have
 /// been created already.
 ///
+/// If the empty path is passed to this function, it always succeeds without
+/// creating any directories.
+///
 /// # Platform-specific behavior
 ///
 /// This function currently corresponds to multiple calls to the `mkdir`