bjoernager/rust
bjoernager/rust
1
Fork 0
Code Activity

Clarify return type of String::from_utf16_lossy.

Browse source 
Fixes https://github.com/rust-lang/rust/issues/32874
This commit is contained in:
Corey Farwell 2017-09-14 15:34:31 -04:00
parent 5dfc84cfa7
commit 258ef37f8e
1 changed files with 7 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

7
src/liballoc/string.rs
View file

@ -622,6 +622,13 @@ impl String {
/// Decode a UTF-16 encoded slice `v` into a `String`, replacing /// Decode a UTF-16 encoded slice `v` into a `String`, replacing
/// invalid data with the replacement character (U+FFFD). /// invalid data with the replacement character (U+FFFD).
/// ///
/// Unlike [`from_utf8_lossy`] which returns a [`Cow<'a, str>`],
/// `from_utf16_lossy` returns a `String` since the UTF-16 to UTF-8
/// conversion requires a memory allocation.
///
/// [`from_utf8_lossy`]: #method.from_utf8_lossy
/// [`Cow<'a, str>`]: ../borrow/enum.Cow.html
///
/// # Examples /// # Examples
/// ///
/// Basic usage: /// Basic usage: