//! 编译器内部函数。
//!
//! 相应的定义在 <https://github.com/rust-lang/rust/blob/master/compiler/rustc_codegen_llvm/src/intrinsic.rs> 中。
//! 相应的常量实现在 <https://github.com/rust-lang/rust/blob/master/compiler/rustc_const_eval/src/interpret/intrinsics.rs> 中。
//!
//! # 常量内部函数
//!
//! Note: 对内部函数常量的任何更改都应与语言团队讨论。
//! 这包括常量稳定性的变化。
//!
//! 为了使内部函数在编译时可用，需要将实现从 <https://github.com/rust-lang/miri/blob/master/src/shims/intrinsics.rs> 复制到 <https://github.com/rust-lang/rust/blob/master/compiler/rustc_const_eval/src/interpret/intrinsics.rs> 并将 `#[rustc_const_unstable(feature = "const_such_and_such", issue = "01234")]` 添加到函数声明中。
//!
//!
//! 如果应该从具有 `rustc_const_stable` 属性的 `const fn` 使用内部函数，则内部函数的属性也必须为 `rustc_const_stable`。如果没有 T-lang 协商会，就不应该进行此类更改，因为它把一个特性融入到语言中，如果没有编译器支持，就不能在用户代码中复制。
//!
//! # Volatiles
//!
//! volatile 内部函数提供旨在作用于 I/O 内存的操作，并保证编译器不会在其他 volatile 内部函数之间对它们进行重新排序。请参见 [[volatile]] 上的 LLVM 文档。
//!
//! [volatile]: https://llvm.org/docs/LangRef.html#volatile-memory-accesses
//!
//! # Atomics
//!
//! 原子内部函数对机器字提供常见的原子操作，并具有多种可能的存储顺序。它们遵循与 C++ 11 相同的语义。请参见 [[atomics]] 上的 LLVM 文档。
//!
//! [atomics]: https://llvm.org/docs/Atomics.html
//!
//! 关于内存排序的快速回顾：
//!
//! * 获取 - 获取锁的障碍。屏障之后将进行后续的读取和写入。
//! * 释放 - 释放锁的障碍物。之前的读取和写入发生在该屏障之前。
//! * 顺序一致 - 顺序一致的操作可保证按顺序进行。这是处理原子类型的标准模式，等效于 Java 的 `volatile`。
//!
//!
//!
//!
//!
//!
//!
//!
//!
//!
//!
//!
//!
//!

#![unstable(
    feature = "core_intrinsics",
    reason = "intrinsics are unlikely to ever be stabilized, instead \
                      they should be used through stabilized interfaces \
                      in the rest of the standard library",
    issue = "none"
)]
#![allow(missing_docs)]

use crate::marker::DiscriminantKind;
use crate::marker::Tuple;
use crate::mem;

pub mod mir;

// 这些导入用于简化文档内链接
#[allow(unused_imports)]
#[cfg(all(target_has_atomic = "8", target_has_atomic = "32", target_has_atomic = "ptr"))]
use crate::sync::atomic::{self, AtomicBool, AtomicI32, AtomicIsize, AtomicU32, Ordering};

#[stable(feature = "drop_in_place", since = "1.8.0")]
#[rustc_allowed_through_unstable_modules]
#[deprecated(note = "no longer an intrinsic - use `ptr::drop_in_place` directly", since = "1.52.0")]
#[inline]
pub unsafe fn drop_in_place<T: ?Sized>(to_drop: *mut T) {
    // SAFETY: 请参见 `ptr::drop_in_place`
    unsafe { crate::ptr::drop_in_place(to_drop) }
}

