mikros/rust
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Rollup merge of #42955 - matklad:doc-path, r=steveklabnik

Browse Source 
Document that `/` works as separator on Windows

Hi Whenever I see code like `Path::new("./src/bin/main.rs")` or `path.ends_with("foo/bar")`, I wonder if it will work on Windows as I expect. Unfortunately, reading the current docs does not help to answer this question, because all examples are Unix-specific.

However, I believe that using `/` is fine, because both Windows itself [and Rust stdlib](47faf1d519/src/libstd/sys/windows/path.rs (L26)) do treat it as a file separator, and because it is [actually used](abf01e1edd/tests/git.rs (L579)) in Cargo. So looks like we can just document it?

r? @steveklabnik

cc @retep998 I don't actually program for windows that much, so I might be totally wrong, and perhaps we should advise to always use (allocating) `.join` method to construct paths of more than one component?
This commit is contained in:
Ariel Ben-Yehuda 2017-06-29 08:40:12 +00:00 committed by GitHub
commit b0ed6d11e1
1 changed files with 7 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
src/libstd/path.rs
View File

@ -276,7 +276,7 @@ impl<'a> Prefix<'a> {
/// ``` /// ```
/// use std::path; /// use std::path;
/// ///
/// assert!(path::is_separator('/')); /// assert!(path::is_separator('/')); // '/' works for both Unix and Windows
/// assert!(!path::is_separator('❤')); /// assert!(!path::is_separator('❤'));
/// ``` /// ```
#[stable(feature = "rust1", since = "1.0.0")] #[stable(feature = "rust1", since = "1.0.0")]
@ -1499,9 +1499,9 @@ impl AsRef<OsStr> for PathBuf {
/// A slice of a path (akin to [`str`]). /// A slice of a path (akin to [`str`]).
/// ///
/// This type supports a number of operations for inspecting a path, including /// This type supports a number of operations for inspecting a path, including
/// breaking the path into its components (separated by `/` or `\`, depending on /// breaking the path into its components (separated by `/` on Unix and by either
/// the platform), extracting the file name, determining whether the path is /// `/` or `\` on Windows), extracting the file name, determining whether the path
/// absolute, and so on. /// is absolute, and so on.
/// ///
/// This is an *unsized* type, meaning that it must always be used behind a /// This is an *unsized* type, meaning that it must always be used behind a
/// pointer like `&` or [`Box`]. For an owned version of this type, /// pointer like `&` or [`Box`]. For an owned version of this type,
@ -1520,10 +1520,11 @@ impl AsRef<OsStr> for PathBuf {
/// use std::path::Path; /// use std::path::Path;
/// use std::ffi::OsStr; /// use std::ffi::OsStr;
/// ///
/// let path = Path::new("/tmp/foo/bar.txt"); /// // Note: this example does work on Windows
/// let path = Path::new("./foo/bar.txt");
/// ///
/// let parent = path.parent(); /// let parent = path.parent();
/// assert_eq!(parent, Some(Path::new("/tmp/foo"))); /// assert_eq!(parent, Some(Path::new("./foo")));
/// ///
/// let file_stem = path.file_stem(); /// let file_stem = path.file_stem();
/// assert_eq!(file_stem, Some(OsStr::new("bar"))); /// assert_eq!(file_stem, Some(OsStr::new("bar")));