File tree 2 files changed +8
-3
lines changed
2 files changed +8
-3
lines changed Original file line number Diff line number Diff line change @@ -770,7 +770,10 @@ impl String {
770
770
/// * The first `length` bytes at `buf` need to be valid UTF-8.
771
771
///
772
772
/// Violating these may cause problems like corrupting the allocator's
773
- /// internal data structures.
773
+ /// internal data structures. For example, it is normally **not** safe to
774
+ /// build a `String` from a pointer to a C `char` array containing UTF-8
775
+ /// _unless_ you are certain that array was originally allocated by the
776
+ /// Rust standard library's allocator.
774
777
///
775
778
/// The ownership of `buf` is effectively transferred to the
776
779
/// `String` which may then deallocate, reallocate or change the
Original file line number Diff line number Diff line change @@ -489,8 +489,10 @@ impl<T> Vec<T> {
489
489
/// * `length` needs to be less than or equal to `capacity`.
490
490
///
491
491
/// Violating these may cause problems like corrupting the allocator's
492
- /// internal data structures. For example it is **not** safe
493
- /// to build a `Vec<u8>` from a pointer to a C `char` array with length `size_t`.
492
+ /// internal data structures. For example it is normally **not** safe
493
+ /// to build a `Vec<u8>` from a pointer to a C `char` array with length
494
+ /// `size_t`, doing so is only safe if the array was initially allocated by
495
+ /// a `Vec` or `String`.
494
496
/// It's also not safe to build one from a `Vec<u16>` and its length, because
495
497
/// the allocator cares about the alignment, and these two types have different
496
498
/// alignments. The buffer was allocated with alignment 2 (for `u16`), but after
You can’t perform that action at this time.
0 commit comments