extern "rust-intrinsic" {
    // 注意，这些内部函数采用裸指针，因为它们会使别名内存发生可变的，这对于 `&` 或 `&mut` 均无效。
    //

    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 内部函数的稳定版本可通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，方法是将 [`Ordering::Relaxed`] 作为成功和失败参数传递。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_relaxed_relaxed<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Relaxed`] 和 [`Ordering::Acquire`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_relaxed_acquire<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Relaxed`] 和 [`Ordering::SeqCst`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_relaxed_seqcst<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Acquire`] 和 [`Ordering::Relaxed`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_acquire_relaxed<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 内部函数的稳定版本可通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，方法是将 [`Ordering::Acquire`] 作为成功和失败参数传递。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_acquire_acquire<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Acquire`] 和 [`Ordering::SeqCst`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_acquire_seqcst<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Release`] 和 [`Ordering::Relaxed`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_release_relaxed<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Release`] 和 [`Ordering::Acquire`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_release_acquire<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Release`] 和 [`Ordering::SeqCst`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_release_seqcst<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::AcqRel`] 和 [`Ordering::Relaxed`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_acqrel_relaxed<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::AcqRel`] 和 [`Ordering::Acquire`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_acqrel_acquire<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::AcqRel`] 和 [`Ordering::SeqCst`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_acqrel_seqcst<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::SeqCst`] 和 [`Ordering::Relaxed`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_seqcst_relaxed<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::SeqCst`] 和 [`Ordering::Acquire`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_seqcst_acquire<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 内部函数的稳定版本可通过 `compare_exchange` 方法在 [`atomic`] 类型上使用，方法是将 [`Ordering::SeqCst`] 作为成功和失败参数传递。
    ///
    /// 例如，[`AtomicBool::compare_exchange`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchg_seqcst_seqcst<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);

    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 内部函数的稳定版本可通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，方法是将 [`Ordering::Relaxed`] 作为成功和失败参数传递。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_relaxed_relaxed<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Relaxed`] 和 [`Ordering::Acquire`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_relaxed_acquire<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Relaxed`] 和 [`Ordering::SeqCst`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_relaxed_seqcst<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Acquire`] 和 [`Ordering::Relaxed`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_acquire_relaxed<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 内部函数的稳定版本可通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，方法是将 [`Ordering::Acquire`] 作为成功和失败参数传递。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_acquire_acquire<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Acquire`] 和 [`Ordering::SeqCst`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_acquire_seqcst<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Release`] 和 [`Ordering::Relaxed`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_release_relaxed<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Release`] 和 [`Ordering::Acquire`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_release_acquire<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::Release`] 和 [`Ordering::SeqCst`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_release_seqcst<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::AcqRel`] 和 [`Ordering::Relaxed`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_acqrel_relaxed<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::AcqRel`] 和 [`Ordering::Acquire`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_acqrel_acquire<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::AcqRel`] 和 [`Ordering::SeqCst`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_acqrel_seqcst<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::SeqCst`] 和 [`Ordering::Relaxed`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_seqcst_relaxed<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 这个内部函数的稳定版本可以通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，通过传递 [`Ordering::SeqCst`] 和 [`Ordering::Acquire`] 作为成功和失败参数。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_seqcst_acquire<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);
    /// 如果当前值与 `old` 值相同，则存储一个值。
    ///
    /// 内部函数的稳定版本可通过 `compare_exchange_weak` 方法在 [`atomic`] 类型上使用，方法是将 [`Ordering::SeqCst`] 作为成功和失败参数传递。
    ///
    /// 例如，[`AtomicBool::compare_exchange_weak`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_cxchgweak_seqcst_seqcst<T: Copy>(dst: *mut T, old: T, src: T) -> (T, bool);

    /// 加载指针的当前值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 作为 `order` 传递，可以通过 `load` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::load`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_load_seqcst<T: Copy>(src: *const T) -> T;
    /// 加载指针的当前值。
    ///
    /// 通过将 [`Ordering::Acquire`] 作为 `order` 传递，可以通过 `load` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::load`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_load_acquire<T: Copy>(src: *const T) -> T;
    /// 加载指针的当前值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 作为 `order` 传递，可以通过 `load` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::load`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_load_relaxed<T: Copy>(src: *const T) -> T;
    #[rustc_nounwind]
    pub fn atomic_load_unordered<T: Copy>(src: *const T) -> T;

    /// 将值存储在指定的存储位置。
    ///
    /// 通过将 [`Ordering::SeqCst`] 作为 `order` 传递，可以通过 `store` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::store`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_store_seqcst<T: Copy>(dst: *mut T, val: T);
    /// 将值存储在指定的存储位置。
    ///
    /// 通过将 [`Ordering::Release`] 作为 `order` 传递，可以通过 `store` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::store`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_store_release<T: Copy>(dst: *mut T, val: T);
    /// 将值存储在指定的存储位置。
    ///
    /// 通过将 [`Ordering::Relaxed`] 作为 `order` 传递，可以通过 `store` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::store`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_store_relaxed<T: Copy>(dst: *mut T, val: T);
    #[rustc_nounwind]
    pub fn atomic_store_unordered<T: Copy>(dst: *mut T, val: T);

    /// 将值存储在指定的内存位置，并返回旧值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 作为 `order` 传递，可以通过 `swap` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::swap`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xchg_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 将值存储在指定的内存位置，并返回旧值。
    ///
    /// 通过将 [`Ordering::Acquire`] 作为 `order` 传递，可以通过 `swap` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::swap`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xchg_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 将值存储在指定的内存位置，并返回旧值。
    ///
    /// 通过将 [`Ordering::Release`] 作为 `order` 传递，可以通过 `swap` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::swap`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xchg_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 将值存储在指定的内存位置，并返回旧值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 作为 `order` 传递，可以通过 `swap` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::swap`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xchg_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 将值存储在指定的内存位置，并返回旧值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 作为 `order` 传递，可以通过 `swap` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::swap`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xchg_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 加到当前值，返回前一个值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 作为 `order` 传递，可以通过 `fetch_add` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicIsize::fetch_add`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xadd_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 加到当前值，返回前一个值。
    ///
    /// 通过将 [`Ordering::Acquire`] 作为 `order` 传递，可以通过 `fetch_add` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicIsize::fetch_add`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xadd_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 加到当前值，返回前一个值。
    ///
    /// 通过将 [`Ordering::Release`] 作为 `order` 传递，可以通过 `fetch_add` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicIsize::fetch_add`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xadd_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 加到当前值，返回前一个值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 作为 `order` 传递，可以通过 `fetch_add` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicIsize::fetch_add`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xadd_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 加到当前值，返回前一个值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 作为 `order` 传递，可以通过 `fetch_add` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicIsize::fetch_add`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xadd_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 从当前值减去，返回前一个值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 作为 `order` 传递，可以通过 `fetch_sub` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicIsize::fetch_sub`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xsub_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 从当前值减去，返回前一个值。
    ///
    /// 通过将 [`Ordering::Acquire`] 作为 `order` 传递，可以通过 `fetch_sub` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicIsize::fetch_sub`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xsub_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 从当前值减去，返回前一个值。
    ///
    /// 通过将 [`Ordering::Release`] 作为 `order` 传递，可以通过 `fetch_sub` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicIsize::fetch_sub`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xsub_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 从当前值减去，返回前一个值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 作为 `order` 传递，可以通过 `fetch_sub` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicIsize::fetch_sub`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xsub_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 从当前值减去，返回前一个值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 作为 `order` 传递，可以通过 `fetch_sub` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicIsize::fetch_sub`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xsub_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 对当前值按位与，返回前一个值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 作为 `order` 传递，可以通过 `fetch_and` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_and`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_and_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 对当前值按位与，返回前一个值。
    ///
    /// 通过将 [`Ordering::Acquire`] 作为 `order` 传递，可以通过 `fetch_and` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_and`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_and_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 对当前值按位与，返回前一个值。
    ///
    /// 通过将 [`Ordering::Release`] 作为 `order` 传递，可以通过 `fetch_and` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_and`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_and_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 对当前值按位与，返回前一个值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 作为 `order` 传递，可以通过 `fetch_and` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_and`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_and_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 对当前值按位与，返回前一个值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 作为 `order` 传递，可以通过 `fetch_and` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_and`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_and_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 对当前值按位与，返回前一个值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 作为 `order` 传递，可以通过 `fetch_nand` 方法在 [`AtomicBool`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_nand`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_nand_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 对当前值按位与，返回前一个值。
    ///
    /// 通过将 [`Ordering::Acquire`] 作为 `order` 传递，可以通过 `fetch_nand` 方法在 [`AtomicBool`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_nand`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_nand_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 对当前值按位与，返回前一个值。
    ///
    /// 通过将 [`Ordering::Release`] 作为 `order` 传递，可以通过 `fetch_nand` 方法在 [`AtomicBool`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_nand`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_nand_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 对当前值按位与，返回前一个值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 作为 `order` 传递，可以通过 `fetch_nand` 方法在 [`AtomicBool`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_nand`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_nand_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 对当前值按位与，返回前一个值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 作为 `order` 传递，可以通过 `fetch_nand` 方法在 [`AtomicBool`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_nand`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_nand_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 按位或具有当前值，返回前一个值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 作为 `order` 传递，可以通过 `fetch_or` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_or`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_or_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 按位或具有当前值，返回前一个值。
    ///
    /// 通过将 [`Ordering::Acquire`] 作为 `order` 传递，可以通过 `fetch_or` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_or`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_or_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 按位或具有当前值，返回前一个值。
    ///
    /// 通过将 [`Ordering::Release`] 作为 `order` 传递，可以通过 `fetch_or` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_or`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_or_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 按位或具有当前值，返回前一个值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 作为 `order` 传递，可以通过 `fetch_or` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_or`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_or_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 按位或具有当前值，返回前一个值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 作为 `order` 传递，可以通过 `fetch_or` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_or`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_or_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 与当前值按位异或，返回前一个值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 作为 `order` 传递，可以通过 `fetch_xor` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_xor`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xor_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 与当前值按位异或，返回前一个值。
    ///
    /// 通过将 [`Ordering::Acquire`] 作为 `order` 传递，可以通过 `fetch_xor` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_xor`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xor_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 与当前值按位异或，返回前一个值。
    ///
    /// 通过将 [`Ordering::Release`] 作为 `order` 传递，可以通过 `fetch_xor` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_xor`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xor_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 与当前值按位异或，返回前一个值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 作为 `order` 传递，可以通过 `fetch_xor` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_xor`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xor_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 与当前值按位异或，返回前一个值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 作为 `order` 传递，可以通过 `fetch_xor` 方法在 [`atomic`] 类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicBool::fetch_xor`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_xor_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 使用带符号的比较将当前值设为最大值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 传递为 `order`，可以通过 `fetch_max` 方法在 [`atomic`] 有符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicI32::fetch_max`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_max_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用带符号的比较将当前值设为最大值。
    ///
    /// 通过将 [`Ordering::Acquire`] 传递为 `order`，可以通过 `fetch_max` 方法在 [`atomic`] 有符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicI32::fetch_max`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_max_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用带符号的比较将当前值设为最大值。
    ///
    /// 通过将 [`Ordering::Release`] 传递为 `order`，可以通过 `fetch_max` 方法在 [`atomic`] 有符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicI32::fetch_max`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_max_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用带符号的比较将当前值设为最大值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 传递为 `order`，可以通过 `fetch_max` 方法在 [`atomic`] 有符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicI32::fetch_max`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_max_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 当前值的最大值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 传递为 `order`，可以通过 `fetch_max` 方法在 [`atomic`] 有符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicI32::fetch_max`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_max_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 使用带符号的比较将当前值设为最小值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 传递为 `order`，可以通过 `fetch_min` 方法在 [`atomic`] 有符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicI32::fetch_min`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_min_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用带符号的比较将当前值设为最小值。
    ///
    /// 通过将 [`Ordering::Acquire`] 传递为 `order`，可以通过 `fetch_min` 方法在 [`atomic`] 有符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicI32::fetch_min`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_min_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用带符号的比较将当前值设为最小值。
    ///
    /// 通过将 [`Ordering::Release`] 传递为 `order`，可以通过 `fetch_min` 方法在 [`atomic`] 有符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicI32::fetch_min`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_min_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用带符号的比较将当前值设为最小值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 传递为 `order`，可以通过 `fetch_min` 方法在 [`atomic`] 有符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicI32::fetch_min`]。
    ///
    pub fn atomic_min_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用带符号的比较将当前值设为最小值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 传递为 `order`，可以通过 `fetch_min` 方法在 [`atomic`] 有符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicI32::fetch_min`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_min_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 使用无符号比较，使用当前值的最小值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 传递为 `order`，可以通过 `fetch_min` 方法在 [`atomic`] 无符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicU32::fetch_min`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_umin_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用无符号比较，使用当前值的最小值。
    ///
    /// 通过将 [`Ordering::Acquire`] 传递为 `order`，可以通过 `fetch_min` 方法在 [`atomic`] 无符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicU32::fetch_min`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_umin_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用无符号比较，使用当前值的最小值。
    ///
    /// 通过将 [`Ordering::Release`] 传递为 `order`，可以通过 `fetch_min` 方法在 [`atomic`] 无符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicU32::fetch_min`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_umin_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用无符号比较，使用当前值的最小值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 传递为 `order`，可以通过 `fetch_min` 方法在 [`atomic`] 无符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicU32::fetch_min`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_umin_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用无符号比较，使用当前值的最小值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 传递为 `order`，可以通过 `fetch_min` 方法在 [`atomic`] 无符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicU32::fetch_min`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_umin_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 使用无符号比较将当前值设为最大值。
    ///
    /// 通过将 [`Ordering::SeqCst`] 传递为 `order`，可以通过 `fetch_max` 方法在 [`atomic`] 无符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicU32::fetch_max`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_umax_seqcst<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用无符号比较将当前值设为最大值。
    ///
    /// 通过将 [`Ordering::Acquire`] 传递为 `order`，可以通过 `fetch_max` 方法在 [`atomic`] 无符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicU32::fetch_max`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_umax_acquire<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用无符号比较将当前值设为最大值。
    ///
    /// 通过将 [`Ordering::Release`] 传递为 `order`，可以通过 `fetch_max` 方法在 [`atomic`] 无符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicU32::fetch_max`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_umax_release<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用无符号比较将当前值设为最大值。
    ///
    /// 通过将 [`Ordering::AcqRel`] 传递为 `order`，可以通过 `fetch_max` 方法在 [`atomic`] 无符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicU32::fetch_max`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_umax_acqrel<T: Copy>(dst: *mut T, src: T) -> T;
    /// 使用无符号比较将当前值设为最大值。
    ///
    /// 通过将 [`Ordering::Relaxed`] 传递为 `order`，可以通过 `fetch_max` 方法在 [`atomic`] 无符号整数类型上使用此内部函数的稳定版本。
    /// 例如，[`AtomicU32::fetch_max`]。
    ///
    #[rustc_nounwind]
    pub fn atomic_umax_relaxed<T: Copy>(dst: *mut T, src: T) -> T;

    /// 原子栅栏。
    ///
    /// 通过将 [`Ordering::SeqCst`] 传递为 `order`，可以在 [`atomic::fence`] 中获得此内部函数的稳定版本。
    ///
    ///
    #[rustc_nounwind]
    pub fn atomic_fence_seqcst();
    /// 原子栅栏。
    ///
    /// 通过将 [`Ordering::Acquire`] 传递为 `order`，可以在 [`atomic::fence`] 中获得此内部函数的稳定版本。
    ///
    ///
    #[rustc_nounwind]
    pub fn atomic_fence_acquire();
    /// 原子栅栏。
    ///
    /// 通过将 [`Ordering::Release`] 传递为 `order`，可以在 [`atomic::fence`] 中获得此内部函数的稳定版本。
    ///
    ///
    #[rustc_nounwind]
    pub fn atomic_fence_release();
    /// 原子栅栏。
    ///
    /// 通过将 [`Ordering::AcqRel`] 传递为 `order`，可以在 [`atomic::fence`] 中获得此内部函数的稳定版本。
    ///
    ///
    #[rustc_nounwind]
    pub fn atomic_fence_acqrel();

    /// 仅编译器的内存屏障。
    ///
    /// 编译器绝不会在此障碍上对内存访问进行重新排序，但不会为此发出任何指令。
    /// 这适用于可能被抢占的同一线程上的操作，例如与信号处理程序进行交互时。
    ///
    /// 通过将 [`Ordering::SeqCst`] 传递为 `order`，可以在 [`atomic::compiler_fence`] 中获得此内部函数的稳定版本。
    ///
    ///
    ///
    ///
    #[rustc_nounwind]
    pub fn atomic_singlethreadfence_seqcst();
    /// 仅编译器的内存屏障。
    ///
    /// 编译器绝不会在此障碍上对内存访问进行重新排序，但不会为此发出任何指令。
    /// 这适用于可能被抢占的同一线程上的操作，例如与信号处理程序进行交互时。
    ///
    /// 通过将 [`Ordering::Acquire`] 传递为 `order`，可以在 [`atomic::compiler_fence`] 中获得此内部函数的稳定版本。
    ///
    ///
    ///
    ///
    #[rustc_nounwind]
    pub fn atomic_singlethreadfence_acquire();
    /// 仅编译器的内存屏障。
    ///
    /// 编译器绝不会在此障碍上对内存访问进行重新排序，但不会为此发出任何指令。
    /// 这适用于可能被抢占的同一线程上的操作，例如与信号处理程序进行交互时。
    ///
    /// 通过将 [`Ordering::Release`] 传递为 `order`，可以在 [`atomic::compiler_fence`] 中获得此内部函数的稳定版本。
    ///
    ///
    ///
    ///
    #[rustc_nounwind]
    pub fn atomic_singlethreadfence_release();
    /// 仅编译器的内存屏障。
    ///
    /// 编译器绝不会在此障碍上对内存访问进行重新排序，但不会为此发出任何指令。
    /// 这适用于可能被抢占的同一线程上的操作，例如与信号处理程序进行交互时。
    ///
    /// 通过将 [`Ordering::AcqRel`] 传递为 `order`，可以在 [`atomic::compiler_fence`] 中获得此内部函数的稳定版本。
    ///
    ///
    ///
    ///
    #[rustc_nounwind]
    pub fn atomic_singlethreadfence_acqrel();

    /// `prefetch` 内部函数是对代码生成器的提示，如果支持的话，它会插入一个预取指令。否则，它是无操作的。
    /// 预取对程序的行为没有影响，但可以更改其性能特征。
    ///
    /// `locality` 参数必须是一个常量整数，并且是时间局部性说明符，范围从 (0) (无局部性) 到 (3) (在缓存中极其局部化)。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    ///
    ///
    #[rustc_nounwind]
    pub fn prefetch_read_data<T>(data: *const T, locality: i32);
    /// `prefetch` 内部函数是对代码生成器的提示，如果支持的话，它会插入一个预取指令。否则，它是无操作的。
    /// 预取对程序的行为没有影响，但可以更改其性能特征。
    ///
    /// `locality` 参数必须是一个常量整数，并且是时间局部性说明符，范围从 (0) (无局部性) 到 (3) (在缓存中极其局部化)。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    ///
    ///
    #[rustc_nounwind]
    pub fn prefetch_write_data<T>(data: *const T, locality: i32);
    /// `prefetch` 内部函数是对代码生成器的提示，如果支持的话，它会插入一个预取指令。否则，它是无操作的。
    /// 预取对程序的行为没有影响，但可以更改其性能特征。
    ///
    /// `locality` 参数必须是一个常量整数，并且是时间局部性说明符，范围从 (0) (无局部性) 到 (3) (在缓存中极其局部化)。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    ///
    ///
    #[rustc_nounwind]
    pub fn prefetch_read_instruction<T>(data: *const T, locality: i32);
    /// `prefetch` 内部函数是对代码生成器的提示，如果支持的话，它会插入一个预取指令。否则，它是无操作的。
    /// 预取对程序的行为没有影响，但可以更改其性能特征。
    ///
    /// `locality` 参数必须是一个常量整数，并且是时间局部性说明符，范围从 (0) (无局部性) 到 (3) (在缓存中极其局部化)。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    ///
    ///
    #[rustc_nounwind]
    pub fn prefetch_write_instruction<T>(data: *const T, locality: i32);

    /// 从函数附带的属性中获取其含义的 magic 内部函数。
    ///
    /// 例如，数据流使用它来注入静态断言，以便 `rustc_peek(potentially_uninitialized)` 实际上会再次检查数据流确实确实计算出该数据流在控制流中未初始化。
    ///
    ///
    /// 不应在编译器外部使用此内部函数。
    ///
    ///
    ///
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn rustc_peek<T>(_: T) -> T;

    /// 中止进程的执行。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 如果可能，[`std::process::abort`](../../std/process/fn.abort.html) 如果可能的话是首选的，因为它的行为更方便用户，也更稳定。
    ///
    ///
    /// `intrinsics::abort` 的当前实现是在大多数平台上调用无效指令。
    /// 在 Unix 上，进程可能会以 `SIGABRT`、`SIGILL`、`SIGTRAP`、`SIGSEGV` 或 `SIGBUS` 之类的信号终止。
    /// 不能保证精确的行为并且不稳定。
    ///
    ///
    ///
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn abort() -> !;

    /// 通知优化器代码中的这一点不可访问，从而可以进行进一步的优化。
    ///
    /// 注意，这与 `unreachable!()` 宏非常不同：与执行 panics 的宏不同，到达带有此函数标记的代码是 *undefined 行为*。
    ///
    ///
    /// 这个 intrinsic 的稳定版本是 [`core::hint::unreachable_unchecked`]。
    ///
    ///
    #[rustc_const_stable(feature = "const_unreachable_unchecked", since = "1.57.0")]
    #[rustc_nounwind]
    pub fn unreachable() -> !;

    /// 通知优化器某个条件始终为 true。
    /// 如果条件为 false，则行为未定义的。
    ///
    /// 没有为该内部函数生成任何代码，但是优化器将尝试在通过之间保留它 (及其条件)，这可能会干扰周围代码的优化并降低性能。
    /// 如果优化器可以自己发现不变量，或者它没有启用任何重要的优化，则不应使用它。
    ///
    /// 此内部函数没有稳定的对应对象。
    ///
    ///
    ///
    #[rustc_const_unstable(feature = "const_assume", issue = "76972")]
    #[rustc_nounwind]
    pub fn assume(b: bool);

    /// 提示编译器分支条件很可能是正确的。
    /// 返回传递给它的值。
    ///
    /// 除与 `if` 语句一起使用外，其他任何使用都可能无效。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_const_unstable(feature = "const_likely", issue = "none")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn likely(b: bool) -> bool;

    /// 提示编译器分支条件可能为 false。
    /// 返回传递给它的值。
    ///
    /// 除与 `if` 语句一起使用外，其他任何使用都可能无效。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_const_unstable(feature = "const_likely", issue = "none")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn unlikely(b: bool) -> bool;

    /// 执行一个断点陷阱，以供调试器检查。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn breakpoint();

    /// 类型的大小 (以字节为单位)。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 更具体地说，这是相同类型的连续项之间的字节偏移量，包括对齐填充。
    ///
    ///
    /// 这个 intrinsic 的稳定版本是 [`core::mem::size_of`]。
    ///
    #[rustc_const_stable(feature = "const_size_of", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn size_of<T>() -> usize;

    /// 类型的最小对齐方式。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 这个 intrinsic 的稳定版本是 [`core::mem::align_of`]。
    #[rustc_const_stable(feature = "const_min_align_of", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn min_align_of<T>() -> usize;
    /// 类型的首选对齐方式。
    ///
    /// 此内部函数没有稳定的对应对象。
    /// 它的跟踪问题是 [#91971](https://github.com/rust-lang/rust/issues/91971)。
    #[rustc_const_unstable(feature = "const_pref_align_of", issue = "91971")]
    #[rustc_nounwind]
    pub fn pref_align_of<T>() -> usize;

    /// 引用值的大小 (以字节为单位)。
    ///
    /// 此内部函数的稳定版本为 [`mem::size_of_val`]。
    #[rustc_const_unstable(feature = "const_size_of_val", issue = "46571")]
    #[rustc_nounwind]
    pub fn size_of_val<T: ?Sized>(_: *const T) -> usize;
    /// 参考值的所需对齐方式。
    ///
    /// 这个 intrinsic 的稳定版本是 [`core::mem::align_of_val`]。
    #[rustc_const_unstable(feature = "const_align_of_val", issue = "46571")]
    #[rustc_nounwind]
    pub fn min_align_of_val<T: ?Sized>(_: *const T) -> usize;

    /// 获取包含类型名称的静态字符串切片。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 这个 intrinsic 的稳定版本是 [`core::any::type_name`]。
    #[rustc_const_unstable(feature = "const_type_name", issue = "63084")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn type_name<T: ?Sized>() -> &'static str;

    /// 获取一个标识符，该标识符对于指定的类型是全局唯一的。
    /// 无论调用哪个 crate，此函数都将为类型返回相同的值。
    ///
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 这个 intrinsic 的稳定版本是 [`core::any::TypeId::of`]。
    ///
    #[rustc_const_unstable(feature = "const_type_id", issue = "77125")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn type_id<T: ?Sized + 'static>() -> u64;

    /// 如果 `T` 未定义，则无法执行的不安全函数的守卫：
    /// 这将静态地为 panic，或者什么也不做。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_const_stable(feature = "const_assert_type", since = "1.59.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn assert_inhabited<T>();

    /// 如果 `T` 不允许零初始化，则永远不能执行的不安全函数的守卫：这将静态 panic，或者什么也不做。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_const_unstable(feature = "const_assert_type2", issue = "none")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn assert_zero_valid<T>();

    /// `std::mem::uninitialized` 的守卫。这将静态地为 panic，或者什么也不做。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_const_unstable(feature = "const_assert_type2", issue = "none")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn assert_mem_uninitialized_valid<T>();

    /// 获取对静态 `Location` 的引用，以指示在何处调用了它。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 可以考虑使用 [`core::panic::Location::caller`]。
    #[rustc_const_unstable(feature = "const_caller_location", issue = "76156")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn caller_location() -> &'static crate::panic::Location<'static>;

    /// 将值移出作用域。而无需运行丢弃守卫。
    ///
    /// 这仅适用于 [`mem::forget_unsized`]。正常情况下，请改用 `forget` 为 `ManuallyDrop`。
    ///
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    #[rustc_const_unstable(feature = "const_intrinsic_forget", issue = "none")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn forget<T: ?Sized>(_: T);

    /// 将一种类型的值的位重新解释为另一种类型。
    ///
    /// 两种类型都必须具有相同的大小。如果不能保证，编译将失败。
    ///
    /// `transmute` 在语义上等同于将一种类型按位移动到另一种类型。它将位从源值复制到目标值，然后忘记原始值。
    /// 请注意，源和目标是按值传递的，这意味着如果 `Src` 或 `Dst` 包含填充，则*不*保证 `transmute` 保留该填充。
    ///
    /// 参数和结果都必须是给定类型的 [valid](../../nomicon/what-unsafe-does.html)。违反此条件会导致 [未定义的行为][ub]。
    /// 编译器将生成代码 *assuming，您 (程序员) 确保永远不会出现未定义的行为 *。
    /// 因此，您有责任保证传递给 `transmute` 的每个值在 `Src` 和 `Dst` 类型中都有效。
    /// 不遵守此条件可能会导致意外和不稳定的编译结果。
    /// 这使得 `transmute` **非常不安全**。
    /// `transmute` 应该是绝对不得已的方法。
    ///
    /// 在 `const` 上下文中转换指向整数的指针是 [未定义的行为][ub]。
    /// 任何将结果值用于整数运算的尝试都将中止常量计算。
    /// (即使在 `const` 之外，这种转换也涉及到 Rust 内存模型的许多未指定方面，应该避免。请参见下面的替代方案。)
    ///
    /// 由于 `transmute` 是按值运算，因此不必担心 *transmuted values 本身的对齐*。
    /// 与任何其他函数一样，编译器已经确保 `Src` 和 `Dst` 正确对齐。
    /// 但是，当将 *point 的值转换为其他位置*(例如指针，引用，boxes…) 时，调用者必须确保所指向的值正确对齐。
    ///
    /// [nomicon](../../nomicon/transmutes.html) 具有其他文档。
    ///
    /// [ub]: ../../reference/behavior-considered-undefined.html
    ///
    /// # Examples
    ///
    /// `transmute` 确实有一些用途。
    ///
    /// 将指针转换为函数指针。对于函数指针和数据指针具有不同大小的机器，这不是可移植的。
    ///
    /// ```
    /// fn foo() -> i32 {
    ///     0
    /// }
    /// // 至关重要的是，我们在转换为函数指针之前 `as`-cast 为一个裸指针。
    /// // 这避免了整数到指针 `transmute`，这可能是有问题的。
    /// // 在裸指针 (即两个指针类型) 之间转换是可以的。
    /// let pointer = foo as *const ();
    /// let function = unsafe {
    ///     std::mem::transmute::<*const (), fn() -> i32>(pointer)
    /// };
    /// assert_eq!(function(), 0);
    /// ```
    ///
    /// 延长生命周期或缩短不变的生命周期。这是高级的，非常不安全的 Rust!
    ///
    /// ```
    /// struct R<'a>(&'a i32);
    /// unsafe fn extend_lifetime<'b>(r: R<'b>) -> R<'static> {
    ///     std::mem::transmute::<R<'b>, R<'static>>(r)
    /// }
    ///
    /// unsafe fn shorten_invariant_lifetime<'b, 'c>(r: &'b mut R<'static>)
    ///                                              -> &'b mut R<'c> {
    ///     std::mem::transmute::<&'b mut R<'static>, &'b mut R<'c>>(r)
    /// }
    /// ```
    ///
    /// # Alternatives
    ///
    /// 不要失望: `transmute` 的许多用途可以通过其他方式实现。
    /// 以下是 `transmute` 的常见应用程序，可以用更安全的结构替换它。
    ///
    /// 将原始字节 (`[u8; SZ]`) 转换为 `u32`、`f64` 等:
    ///
    /// ```
    /// let raw_bytes = [0x78, 0x56, 0x34, 0x12];
    ///
    /// let num = unsafe {
    ///     std::mem::transmute::<[u8; 4], u32>(raw_bytes)
    /// };
    ///
    /// // 请改用 `u32::from_ne_bytes`
    /// let num = u32::from_ne_bytes(raw_bytes);
    /// // 或使用 `u32::from_le_bytes` 或 `u32::from_be_bytes` 指定字节顺序
    /// let num = u32::from_le_bytes(raw_bytes);
    /// assert_eq!(num, 0x12345678);
    /// let num = u32::from_be_bytes(raw_bytes);
    /// assert_eq!(num, 0x78563412);
    /// ```
    ///
    /// 将指针变成 `usize`：
    ///
    /// ```no_run
    /// let ptr = &0;
    /// let ptr_num_transmute = unsafe {
    ///     std::mem::transmute::<&i32, usize>(ptr)
    /// };
    ///
    /// // 请改用 `as` cast
    /// let ptr_num_cast = ptr as *const i32 as usize;
    /// ```
    ///
    /// 请注意，使用 `transmute` 将指针转换为 `usize` 是（如上所述）在 `const` 上下文中的 [未定义行为][ub]。
    /// 同样在 consts 之外，这个操作可能不会像预期的那样运行 -- 这涉及 Rust 内存模型的许多未指定方面。
    /// 根据代码的作用，以下替代方法比指针到整数的转换更可取:
    /// - 如果代码只是想在某个缓冲区中存储任意类型的数据并且需要为该缓冲区选择一种类型，则可以使用 [`MaybeUninit`][mem::MaybeUninit]。
    /// - 如果代码确实想处理指针指向的地址，它可以使用 `as` 强制转换或 [`ptr.addr()`][pointer::addr]。
    ///
    /// 将 `*mut T` 变成 `&mut T`：
    ///
    /// ```
    /// let ptr: *mut i32 = &mut 0;
    /// let ref_transmuted = unsafe {
    ///     std::mem::transmute::<*mut i32, &mut i32>(ptr)
    /// };
    ///
    /// // 请改用 reborrow
    /// let ref_casted = unsafe { &mut *ptr };
    /// ```
    ///
    /// 将 `&mut T` 变成 `&mut U`：
    ///
    /// ```
    /// let ptr = &mut 0;
    /// let val_transmuted = unsafe {
    ///     std::mem::transmute::<&mut i32, &mut u32>(ptr)
    /// };
    ///
    /// // 现在，将 `as` 和 reborrowing 放在一起 - 请注意，`as` `as` 的链接是不可传递的
    /////
    /// let val_casts = unsafe { &mut *(ptr as *mut i32 as *mut u32) };
    /// ```
    ///
    /// 将 `&str` 变成 `&[u8]`：
    ///
    /// ```
    /// // 这不是执行此操作的好方法。
    /// let slice = unsafe { std::mem::transmute::<&str, &[u8]>("Rust") };
    /// assert_eq!(slice, &[82, 117, 115, 116]);
    ///
    /// // 您可以使用 `str::as_bytes`
    /// let slice = "Rust".as_bytes();
    /// assert_eq!(slice, &[82, 117, 115, 116]);
    ///
    /// // 或者，如果您可以控制字符串，则只需使用字节字符串即可。
    /////
    /// assert_eq!(b"Rust", &[82, 117, 115, 116]);
    /// ```
    ///
    /// 将 `Vec<&T>` 变成 `Vec<Option<&T>>`。
    ///
    /// 要转换容器内容的内部类型，必须确保不违反容器的任何不变量。
    /// 对于 `Vec`，这意味着内部类型的大小和对齐方式都必须匹配。
    /// 其他容器可能依赖于类型，对齐方式甚至 `TypeId` 的大小，在这种情况下，在不违反容器不变量的情况下根本不可能进行转换。
    ///
    ///
    /// ```
    /// let store = [0, 1, 2, 3];
    /// let v_orig = store.iter().collect::<Vec<&i32>>();
    ///
    /// // 克隆 vector，因为稍后我们将重用它们
    /// let v_clone = v_orig.clone();
    ///
    /// // 使用 transmute: 这依赖于 `Vec` 的未指定数据布局，这是一个坏主意，并可能导致未定义的行为。
    /////
    /// // 但是，它不是 copy 的。
    /// let v_transmuted = unsafe {
    ///     std::mem::transmute::<Vec<&i32>, Vec<Option<&i32>>>(v_clone)
    /// };
    ///
    /// let v_clone = v_orig.clone();
    ///
    /// // 这是建议的安全方法。
    /// // 但是，它确实将整个 vector 复制到一个新数组中。
    /// let v_collected = v_clone.into_iter()
    ///                          .map(Some)
    ///                          .collect::<Vec<Option<&i32>>>();
    ///
    /// let v_clone = v_orig.clone();
    ///
    /// // 这是 "transmuting" 和 `Vec` 的正确无复制，不安全的方式，而无需依赖数据布局。
    /// // 我们不执行字面上的调用 `transmute`，而是执行指针强制转换，但是就将原始内部类型 (`&i32`) 转换为新的 (`Option<&i32>`) 而言，这具有所有相同的警告。
    /////
    /// // 除了上面提供的信息之外，还请查阅 [`from_raw_parts`] 文档。
    /////
    /// let v_from_raw = unsafe {
    // FIXME 在 vec_into_raw_parts 稳定后更新它
    ///     // 确保原始 vector 没有被丢弃。
    ///     let mut v_clone = std::mem::ManuallyDrop::new(v_clone);
    ///     Vec::from_raw_parts(v_clone.as_mut_ptr() as *mut Option<&i32>,
    ///                         v_clone.len(),
    ///                         v_clone.capacity())
    /// };
    /// ```
    ///
    /// [`from_raw_parts`]: ../../std/vec/struct.Vec.html#method.from_raw_parts
    ///
    /// 实现 `split_at_mut`：
    ///
    /// ```
    /// use std::{slice, mem};
    ///
    /// // 有多种方法可以执行此操作，并且以下 (transmute) 方法存在多个问题。
    /////
    /// fn split_at_mut_transmute<T>(slice: &mut [T], mid: usize)
    ///                              -> (&mut [T], &mut [T]) {
    ///     let len = slice.len();
    ///     assert!(mid <= len);
    ///     unsafe {
    ///         let slice2 = mem::transmute::<&mut [T], &mut [T]>(slice);
    ///         // 第一：transmute 不是类型安全的； 它只检查 T 和 U 的大小是否相同。
    ///         // 其次，在这里，您有两个指向同一内存的可变引用。
    /////
    ///         (&mut slice[0..mid], &mut slice2[mid..len])
    ///     }
    /// }
    ///
    /// // 这消除了类型安全问题； `&mut *`* 仅 *将为您提供 `&mut T` 或 `*mut T` 的 `&mut T`。
    /////
    /// fn split_at_mut_casts<T>(slice: &mut [T], mid: usize)
    ///                          -> (&mut [T], &mut [T]) {
    ///     let len = slice.len();
    ///     assert!(mid <= len);
    ///     unsafe {
    ///         let slice2 = &mut *(slice as *mut [T]);
    ///         // 但是，您仍然有两个指向同一内存的可变引用。
    /////
    ///         (&mut slice[0..mid], &mut slice2[mid..len])
    ///     }
    /// }
    ///
    /// // 这就是标准库的工作方式。
    /// // 如果您需要执行以下操作，这是最好的方法
    /// fn split_at_stdlib<T>(slice: &mut [T], mid: usize)
    ///                       -> (&mut [T], &mut [T]) {
    ///     let len = slice.len();
    ///     assert!(mid <= len);
    ///     unsafe {
    ///         let ptr = slice.as_mut_ptr();
    ///         // 现在，它具有三个指向同一内存的可变引用。`slice`，右值 ret.0 和右值 ret.1。
    ///         // `slice` 在 `let ptr = ...` 之后就不再使用了，所以可以把它当作 "dead" 来对待，所以，您只有两个真正的可变切片。
    /////
    /////
    /////
    ///         (slice::from_raw_parts_mut(ptr, mid),
    ///          slice::from_raw_parts_mut(ptr.add(mid), len - mid))
    ///     }
    /// }
    /// ```
    ///
    ///
    ///
    ///
    ///
    ///
    ///
    ///
    ///
    ///
    ///
    ///
    ///
    ///
    ///
    #[stable(feature = "rust1", since = "1.0.0")]
    #[rustc_allowed_through_unstable_modules]
    #[rustc_const_stable(feature = "const_transmute", since = "1.56.0")]
    #[rustc_diagnostic_item = "transmute"]
    #[rustc_nounwind]
    pub fn transmute<Src, Dst>(src: Src) -> Dst;

    /// 与 [`transmute`] 类似，但在编译时检查得更少: 它不会为 `size_of::<Src>() != size_of::<Dst>()` 报错，而是在运行时出现 **Undefined Behaviour**。
    ///
    ///
    /// 尽可能使用普通的 `transmute` 进行额外的检查，因为如果它们都编译的话，它们在运行时做的事情完全相同。
    ///
    /// 预计这不会直接暴露给用户，而是最终可能会通过一些更受限制的 API 暴露。
    ///
    ///
    ///
    #[cfg(not(bootstrap))]
    #[rustc_const_stable(feature = "const_transmute", since = "1.56.0")]
    #[rustc_nounwind]
    pub fn transmute_unchecked<Src, Dst>(src: Src) -> Dst;

    /// 如果 `T` 给出的实际类型需要丢弃 glue，则返回 `true`。如果为 `T` 提供的实际类型实现 `Copy`，则返回 `false`。
    ///
    ///
    /// 如果实际类型既不需要丢弃 glue 也不需要实现 `Copy`，则该函数的返回值不确定。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 此内部函数的稳定版本为 [`mem::needs_drop`](crate::mem::needs_drop)。
    ///
    ///
    ///
    #[rustc_const_stable(feature = "const_needs_drop", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn needs_drop<T: ?Sized>() -> bool;

    /// 计算与指针的偏移量。
    ///
    /// 这被实现为内部函数，以避免与整数进行转换，因为转换会丢弃别名信息。
    ///
    /// 这只能与 `Ptr` 一起使用作为裸指针类型 (`*mut` 或 `*const`) 到 `Sized` 指针和与 `Delta` 一起使用作为 `usize` 或 `isize`。
    /// 任何其他实例化都可能任意行为不当，这*不是*编译器错误。
    ///
    /// # Safety
    ///
    /// 起始指针和结果指针都必须在已分配对象末尾的范围之内或一个字节内。
    /// 如果指针越界或发生算术溢出，则进一步使用返回值将导致不确定的行为。
    ///
    ///
    /// 此内部函数的稳定版本为 [`pointer::offset`]。
    ///
    ///
    ///
    #[cfg(not(bootstrap))]
    #[must_use = "returns a new pointer rather than modifying its argument"]
    #[rustc_const_stable(feature = "const_ptr_offset", since = "1.61.0")]
    #[rustc_nounwind]
    pub fn offset<Ptr, Delta>(dst: Ptr, offset: Delta) -> Ptr;

    /// 这个的引导程序版本受到更多限制。
    #[cfg(bootstrap)]
    #[must_use = "returns a new pointer rather than modifying its argument"]
    #[rustc_const_stable(feature = "const_ptr_offset", since = "1.61.0")]
    #[rustc_nounwind]
    pub fn offset<T>(dst: *const T, offset: isize) -> *const T;

    /// 计算与指针的偏移量 (可能会自动换行)。
    ///
    /// 这被实现为内部函数，以避免与整数进行相互转换，因为该转换会禁止某些优化。
    ///
    /// # Safety
    ///
    /// 与 `offset` 内部函数不同，此内部函数不会限制结果指针指向已分配对象的末尾或指向该对象末尾一个字节，并且使用二进制补码算法进行换行。
    /// 结果值不一定有效地用于实际访问内存。
    ///
    /// 此内部函数的稳定版本为 [`pointer::wrapping_offset`]。
    ///
    ///
    ///
    #[must_use = "returns a new pointer rather than modifying its argument"]
    #[rustc_const_stable(feature = "const_ptr_offset", since = "1.61.0")]
    #[rustc_nounwind]
    pub fn arith_offset<T>(dst: *const T, offset: isize) -> *const T;

    /// 根据掩码屏蔽指针的位。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 考虑改用 [`pointer::mask`]。
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn ptr_mask<T>(ptr: *const T, mask: usize) -> *const T;

    /// 相当于适当的 `llvm.memcpy.p0i8.0i8.*` 内部函数，大小为 `count` * `size_of::<T>()`，对齐方式为 `min_align_of::<T>()`
    ///
    ///
    /// volatile 参数设置为 `true`，因此除非大小等于零，否则不会对其进行优化。
    ///
    /// 此内部函数没有稳定的对应对象。
    ///
    ///
    #[rustc_nounwind]
    pub fn volatile_copy_nonoverlapping_memory<T>(dst: *mut T, src: *const T, count: usize);
    /// 相当于适当的 `llvm.memmove.p0i8.0i8.*` 内部函数，大小为 `count * size_of::<T>()`，对齐方式为 `min_align_of::<T>()`
    ///
    ///
    /// volatile 参数设置为 `true`，因此除非大小等于零，否则不会对其进行优化。
    ///
    /// 此内部函数没有稳定的对应对象。
    ///
    ///
    #[rustc_nounwind]
    pub fn volatile_copy_memory<T>(dst: *mut T, src: *const T, count: usize);
    /// 等效于适当的 `llvm.memset.p0i8.*` 内部函数，其大小为 `count* size_of::<T>()`，并且对齐方式为 `min_align_of::<T>()`。
    ///
    ///
    /// volatile 参数设置为 `true`，因此除非大小等于零，否则不会对其进行优化。
    ///
    /// 此内部函数没有稳定的对应对象。
    ///
    ///
    #[rustc_nounwind]
    pub fn volatile_set_memory<T>(dst: *mut T, val: u8, count: usize);

    /// 从 `src` 指针执行易失性加载。
    ///
    /// 这个 intrinsic 的稳定版本是 [`core::ptr::read_volatile`]。
    #[rustc_nounwind]
    pub fn volatile_load<T>(src: *const T) -> T;
    /// 对 `dst` 指针执行易失性存储。
    ///
    /// 这个 intrinsic 的稳定版本是 [`core::ptr::write_volatile`]。
    #[rustc_nounwind]
    pub fn volatile_store<T>(dst: *mut T, val: T);

    /// 从 `src` 指针执行易失性加载不需要将指针对齐。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn unaligned_volatile_load<T>(src: *const T) -> T;
    /// 对 `dst` 指针执行易失性存储。
    /// 指针不需要对齐。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn unaligned_volatile_store<T>(dst: *mut T, val: T);

    /// 返回 `f32` 的平方根
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::sqrt`](../../std/primitive.f32.html#method.sqrt)
    #[rustc_nounwind]
    pub fn sqrtf32(x: f32) -> f32;
    /// 返回 `f64` 的平方根
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::sqrt`](../../std/primitive.f64.html#method.sqrt)
    #[rustc_nounwind]
    pub fn sqrtf64(x: f64) -> f64;

    /// 将 `f32` 提升为整数幂。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::powi`](../../std/primitive.f32.html#method.powi)
    #[rustc_nounwind]
    pub fn powif32(a: f32, x: i32) -> f32;
    /// 将 `f64` 提升为整数幂。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::powi`](../../std/primitive.f64.html#method.powi)
    #[rustc_nounwind]
    pub fn powif64(a: f64, x: i32) -> f64;

    /// 返回 `f32` 的正弦值。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::sin`](../../std/primitive.f32.html#method.sin)
    #[rustc_nounwind]
    pub fn sinf32(x: f32) -> f32;
    /// 返回 `f64` 的正弦值。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::sin`](../../std/primitive.f64.html#method.sin)
    #[rustc_nounwind]
    pub fn sinf64(x: f64) -> f64;

    /// 返回 `f32` 的余弦值。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::cos`](../../std/primitive.f32.html#method.cos)
    #[rustc_nounwind]
    pub fn cosf32(x: f32) -> f32;
    /// 返回 `f64` 的余弦值。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::cos`](../../std/primitive.f64.html#method.cos)
    #[rustc_nounwind]
    pub fn cosf64(x: f64) -> f64;

    /// 将 `f32` 提升到 `f32` 的幂。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::powf`](../../std/primitive.f32.html#method.powf)
    #[rustc_nounwind]
    pub fn powf32(a: f32, x: f32) -> f32;
    /// 将 `f64` 提升到 `f64` 的幂。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::powf`](../../std/primitive.f64.html#method.powf)
    #[rustc_nounwind]
    pub fn powf64(a: f64, x: f64) -> f64;

    /// 返回 `f32` 的指数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::exp`](../../std/primitive.f32.html#method.exp)
    #[rustc_nounwind]
    pub fn expf32(x: f32) -> f32;
    /// 返回 `f64` 的指数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::exp`](../../std/primitive.f64.html#method.exp)
    #[rustc_nounwind]
    pub fn expf64(x: f64) -> f64;

    /// 返回 2 乘以 `f32` 的幂。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::exp2`](../../std/primitive.f32.html#method.exp2)
    #[rustc_nounwind]
    pub fn exp2f32(x: f32) -> f32;
    /// 返回 2 乘以 `f64` 的幂。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::exp2`](../../std/primitive.f64.html#method.exp2)
    #[rustc_nounwind]
    pub fn exp2f64(x: f64) -> f64;

    /// 返回 `f32` 的自然对数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::ln`](../../std/primitive.f32.html#method.ln)
    #[rustc_nounwind]
    pub fn logf32(x: f32) -> f32;
    /// 返回 `f64` 的自然对数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::ln`](../../std/primitive.f64.html#method.ln)
    #[rustc_nounwind]
    pub fn logf64(x: f64) -> f64;

    /// 返回 `f32` 的以 10 为底的对数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::log10`](../../std/primitive.f32.html#method.log10)
    #[rustc_nounwind]
    pub fn log10f32(x: f32) -> f32;
    /// 返回 `f64` 的以 10 为底的对数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::log10`](../../std/primitive.f64.html#method.log10)
    #[rustc_nounwind]
    pub fn log10f64(x: f64) -> f64;

    /// 返回 `f32` 的以 2 为底的对数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::log2`](../../std/primitive.f32.html#method.log2)
    #[rustc_nounwind]
    pub fn log2f32(x: f32) -> f32;
    /// 返回 `f64` 的以 2 为底的对数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::log2`](../../std/primitive.f64.html#method.log2)
    #[rustc_nounwind]
    pub fn log2f64(x: f64) -> f64;

    /// 为 `f32` 值返回 `a * b + c`。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::mul_add`](../../std/primitive.f32.html#method.mul_add)
    #[rustc_nounwind]
    pub fn fmaf32(a: f32, b: f32, c: f32) -> f32;
    /// 为 `f64` 值返回 `a * b + c`。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::mul_add`](../../std/primitive.f64.html#method.mul_add)
    #[rustc_nounwind]
    pub fn fmaf64(a: f64, b: f64, c: f64) -> f64;

    /// 返回 `f32` 的绝对值。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::abs`](../../std/primitive.f32.html#method.abs)
    #[rustc_nounwind]
    pub fn fabsf32(x: f32) -> f32;
    /// 返回 `f64` 的绝对值。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::abs`](../../std/primitive.f64.html#method.abs)
    #[rustc_nounwind]
    pub fn fabsf64(x: f64) -> f64;

    /// 返回两个 `f32` 值中的最小值。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::min`]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn minnumf32(x: f32, y: f32) -> f32;
    /// 返回两个 `f64` 值中的最小值。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::min`]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn minnumf64(x: f64, y: f64) -> f64;
    /// 返回两个 `f32` 值的最大值。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::max`]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn maxnumf32(x: f32, y: f32) -> f32;
    /// 返回两个 `f64` 值的最大值。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::max`]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn maxnumf64(x: f64, y: f64) -> f64;

    /// 将 `f32` 值的符号从 `y` 复制到 `x`。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::copysign`](../../std/primitive.f32.html#method.copysign)
    #[rustc_nounwind]
    pub fn copysignf32(x: f32, y: f32) -> f32;
    /// 将 `f64` 值的符号从 `y` 复制到 `x`。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::copysign`](../../std/primitive.f64.html#method.copysign)
    #[rustc_nounwind]
    pub fn copysignf64(x: f64, y: f64) -> f64;

    /// 返回小于或等于 `f32` 的最大整数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::floor`](../../std/primitive.f32.html#method.floor)
    #[rustc_nounwind]
    pub fn floorf32(x: f32) -> f32;
    /// 返回小于或等于 `f64` 的最大整数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::floor`](../../std/primitive.f64.html#method.floor)
    #[rustc_nounwind]
    pub fn floorf64(x: f64) -> f64;

    /// 返回大于或等于 `f32` 的最小整数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::ceil`](../../std/primitive.f32.html#method.ceil)
    #[rustc_nounwind]
    pub fn ceilf32(x: f32) -> f32;
    /// 返回大于或等于 `f64` 的最小整数。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::ceil`](../../std/primitive.f64.html#method.ceil)
    #[rustc_nounwind]
    pub fn ceilf64(x: f64) -> f64;

    /// 返回 `f32` 的整数部分。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::trunc`](../../std/primitive.f32.html#method.trunc)
    #[rustc_nounwind]
    pub fn truncf32(x: f32) -> f32;
    /// 返回 `f64` 的整数部分。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::trunc`](../../std/primitive.f64.html#method.trunc)
    #[rustc_nounwind]
    pub fn truncf64(x: f64) -> f64;

    /// 返回最接近 `f32` 的整数。
    /// 如果参数不是整数，则可能会引发不精确的浮点异常。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::round_ties_even`](../../std/primitive.f32.html#method.round_ties_even)
    #[rustc_nounwind]
    pub fn rintf32(x: f32) -> f32;
    /// 返回最接近 `f64` 的整数。
    /// 如果参数不是整数，则可能会引发不精确的浮点异常。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::round_ties_even`](../../std/primitive.f64.html#method.round_ties_even)
    #[rustc_nounwind]
    pub fn rintf64(x: f64) -> f64;

    /// 返回最接近 `f32` 的整数。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn nearbyintf32(x: f32) -> f32;
    /// 返回最接近 `f64` 的整数。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn nearbyintf64(x: f64) -> f64;

    /// 返回最接近 `f32` 的整数。在离零一半的情况下进行舍入。
    ///
    /// 此内部函数的稳定版本是
    /// [`f32::round`](../../std/primitive.f32.html#method.round)
    #[rustc_nounwind]
    pub fn roundf32(x: f32) -> f32;
    /// 返回最接近 `f64` 的整数。在离零一半的情况下进行舍入。
    ///
    /// 此内部函数的稳定版本是
    /// [`f64::round`](../../std/primitive.f64.html#method.round)
    #[rustc_nounwind]
    pub fn roundf64(x: f64) -> f64;

    /// 返回最接近 `f32` 的整数。
    /// 将中途个案四舍五入到具有最低有效数字的数字。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn roundevenf32(x: f32) -> f32;
    /// 返回最接近 `f64` 的整数。
    /// 将中途个案四舍五入到具有最低有效数字的数字。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn roundevenf64(x: f64) -> f64;

    /// 浮点数加法允许基于代数规则进行优化。
    /// 可以假设输入是有限的。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn fadd_fast<T: Copy>(a: T, b: T) -> T;

    /// 浮点减法允许基于代数规则进行优化。
    /// 可以假设输入是有限的。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn fsub_fast<T: Copy>(a: T, b: T) -> T;

    /// 浮点乘法允许基于代数规则进行优化。
    /// 可以假设输入是有限的。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn fmul_fast<T: Copy>(a: T, b: T) -> T;

    /// 浮点除法允许基于代数规则进行优化。
    /// 可以假设输入是有限的。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn fdiv_fast<T: Copy>(a: T, b: T) -> T;

    /// 浮余数允许基于代数规则进行优化。
    /// 可以假设输入是有限的。
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_nounwind]
    pub fn frem_fast<T: Copy>(a: T, b: T) -> T;

    /// 使用 LLVM 的 fptoui/fptosi 进行转换，对于越界的值可能会返回 undef
    /// (<https://github.com/rust-lang/rust/issues/10184>)
    ///
    /// 稳定为 [`f32::to_int_unchecked`] 和 [`f64::to_int_unchecked`]。
    #[rustc_nounwind]
    pub fn float_to_int_unchecked<Float: Copy, Int: Copy>(value: Float) -> Int;

    /// 返回整数类型 `T` 中设置的位数
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `count_ones` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::count_ones`]
    #[rustc_const_stable(feature = "const_ctpop", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn ctpop<T: Copy>(x: T) -> T;

    /// 返回整数类型 `T` 的前导未设置位 (zeroes) 的数量。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `leading_zeros` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::leading_zeros`]
    ///
    /// # Examples
    ///
    /// ```
    /// #![feature(core_intrinsics)]
    ///
    /// use std::intrinsics::ctlz;
    ///
    /// let x = 0b0001_1100_u8;
    /// let num_leading = ctlz(x);
    /// assert_eq!(num_leading, 3);
    /// ```
    ///
    /// 值为 `0` 的 `x` 将返回 `T` 的位宽。
    ///
    /// ```
    /// #![feature(core_intrinsics)]
    ///
    /// use std::intrinsics::ctlz;
    ///
    /// let x = 0u16;
    /// let num_leading = ctlz(x);
    /// assert_eq!(num_leading, 16);
    /// ```
    #[rustc_const_stable(feature = "const_ctlz", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn ctlz<T: Copy>(x: T) -> T;

    /// 类似于 `ctlz`，但是非常不安全，因为当给定值 `0` 的 `x` 时，它返回 `undef`。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    ///
    /// # Examples
    ///
    /// ```
    /// #![feature(core_intrinsics)]
    ///
    /// use std::intrinsics::ctlz_nonzero;
    ///
    /// let x = 0b0001_1100_u8;
    /// let num_leading = unsafe { ctlz_nonzero(x) };
    /// assert_eq!(num_leading, 3);
    /// ```
    #[rustc_const_stable(feature = "constctlz", since = "1.50.0")]
    #[rustc_nounwind]
    pub fn ctlz_nonzero<T: Copy>(x: T) -> T;

    /// 返回整数类型 `T` 的尾随未设置位 (zeroes) 的数量。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `trailing_zeros` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::trailing_zeros`]
    ///
    /// # Examples
    ///
    /// ```
    /// #![feature(core_intrinsics)]
    ///
    /// use std::intrinsics::cttz;
    ///
    /// let x = 0b0011_1000_u8;
    /// let num_trailing = cttz(x);
    /// assert_eq!(num_trailing, 3);
    /// ```
    ///
    /// 值为 `0` 的 `x` 将返回 `T` 的位宽：
    ///
    /// ```
    /// #![feature(core_intrinsics)]
    ///
    /// use std::intrinsics::cttz;
    ///
    /// let x = 0u16;
    /// let num_trailing = cttz(x);
    /// assert_eq!(num_trailing, 16);
    /// ```
    #[rustc_const_stable(feature = "const_cttz", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn cttz<T: Copy>(x: T) -> T;

    /// 类似于 `cttz`，但是非常不安全，因为当给定值 `0` 的 `x` 时，它返回 `undef`。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    ///
    /// # Examples
    ///
    /// ```
    /// #![feature(core_intrinsics)]
    ///
    /// use std::intrinsics::cttz_nonzero;
    ///
    /// let x = 0b0011_1000_u8;
    /// let num_trailing = unsafe { cttz_nonzero(x) };
    /// assert_eq!(num_trailing, 3);
    /// ```
    #[rustc_const_stable(feature = "const_cttz_nonzero", since = "1.53.0")]
    #[rustc_nounwind]
    pub fn cttz_nonzero<T: Copy>(x: T) -> T;

    /// 反转整数类型 `T` 中的字节。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `swap_bytes` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::swap_bytes`]
    #[rustc_const_stable(feature = "const_bswap", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn bswap<T: Copy>(x: T) -> T;

    /// 反转整数类型 `T` 中的位。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `reverse_bits` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::reverse_bits`]
    #[rustc_const_stable(feature = "const_bitreverse", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn bitreverse<T: Copy>(x: T) -> T;

    /// 执行检查的整数加法。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `overflowing_add` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::overflowing_add`]
    #[rustc_const_stable(feature = "const_int_overflow", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn add_with_overflow<T: Copy>(x: T, y: T) -> (T, bool);

    /// 执行检查的整数减法
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `overflowing_sub` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::overflowing_sub`]
    #[rustc_const_stable(feature = "const_int_overflow", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn sub_with_overflow<T: Copy>(x: T, y: T) -> (T, bool);

    /// 执行检查的整数乘法
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `overflowing_mul` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::overflowing_mul`]
    #[rustc_const_stable(feature = "const_int_overflow", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn mul_with_overflow<T: Copy>(x: T, y: T) -> (T, bool);

    /// 执行精确除法，从而导致 `x % y != 0` 或 `y == 0` 或 `x == T::MIN && y == -1` 出现不确定的行为
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_const_unstable(feature = "const_exact_div", issue = "none")]
    #[rustc_nounwind]
    pub fn exact_div<T: Copy>(x: T, y: T) -> T;

    /// 执行未经检查的除法，从而导致 `y == 0` 或 `x == T::MIN && y == -1` 出现不确定的行为
    ///
    ///
    /// 可通过 `checked_div` 方法在整数原语上使用此内部函数的安全包装。
    /// 例如，
    /// [`u32::checked_div`]
    #[rustc_const_stable(feature = "const_int_unchecked_div", since = "1.52.0")]
    #[rustc_nounwind]
    pub fn unchecked_div<T: Copy>(x: T, y: T) -> T;
    /// 返回未经检查的除法的其余部分，从而在 `y == 0` 或 `x == T::MIN && y == -1` 时导致未定义的行为
    ///
    ///
    /// 可通过 `checked_rem` 方法在整数原语上使用此内部函数的安全包装。
    /// 例如，
    /// [`u32::checked_rem`]
    #[rustc_const_stable(feature = "const_int_unchecked_rem", since = "1.52.0")]
    #[rustc_nounwind]
    pub fn unchecked_rem<T: Copy>(x: T, y: T) -> T;

    /// 执行未经检查的左移，导致 `y < 0` 或 `y >= N` 出现不确定的行为，其中 N 是 T 的宽度 (以位为单位)。
    ///
    ///
    /// 可通过 `checked_shl` 方法在整数原语上使用此内部函数的安全包装。
    /// 例如，
    /// [`u32::checked_shl`]
    #[rustc_const_stable(feature = "const_int_unchecked", since = "1.40.0")]
    #[rustc_nounwind]
    pub fn unchecked_shl<T: Copy>(x: T, y: T) -> T;
    /// 执行未经检查的右移，导致 `y < 0` 或 `y >= N` 出现不确定的行为，其中 N 是 T 的宽度 (以位为单位)。
    ///
    ///
    /// 可通过 `checked_shr` 方法在整数原语上使用此内部函数的安全包装。
    /// 例如，
    /// [`u32::checked_shr`]
    #[rustc_const_stable(feature = "const_int_unchecked", since = "1.40.0")]
    #[rustc_nounwind]
    pub fn unchecked_shr<T: Copy>(x: T, y: T) -> T;

    /// 返回未经检查的加法运算的结果，导致 `x + y > T::MAX` 或 `x + y < T::MIN` 出现不确定的行为。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_const_unstable(feature = "const_int_unchecked_arith", issue = "none")]
    #[rustc_nounwind]
    pub fn unchecked_add<T: Copy>(x: T, y: T) -> T;

    /// 返回未经检查的减法的结果，当 `x - y > T::MAX` 或 `x - y < T::MIN` 时导致未定义的行为。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_const_unstable(feature = "const_int_unchecked_arith", issue = "none")]
    #[rustc_nounwind]
    pub fn unchecked_sub<T: Copy>(x: T, y: T) -> T;

    /// 返回未经检查的乘法的结果，当 `x *y > T::MAX` 或 `x* y < T::MIN` 时导致未定义的行为。
    ///
    ///
    /// 此内部函数没有稳定的对应对象。
    #[rustc_const_unstable(feature = "const_int_unchecked_arith", issue = "none")]
    #[rustc_nounwind]
    pub fn unchecked_mul<T: Copy>(x: T, y: T) -> T;

    /// 向左旋转。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `rotate_left` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::rotate_left`]
    #[rustc_const_stable(feature = "const_int_rotate", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn rotate_left<T: Copy>(x: T, y: T) -> T;

    /// 向右旋转。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `rotate_right` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::rotate_right`]
    #[rustc_const_stable(feature = "const_int_rotate", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn rotate_right<T: Copy>(x: T, y: T) -> T;

    /// 返回 (a + b) mod 2 <sup>N</sup>，其中 N 是 T 的宽度 (以位为单位)。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `wrapping_add` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::wrapping_add`]
    #[rustc_const_stable(feature = "const_int_wrapping", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn wrapping_add<T: Copy>(a: T, b: T) -> T;
    /// 返回 (a-b) mod 2 <sup>N</sup>，其中 N 是 T 的宽度 (以位为单位)。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `wrapping_sub` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::wrapping_sub`]
    #[rustc_const_stable(feature = "const_int_wrapping", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn wrapping_sub<T: Copy>(a: T, b: T) -> T;
    /// 返回 (a * b) mod 2 <sup>N</sup>，其中 N 是 T 的宽度 (以位为单位)。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `wrapping_mul` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::wrapping_mul`]
    #[rustc_const_stable(feature = "const_int_wrapping", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn wrapping_mul<T: Copy>(a: T, b: T) -> T;

    /// 计算 `a + b`，在数字范围内达到饱和。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `saturating_add` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::saturating_add`]
    #[rustc_const_stable(feature = "const_int_saturating", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn saturating_add<T: Copy>(a: T, b: T) -> T;
    /// 计算 `a - b`，在数字范围内达到饱和。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    /// 可通过 `saturating_sub` 方法在整数原语上使用此内部函数的稳定版本。
    ///
    /// 例如，
    /// [`u32::saturating_sub`]
    #[rustc_const_stable(feature = "const_int_saturating", since = "1.40.0")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn saturating_sub<T: Copy>(a: T, b: T) -> T;

    /// 这是 [`crate::ptr::read`] 的实现细节，不应在其他任何地方使用。请参见其评论以了解其存在的原因。
    ///
    /// 这个内部函数可以*仅*在指针是没有投影的局部指针 (`read_via_copy (ptr)`，而不是 `read_via_copy(*ptr)`) 的情况下被调用，因此它平凡地遵守关于操作数中 derefs 的运行时 MIR 规则。
    ///
    ///
    ///
    #[rustc_const_stable(feature = "const_ptr_read", since = "1.71.0")]
    #[rustc_nounwind]
    pub fn read_via_copy<T>(ptr: *const T) -> T;

    /// 这是 [`crate::ptr::write`] 的实现细节，不应在其他任何地方使用。请参见其评论以了解其存在的原因。
    ///
    /// 这个内部函数可以*仅*在指针是没有投影的局部指针 (`write_via_move (ptr, x)`，而不是 `write_via_move(*ptr, x)`) 的情况下被调用，因此它平凡地遵守关于操作数中的 derefs 的运行时 MIR 规则。
    ///
    ///
    ///
    #[cfg(not(bootstrap))]
    #[rustc_const_unstable(feature = "const_ptr_write", issue = "86302")]
    #[rustc_nounwind]
    pub fn write_via_move<T>(ptr: *mut T, value: T);

    /// 返回 'v' 中变体的判别式的值；
    /// 如果 `T` 没有判别，则返回 `0`。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 这个 intrinsic 的稳定版本是 [`core::mem::discriminant`]。
    #[rustc_const_unstable(feature = "const_discriminant", issue = "69821")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn discriminant_value<T>(v: &T) -> <T as DiscriminantKind>::Discriminant;

    /// 返回 `T` 类型强制转换为 `usize` 的变体的数量；
    /// 如果 `T` 没有变体，则返回 `0`。无人居住的变体将被计算在内。
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    ///
    /// 此内部函数的稳定版本为 [`mem::variant_count`]。
    #[rustc_const_unstable(feature = "variant_count", issue = "73662")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn variant_count<T>() -> usize;

    /// Rust 的 "try catch" 构造使用数据指针 `data` 调用函数指针 `try_fn`。
    ///
    /// 第三个参数是如果发生 panic 时调用的函数。
    /// 此函数采用数据指针和指向所捕获的特定于目标的异常对象的指针。
    ///
    /// 有关更多信息，请参见编译器的源代码以及 std 的 catch 实现。
    ///
    /// `catch_fn` 不得展开。
    ///
    #[rustc_nounwind]
    pub fn r#try(try_fn: fn(*mut u8), data: *mut u8, catch_fn: fn(*mut u8, *mut u8)) -> i32;

    /// 根据 LLVM 发出 `!nontemporal` 存储 (请参见其文档)。
    /// 可能永远都不会变得稳定。
    #[rustc_nounwind]
    pub fn nontemporal_store<T>(ptr: *mut T, val: T);

    /// 有关详细信息，请参见 `<*const T>::offset_from` 的文档。
    #[rustc_const_stable(feature = "const_ptr_offset_from", since = "1.65.0")]
    #[rustc_nounwind]
    pub fn ptr_offset_from<T>(ptr: *const T, base: *const T) -> isize;

    /// 有关详细信息，请参见 `<*const T>::sub_ptr` 的文档。
    #[rustc_const_unstable(feature = "const_ptr_sub_ptr", issue = "95892")]
    #[rustc_nounwind]
    pub fn ptr_offset_from_unsigned<T>(ptr: *const T, base: *const T) -> usize;

    /// 有关详细信息，请参见 `<*const T>::guaranteed_eq` 的文档。
    /// 如果结果未知，则返回 `2`。
    /// 如果保证指针相等，则返回 `1` 如果保证指针不相等，则返回 `0`
    ///
    ///
    /// 请注意，与大多数内部函数不同，这对调用是安全的；
    /// 它不需要 `unsafe` 块。
    /// 因此，实现不得要求用户维护任何安全不变量。
    ///
    #[rustc_const_unstable(feature = "const_raw_ptr_comparison", issue = "53020")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn ptr_guaranteed_cmp<T>(ptr: *const T, other: *const T) -> u8;

    /// 在编译时分配一块内存。
    /// 在运行时，只返回一个空指针。
    ///
    /// # Safety
    ///
    /// - `align` 参数必须是 2 的幂。
    ///    - 在编译时，如果违反此约束，则会发生编译错误。
    ///    - 在运行时，它不会被检查。
    #[rustc_const_unstable(feature = "const_heap", issue = "79597")]
    #[rustc_nounwind]
    pub fn const_allocate(size: usize, align: usize) -> *mut u8;

    /// 释放在编译时由 `intrinsics::const_allocate` 分配的内存。
    /// 在运行时，什么都不做。
    ///
    /// # Safety
    ///
    /// - `align` 参数必须是 2 的幂。
    ///    - 在编译时，如果违反此约束，则会发生编译错误。
    ///    - 在运行时，它不会被检查。
    /// - 如果 `ptr` 是在另一个常量中创建的，这个内部函数不会释放它。
    /// - 如果 `ptr` 指向一个局部变量，这个内部函数不会释放它。
    #[rustc_const_unstable(feature = "const_heap", issue = "79597")]
    #[rustc_nounwind]
    pub fn const_deallocate(ptr: *mut u8, size: usize, align: usize);

    /// 确定两个值的原始字节是否相等。
    ///
    /// 这对于数组来说特别方便，因为它允许只比较 `i96`，而不是强制 `alloca` 用于 `[6 x i16]` 之类的事情。
    ///
    /// 在某些后端决定的之上，这将发出 `memcmp` 调用，就像对相等阈值所做的那样，而不是导致大量代码大小。
    ///
    /// 由于这是通过比较底层字节来工作的，因此实际的 `T` 并不是特别重要。
    /// 它将用于其大小和对齐方式，但任何有效性限制都将被忽略，而不是强制执行。
    ///
    /// # Safety
    ///
    /// 如果 `*a` 或 `*b` 中的任何 *bytes* 未初始化或带有指针值，则调用 this 是 UB。
    /// 请注意，这是一个比完全初始化 *values* 更严格的标准：如果 `T` 有填充，它是 UB 到调用这个内部函数。
    ///
    ///
    /// (该实现允许在比较结果上进行分支，如果它们的任何输入为 `undef`，则为 UB。)
    ///
    ///
    ///
    ///
    ///
    #[rustc_const_unstable(feature = "const_intrinsic_raw_eq", issue = "none")]
    #[rustc_nounwind]
    pub fn raw_eq<T>(a: &T, b: &T) -> bool;

    /// 有关详细信息，请参见 [`std::hint::black_box`] 的文档。
    ///
    /// [`std::hint::black_box`]: crate::hint::black_box
    #[rustc_const_unstable(feature = "const_black_box", issue = "none")]
    #[rustc_safe_intrinsic]
    #[rustc_nounwind]
    pub fn black_box<T>(dummy: T) -> T;

    /// `ptr` 必须指向 vtable。
    /// 内部函数将返回存储在 vtable 中的大小。
    #[rustc_nounwind]
    pub fn vtable_size(ptr: *const ()) -> usize;

    /// `ptr` 必须指向 vtable。
    /// 内部函数将返回存储在 vtable 中的对齐方式。
    #[rustc_nounwind]
    pub fn vtable_align(ptr: *const ()) -> usize;

    /// 根据上下文选择要调用的函数。
    ///
    /// 如果在编译时对该函数求值，那么这个内部函数的调用将被替换为 `called_in_const` 的调用。
    /// 否则，它会被替换为对 `called_at_rt` 的调用。
    ///
    /// # 类型要求
    ///
    /// 这两个函数必须都是函数项。它们不能是函数指针或闭包。第一个函数必须是 `const fn`。
    ///
    /// `arg` 将是元组参数，将传递给两个函数之一，因此，两个函数必须接受相同类型的参数。
    ///
    /// 两个函数都必须返回 RET。
    ///
    /// # Safety
    ///
    /// 这两个函数必须表现出可观察到的等价性。
    /// 其他 crates 中的安全代码可能假设在编译时和运行时调用 `const fn` 会产生相同的结果。
    /// 在运行时计算时会产生不同结果或具有任何其他可观察到的副作用的函数是 *unsound*。
    ///
    /// 这是一个可能导致问题的示例：
    ///
    /// ```no_run
    /// #![feature(const_eval_select)]
    /// #![feature(core_intrinsics)]
    /// use std::hint::unreachable_unchecked;
    /// use std::intrinsics::const_eval_select;
    ///
    /// // Crate A
    /// pub const fn inconsistent() -> i32 {
    ///     fn runtime() -> i32 { 1 }
    ///     const fn compiletime() -> i32 { 2 }
    ///
    ///     unsafe {
    // // ⚠ 这段代码违反了 `compiletime` 的等价要求
    ///         // 和 `runtime`。
    ///         const_eval_select((), compiletime, runtime)
    ///     }
    /// }
    ///
    /// // Crate B
    /// const X: i32 = inconsistent();
    /// let x = inconsistent();
    /// if x != X { unsafe { unreachable_unchecked(); }}
    /// ```
    ///
    /// 此代码在运行时会导致未定义行为，因为实际上已到达 `unreachable_unchecked`。
    /// 该错误在 *crate A* 中，这违反了 `const fn` 在编译时和运行时必须表现相同的原则。
    /// crate B 中的不安全代码没问题。
    ///
    ///
    ///
    ///
    #[rustc_const_unstable(feature = "const_eval_select", issue = "none")]
    pub fn const_eval_select<ARG: Tuple, F, G, RET>(
        arg: ARG,
        called_in_const: F,
        called_at_rt: G,
    ) -> RET
    where
        G: FnOnce<ARG, Output = RET>,
        F: FnOnce<ARG, Output = RET>;

    /// 此方法创建指向任何 `Some` 值的指针。
    /// 如果参数是 `None`，则返回一个无效的边界内指针 (对于创建一个空切片来说仍然可以接受)。
    ///
    #[rustc_nounwind]
    pub fn option_payload_ptr<T>(arg: *const Option<T>) -> *const T;
}

