Rollup merge of #40335 - tbu-:pr_doc_str_to_somecase, r=steveklabnik

Document why `str.to_{lower,upper}case` return `String`

Fixes #39201.
This commit is contained in:
Ariel Ben-Yehuda 2017-03-08 20:54:10 +02:00 committed by GitHub
commit f2886e8bda

View File

@ -1646,6 +1646,10 @@ impl str {
/// 'Lowercase' is defined according to the terms of the Unicode Derived Core Property
/// `Lowercase`.
///
/// Since some characters can expand into multiple characters when changing
/// the case, this function returns a [`String`] instead of modifying the
/// parameter in-place.
///
/// [`String`]: string/struct.String.html
///
/// # Examples
@ -1718,6 +1722,10 @@ impl str {
/// 'Uppercase' is defined according to the terms of the Unicode Derived Core Property
/// `Uppercase`.
///
/// Since some characters can expand into multiple characters when changing
/// the case, this function returns a [`String`] instead of modifying the
/// parameter in-place.
///
/// [`String`]: string/struct.String.html
///
/// # Examples