Tracking Issue for integer extension and truncation methods

View all comments

Feature gate: #![feature(integer_extend_truncate)]

This is a tracking issue for integer extension and truncation methods.

Public API

impl iX {
    // `Target` is a signed integer with size >= Self
    fn widen<Target>(self) -> Target
        where Self: WidenTarget<Target>;

    // `Target` is a signed integer with size <= Self
    fn truncate<Target>(self) -> Target
        where Self: TruncateTarget<Target>;
    fn saturating_truncate<Target>(self) -> Target
        where Self: TruncateTarget<Target>;
    fn checked_truncate<Target>(self) -> Option<Target>
        where Self: TruncateTarget<Target>;
}

impl uX {
    // `Target` is an unsigned integer with size >= Self
    fn widen<Target>(self) -> Target
        where Self: WidenTarget<Target>;

    // `Target` is an unsigned integer with size <= Self
    fn truncate<Target>(self) -> Target
        where Self: TruncateTarget<Target>;
    fn saturating_truncate<Target>(self) -> Target
        where Self: TruncateTarget<Target>;
    fn checked_truncate<Target>(self) -> Option<Target>
        where Self: TruncateTarget<Target>;
}

Steps / History

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

• ACP: rust-lang/libs-team#204
• Implementation: https://github.com/rust-lang/rust/pull/154356
• Final comment period (FCP)^1
• Stabilization PR

Unresolved Questions

• None yet.

Review the integer_extend_truncate feature gate and the completed implementation in rust-lang/rust#154356. Then read the stabilization procedure linked in the final comment period section; done means completing FCP and preparing the remaining stabilization PR.