// 之所以在这里定义一些函数，是因为它们意外地在稳定模块中可用。
// 请参见 <https://github.com/rust-lang/rust/issues/15702>。
// (`transmute` 也属于此类别，但是由于检查 `T` 和 `U` 具有相同的大小，因此无法将其包装。)
//

/// 检查是否遵循了不安全函数的先决条件，如果 debug_assertions 开启，并且仅在运行时。
///
/// 这个宏应该被称为 `assert_unsafe_precondition!([Generics](name: Type) => Expression)`，其中指定的名称将被移动到捕获的宏中，并定义了一个参数宏调用 `const_eval_select` on。
///
/// 方括号内的 tokens 用于表示函数声明的泛型，如果没有泛型则可以省略。
///
/// # Safety
///
/// 仅当以下代码在传递的表达式计算结果为 false 时已经是 UB 时，调用此宏才是正确的。
///
/// 如果设置了 debug_assertions，则此宏扩展为在运行时进行检查。它在编译时不起作用，但包含的 `const_eval_select` 的语义在运行时和编译时必须相同。
/// 因此，如果表达式的计算结果为 false，则此宏在编译时和运行时会产生不同的行为，并且调用它是不正确的。
///
/// 所以从某种意义上说，如果这个宏有用的话就是 UB，但是我们希望 `unsafe fn` 的调用者偶尔会犯错误，这个检查应该可以帮助他们解决问题。
///
///
///
///
///
///
#[allow_internal_unstable(const_eval_select)] // 允许在 stable-const fn 中调用它
macro_rules! assert_unsafe_precondition {
    ($name:expr, $([$($tt:tt)*])?($($i:ident:$ty:ty),*$(,)?) => $e:expr) => {
        if cfg!(debug_assertions) {
            // 允许 non_snake_case 允许捕获 const 泛型
            #[allow(non_snake_case)]
            #[inline(always)]
            fn runtime$(<$($tt)*>)?($($i:$ty),*) {
                if !$e {
                    // 不要放松以减少对代码大小的影响
                    ::core::panicking::panic_nounwind(
                        concat!("unsafe precondition(s) violated: ", $name)
                    );
                }
            }
            #[allow(non_snake_case)]
            #[inline]
            const fn comptime$(<$($tt)*>)?($(_:$ty),*) {}

            ::core::intrinsics::const_eval_select(($($i,)*), comptime, runtime);
        }
    };
}
pub(crate) use assert_unsafe_precondition;

