Function core::slice::from_ptr_range
const: unstable · source · pub unsafe fn from_ptr_range<'a, T>(range: Range<*const T>) -> &'a [T]
🔬This is a nightly-only experimental API. (
slice_from_ptr_range
#89792)Expand description
从指针范围形成一个切片。
此函数对于与外部接口进行交互很有用,该外部接口使用两个指针来引用内存中的一系列元素,这在 C++ 中很常见。
Safety
如果违反以下任一条件,则行为是未定义的:
-
范围的
start
指针必须是 valid 并正确对齐指向切片的第一个元素的指针。 -
end
指针必须是 valid 且正确对齐的指针,指向一个过去最后一个元素,这样从末尾到起始指针的偏移量就是切片的长度。 -
范围必须包含
N
类型T
的连续正确初始化值:- 该切片的整个存储范围必须包含在一个分配的对象中! 切片永远不能跨越多个分配的对象。
-
返回的切片引用的内存在生命周期
'a
期间不得更改,除非在UnsafeCell
内部。 -
范围的总长度不得大于
isize::MAX
。 请参见pointer::offset
的安全文档。
请注意,从 slice::as_ptr_range
创建的范围满足这些要求。
Panics
如果 T
是一个零大小的类型 (“ZST”),这个函数就会出现 panic。
Caveat
从使用中可以推断出返回切片的生命周期。 为防止意外滥用,建议将生命周期与生命周期中任何安全的来源联系起来,例如通过提供一个辅助函数,获取切片的宿主值的生命周期,或通过明确的注解法。
Examples
#![feature(slice_from_ptr_range)]
use core::slice;
let x = [1, 2, 3];
let range = x.as_ptr_range();
unsafe {
assert_eq!(slice::from_ptr_range(range), &x);
}
Run