nordic-dev.net/rust
nordic-dev.net/rust
2
0
Fork 0
mirror of https://github.com/rust-lang/rust.git synced 2025-06-22 20:47:48 +00:00
Code Issues Packages Projects Releases Wiki Activity

Path::with_extension: improve examples

Browse Source
This commit is contained in:
Tshepang Mbambo 2025-05-24 22:12:15 +02:00
parent 3e674b06b5
commit a3bd12b88a
1 changed files with 16 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
library/std/src/path.rs
View File

@ -2743,12 +2743,27 @@ impl Path {
///
/// let path = Path::new("foo.rs");
/// assert_eq!(path.with_extension("txt"), PathBuf::from("foo.txt"));
/// assert_eq!(path.with_extension(""), PathBuf::from("foo"));
/// ```
///
/// Handling multiple extensions:
///
/// ```
/// use std::path::{Path, PathBuf};
///
/// let path = Path::new("foo.tar.gz");
/// assert_eq!(path.with_extension(""), PathBuf::from("foo.tar"));
/// assert_eq!(path.with_extension("xz"), PathBuf::from("foo.tar.xz"));
/// assert_eq!(path.with_extension("").with_extension("txt"), PathBuf::from("foo.txt"));
/// ```
///
/// Adding an extension where one did not exist:
///
/// ```
/// use std::path::{Path, PathBuf};
///
/// let path = Path::new("foo");
/// assert_eq!(path.with_extension("rs"), PathBuf::from("foo.rs"));
/// ```
#[stable(feature = "rust1", since = "1.0.0")]
pub fn with_extension<S: AsRef<OsStr>>(&self, extension: S) -> PathBuf {
self._with_extension(extension.as_ref())