/// 检查 `ptr` 是否相对于 `align_of::<T>()` 正确对齐。
///
pub(crate) fn is_aligned_and_not_null<T>(ptr: *const T) -> bool {
    !ptr.is_null() && ptr.is_aligned()
}

/// 检查 `T` 的 `len` 实例的分配是否超过允许的最大分配大小。
///
pub(crate) fn is_valid_allocation_size<T>(len: usize) -> bool {
    let max_len = const {
        let size = crate::mem::size_of::<T>();
        if size == 0 { usize::MAX } else { isize::MAX as usize / size }
    };
    len <= max_len
}

/// 检查从 `src` 和 `dst` 开始、大小为 `count * size_of::<T>()` 的内存区域是否*不*重叠。
///
pub(crate) fn is_nonoverlapping<T>(src: *const T, dst: *const T, count: usize) -> bool {
    let src_usize = src.addr();
    let dst_usize = dst.addr();
    let size = mem::size_of::<T>()
        .checked_mul(count)
        .expect("is_nonoverlapping: `size_of::<T>() * count` overflows a usize");
    let diff = if src_usize > dst_usize { src_usize - dst_usize } else { dst_usize - src_usize };
    // 如果 ptr 之间的绝对距离至少与缓冲区的大小一样大，则它们不会重叠。
    //
    diff >= size
}

