doc: Method examples for String

Reword comments on unsafe methods regarding UTF-8.
auto merge of #16027 : treeman/rust/doc-string, r=alexcrichton