Rollup merge of #64069 - danielhenrymantilla:feature/cstring_from_vec_of_nonzerou8, r=KodrAus
Added From<Vec<NonZeroU8>> for CString Added a `From<Vec<NonZeroU8>>` `impl` for `CString` # Rationale - `CString::from_vec_unchecked` is a subtle function, that makes `unsafe` code harder to audit when the generated `Vec`'s creation is non-trivial. This `impl` allows to write safer `unsafe` code thanks to the very explicit semantics of the `Vec<NonZeroU8>` type. - One such situation is when trying to `.read()` a `CString`, see issue #59229. - this lead to a PR: #59314, that was closed for being too specific / narrow (it only targetted being able to `.read()` a `CString`, when this pattern could have been generalized). - the issue suggested another route, based on `From<Vec<NonZeroU8>>`, which is indeed a less general and more concise code pattern. - quoting @shnatsel: - > For me the main thing about making this safe is simplifying auditing - people have spent like an hour looking at just this one unsafe block in libflate because it's not clear what exactly is unchecked, so you have to look it up when auditing anyway. This has distracted us from much more serious memory safety issues the library had. Having this trivial impl in stdlib would turn this into safe code with compiler more or less guaranteeing that it's fine, and save anyone auditing the code a whole lot of time.
This commit is contained in:
commit
d28b35812f
@ -6,6 +6,7 @@ use crate::fmt::{self, Write};
|
|||||||
use crate::io;
|
use crate::io;
|
||||||
use crate::mem;
|
use crate::mem;
|
||||||
use crate::memchr;
|
use crate::memchr;
|
||||||
|
use crate::num::NonZeroU8;
|
||||||
use crate::ops;
|
use crate::ops;
|
||||||
use crate::os::raw::c_char;
|
use crate::os::raw::c_char;
|
||||||
use crate::ptr;
|
use crate::ptr;
|
||||||
@ -741,6 +742,32 @@ impl From<Box<CStr>> for CString {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[stable(feature = "cstring_from_vec_of_nonzerou8", since = "1.43.0")]
|
||||||
|
impl From<Vec<NonZeroU8>> for CString {
|
||||||
|
/// Converts a [`Vec`]`<`[`NonZeroU8`]`>` into a [`CString`] without
|
||||||
|
/// copying nor checking for inner null bytes.
|
||||||
|
///
|
||||||
|
/// [`CString`]: ../ffi/struct.CString.html
|
||||||
|
/// [`NonZeroU8`]: ../num/struct.NonZeroU8.html
|
||||||
|
/// [`Vec`]: ../vec/struct.Vec.html
|
||||||
|
#[inline]
|
||||||
|
fn from(v: Vec<NonZeroU8>) -> CString {
|
||||||
|
unsafe {
|
||||||
|
// Transmute `Vec<NonZeroU8>` to `Vec<u8>`.
|
||||||
|
let v: Vec<u8> = {
|
||||||
|
// Safety:
|
||||||
|
// - transmuting between `NonZeroU8` and `u8` is sound;
|
||||||
|
// - `alloc::Layout<NonZeroU8> == alloc::Layout<u8>`.
|
||||||
|
let (ptr, len, cap): (*mut NonZeroU8, _, _) = Vec::into_raw_parts(v);
|
||||||
|
Vec::from_raw_parts(ptr.cast::<u8>(), len, cap)
|
||||||
|
};
|
||||||
|
// Safety: `v` cannot contain null bytes, given the type-level
|
||||||
|
// invariant of `NonZeroU8`.
|
||||||
|
CString::from_vec_unchecked(v)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
#[stable(feature = "more_box_slice_clone", since = "1.29.0")]
|
#[stable(feature = "more_box_slice_clone", since = "1.29.0")]
|
||||||
impl Clone for Box<CStr> {
|
impl Clone for Box<CStr> {
|
||||||
#[inline]
|
#[inline]
|
||||||
|
@ -309,6 +309,7 @@
|
|||||||
#![feature(unboxed_closures)]
|
#![feature(unboxed_closures)]
|
||||||
#![feature(untagged_unions)]
|
#![feature(untagged_unions)]
|
||||||
#![feature(unwind_attributes)]
|
#![feature(unwind_attributes)]
|
||||||
|
#![feature(vec_into_raw_parts)]
|
||||||
// NB: the above list is sorted to minimize merge conflicts.
|
// NB: the above list is sorted to minimize merge conflicts.
|
||||||
#![default_lib_allocator]
|
#![default_lib_allocator]
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user