/// 将 `count * size_of::<T>()` 字节从 `src` 复制到 `dst`。源和目标必须不重叠。
///
/// 对于可能重叠的内存区域，请改用 [`copy`]。
///
/// `copy_nonoverlapping` 在语义上等同于 C 的 [`memcpy`]，但交换了参数顺序。
///
/// 副本是 "untyped"，因为数据可能未初始化或违反 `T` 的要求。初始化状态被完全保留。
///
/// [`memcpy`]: https://en.cppreference.com/w/c/string/byte/memcpy
///
/// # Safety
///
/// 如果违反以下任一条件，则行为是未定义的：
///
/// * 对于 `count * size_of::<T>()` 字节的读取，`src` 必须是 [valid]。
///
/// * 对于 `count * size_of::<T>()` 字节的写入，`dst` 必须是 [valid]。
///
/// * `src` 和 `dst` 必须正确对齐。
///
/// * 从 `src` 开始的内存区域，大小为 `count *
///   size_of::<T> () ` 字节不得与以 `dst` 开始且大小相同的内存区域重叠。
///
/// 与 [`read`] 一样，无论 `T` 是否为 [`Copy`]，`copy_nonoverlapping` 都会创建 `T` 的按位副本。
/// 如果 `T` 不是 [`Copy`]，则使用两个以 `*src` 开头的区域和以 `*dst` 开头的区域中的值可以 [违反内存安全][read-ownership]。
///
///
/// 请注意，即使有效复制的大小 (`count * size_of::<T>()`) 是 `0`，指针也必须非空的并且正确对齐。
///
/// [`read`]: crate::ptr::read
/// [read-ownership]: crate::ptr::read#ownership-of-the-returned-value
/// [valid]: crate::ptr#safety
///
/// # Examples
///
/// 手动实现 [`Vec::append`]：
///
/// ```
/// use std::ptr;
///
/// /// 将 `src` 的所有元素移到 `dst`，将 `src` 留空。
/// fn append<T>(dst: &mut Vec<T>, src: &mut Vec<T>) {
///     let src_len = src.len();
///     let dst_len = dst.len();
///
///     // 确保 `dst` 具有足够的容量来容纳所有 `src`。
///     dst.reserve(src_len);
///
///     unsafe {
///         // 添加的调用总是安全的，因为 `Vec` 永远不会分配超过 `isize::MAX` 字节。
/////
///         let dst_ptr = dst.as_mut_ptr().add(dst_len);
///         let src_ptr = src.as_ptr();
///
///         // 截断 `src` 而不丢弃其内容。
///         // 我们首先执行此操作，以避免在 panics 处出现问题时避免出现问题。
///         src.set_len(0);
///
///         // 这两个区域不能重叠，因为可变引用没有别名，并且两个不同的 vectors 不能拥有相同的内存。
/////
/////
///         ptr::copy_nonoverlapping(src_ptr, dst_ptr, src_len);
///
///         // 通知 `dst` 现在包含 `src` 的内容。
///         dst.set_len(dst_len + src_len);
///     }
/// }
///
/// let mut a = vec!['r'];
/// let mut b = vec!['u', 's', 't'];
///
/// append(&mut a, &mut b);
///
/// assert_eq!(a, &['r', 'u', 's', 't']);
/// assert!(b.is_empty());
/// ```
///
/// [`Vec::append`]: ../../std/vec/struct.Vec.html#method.append
///
///
///
///
///
///
#[doc(alias = "memcpy")]
#[stable(feature = "rust1", since = "1.0.0")]
#[rustc_allowed_through_unstable_modules]
#[rustc_const_stable(feature = "const_intrinsic_copy", since = "1.63.0")]
#[inline]
#[cfg_attr(miri, track_caller)] // 即使没有 panic，这也有助于 Miri 回溯
pub const unsafe fn copy_nonoverlapping<T>(src: *const T, dst: *mut T, count: usize) {
    extern "rust-intrinsic" {
        #[rustc_const_stable(feature = "const_intrinsic_copy", since = "1.63.0")]
        #[rustc_nounwind]
        pub fn copy_nonoverlapping<T>(src: *const T, dst: *mut T, count: usize);
    }

    // SAFETY: 调用者必须遵守 `copy_nonoverlapping` 的安全保证。
    //
    unsafe {
        assert_unsafe_precondition!(
            "ptr::copy_nonoverlapping requires that both pointer arguments are aligned and non-null \
            and the specified memory ranges do not overlap",
            [T](src: *const T, dst: *mut T, count: usize) =>
            is_aligned_and_not_null(src)
                && is_aligned_and_not_null(dst)
                && is_nonoverlapping(src, dst, count)
        );
        copy_nonoverlapping(src, dst, count)
    }
}

