Tracking Issue for `u{N}::{wrapping,checked,strict,unbounded}_funnel_{shl,shr}`

Feature gate: #![feature(wrapping_funnel_shifts)]

This is a tracking issue for the wrapping/checked/strict/unbounded funnel shift methods on unsigned integer types.

These extend the previously existing plain and unchecked funnel shift methods (tracked at #145686) to express additional specific overflow semantics.

Public API

impl u{8,16,32,64,128,size} {
    pub const fn wrapping_funnel_shl(self, right: Self, n: u32) -> Self;
    pub const fn wrapping_funnel_shr(self, right: Self, n: u32) -> Self;
    pub const fn checked_funnel_shl(self, right: Self, n: u32) -> Option<Self>;
    pub const fn checked_funnel_shr(self, right: Self, n: u32) -> Option<Self>;
    pub const fn strict_funnel_shl(self, right: Self, n: u32) -> Self;
    pub const fn strict_funnel_shr(self, right: Self, n: u32) -> Self;
    pub const fn unbounded_funnel_shl(self, right: Self, n: u32) -> Self;
    pub const fn unbounded_funnel_shr(self, right: Self, n: u32) -> Self;
}

Steps / History

(Remember to update the S-tracking-* label when checking boxes.)

• ACP: rust-lang/libs-team#855
• Implementation: #161119
• Final comment period (FCP)^1
• Stabilization PR

Unresolved Questions

• None yet.

Start by reviewing implementation PR #161119 and the public API listed in this tracking issue, then compare the feature-gate checklist with its current status. Done means the implementation, final comment period, and stabilization steps have been completed.