/// 将 `count * size_of::<T>()` 字节从 `src` 复制到 `dst`。源和目标可能会重叠。
///
/// 如果源和目标永远不会重叠，则可以改用 [`copy_nonoverlapping`]。
///
/// `copy` 在语义上等同于 C 的 [`memmove`]，但交换了参数顺序。
/// 就像将字节从 `src` 复制到临时数组，然后从数组复制到 `dst` 一样进行复制。
///
/// 副本是 "untyped"，因为数据可能未初始化或违反 `T` 的要求。初始化状态被完全保留。
///
/// [`memmove`]: https://en.cppreference.com/w/c/string/byte/memmove
///
/// # Safety
///
/// 如果违反以下任一条件，则行为是未定义的：
///
/// * 对于 `count * size_of::<T>()` 字节的读取，`src` 必须是 [valid]。
///
/// * 对于 `count * size_of::<T>()` 字节的写入，`dst` 必须是 [valid]。
///
/// * `src` 和 `dst` 必须正确对齐。
///
/// 与 [`read`] 一样，无论 `T` 是否为 [`Copy`]，`copy` 都会创建 `T` 的按位副本。
/// 如果 `T` 不是 [`Copy`]，则可以同时使用以 `*src` 开头的区域和以 `* dst` 开头的区域中的值。
///
///
/// 请注意，即使有效复制的大小 (`count * size_of::<T>()`) 是 `0`，指针也必须非空的并且正确对齐。
///
/// [`read`]: crate::ptr::read
/// [read-ownership]: crate::ptr::read#ownership-of-the-returned-value
/// [valid]: crate::ptr#safety
///
/// # Examples
///
/// 从不安全的缓冲区有效地创建 Rust vector：
///
/// ```
/// use std::ptr;
///
/// /// # Safety
//////
/// /// * `ptr` 必须与其类型正确对齐且非零。
/// /// * `ptr` 必须对 `T` 类型的 `elts` 连续元素的读取有效。
/// /// * 除非 `T: Copy`，否则在调用此函数后不得使用这些元素。
/// # #[allow(dead_code)]
/// unsafe fn from_buf_raw<T>(ptr: *const T, elts: usize) -> Vec<T> {
///     let mut dst = Vec::with_capacity(elts);
///
///     // SAFETY: 我们的前提条件是确保源文件对齐和有效，而 `Vec::with_capacity` 确保我们有可用的空间来编写它们。
/////
///     ptr::copy(ptr, dst.as_mut_ptr(), elts);
///
///     // SAFETY: 我们之前已经用这么大的容量创建了它，而以前的 `copy` 已经初始化了这些元素。
/////
///     dst.set_len(elts);
///     dst
/// }
/// ```
///
///
///
///
///
///
#[doc(alias = "memmove")]
#[stable(feature = "rust1", since = "1.0.0")]
#[rustc_allowed_through_unstable_modules]
#[rustc_const_stable(feature = "const_intrinsic_copy", since = "1.63.0")]
#[inline]
#[cfg_attr(miri, track_caller)] // 即使没有 panic，这也有助于 Miri 回溯
pub const unsafe fn copy<T>(src: *const T, dst: *mut T, count: usize) {
    extern "rust-intrinsic" {
        #[rustc_const_stable(feature = "const_intrinsic_copy", since = "1.63.0")]
        #[rustc_nounwind]
        fn copy<T>(src: *const T, dst: *mut T, count: usize);
    }

    // SAFETY: 调用者必须遵守 `copy` 的安全保证。
    unsafe {
        assert_unsafe_precondition!(
            "ptr::copy requires that both pointer arguments are aligned and non-null",
            [T](src: *const T, dst: *mut T) =>
            is_aligned_and_not_null(src) && is_aligned_and_not_null(dst)
        );
        copy(src, dst, count)
    }
}

/// 将从 `dst` 开始的 `count * size_of::<T>()` 内存字节设置为 `val`。
///
/// `write_bytes` 类似于 C 的 [`memset`]，但将 `count * size_of::<T>()` 字节设置为 `val`。
///
/// [`memset`]: https://en.cppreference.com/w/c/string/byte/memset
///
/// # Safety
///
/// 如果违反以下任一条件，则行为是未定义的：
///
/// * 对于 `count * size_of::<T>()` 字节的写入，`dst` 必须是 [valid]。
///
/// * `dst` 必须正确对齐。
///
/// 请注意，即使有效复制的大小 (`count * size_of::<T>()`) 是 `0`，指针也必须非空的并且正确对齐。
///
/// 此外，请注意，如果写入的字节不是某些 `T` 的有效表示，那么以这种方式更改 `*dst` 很容易导致 (UB) 以后出现未定义的行为。
/// 例如，以下是此函数的**不正确**用法:
///
/// ```rust,no_run
/// unsafe {
///     let mut value: u8 = 0;
///     let ptr: *mut bool = &mut value as *mut u8 as *mut bool;
///     let _bool = ptr.read(); // 这很好，`ptr` 指向一个有效的 `bool`。
///     ptr.write_bytes(42u8, 1); // 这个函数本身不会导致 UB...
///     let _bool = ptr.read(); // ...但它使这个操作成为 UB! ⚠️
/// }
/// ```
///
/// [valid]: crate::ptr#safety
///
/// # Examples
///
/// 基本用法：
///
/// ```
/// use std::ptr;
///
/// let mut vec = vec![0u32; 4];
/// unsafe {
///     let vec_ptr = vec.as_mut_ptr();
///     ptr::write_bytes(vec_ptr, 0xfe, 2);
/// }
/// assert_eq!(vec, [0xfefefefe, 0xfefefefe, 0, 0]);
/// ```
///
///
///
///
#[doc(alias = "memset")]
#[stable(feature = "rust1", since = "1.0.0")]
#[rustc_allowed_through_unstable_modules]
#[rustc_const_unstable(feature = "const_ptr_write", issue = "86302")]
#[inline]
#[cfg_attr(miri, track_caller)] // 即使没有 panic，这也有助于 Miri 回溯
pub const unsafe fn write_bytes<T>(dst: *mut T, val: u8, count: usize) {
    extern "rust-intrinsic" {
        #[rustc_const_unstable(feature = "const_ptr_write", issue = "86302")]
        #[rustc_nounwind]
        fn write_bytes<T>(dst: *mut T, val: u8, count: usize);
    }

    // SAFETY: 调用者必须遵守 `write_bytes` 的安全保证。
    unsafe {
        assert_unsafe_precondition!(
            "ptr::write_bytes requires that the destination pointer is aligned and non-null",
            [T](dst: *mut T) => is_aligned_and_not_null(dst)
        );
        write_bytes(dst, val, count)
    }
}

/// Polyfill 用于引导程序
#[cfg(bootstrap)]
pub const unsafe fn transmute_unchecked<Src, Dst>(src: Src) -> Dst {
    use crate::mem::*;
    // SAFETY: 这是一种转化 -- 调用者保证没问题。
    unsafe { transmute_copy(&ManuallyDrop::new(src)) }
}

/// Polyfill 用于引导程序
#[cfg(bootstrap)]
pub const unsafe fn write_via_move<T>(ptr: *mut T, value: T) {
    use crate::mem::*;
    // SAFETY: 调用者必须保证 `dst` 对写入有效。
    // `dst` 不能与 `dst` 重叠，因为调用者拥有 `dst` 的权限，而 `src` 是这个函数拥有所有权的。
    //
    unsafe {
        copy_nonoverlapping::<T>(&value, ptr, 1);
        forget(value);
    }
}