clippy_utils/src/qualify_min_const_fn.rs

   1 // This code used to be a part of `rustc` but moved to Clippy as a result of
   2 // https://github.com/rust-lang/rust/issues/76618. Because of that, it contains unused code and some
   3 // of terminologies might not be relevant in the context of Clippy. Note that its behavior might
   4 // differ from the time of `rustc` even if the name stays the same.
   5
   6 use rustc_hir as hir;
   7 use rustc_hir::def_id::DefId;
   8 use rustc_middle::mir::{
   9     Body, CastKind, NonDivergingIntrinsic, NullOp, Operand, Place, ProjectionElem, Rvalue, Statement, StatementKind,
  10     Terminator, TerminatorKind,
  11 };
  12 use rustc_middle::ty::subst::GenericArgKind;
  13 use rustc_middle::ty::{self, adjustment::PointerCast, Ty, TyCtxt};
  14 use rustc_semver::RustcVersion;
  15 use rustc_span::symbol::sym;
  16 use rustc_span::Span;
  17 use std::borrow::Cow;
  18
  19 type McfResult = Result<(), (Span, Cow<'static, str>)>;
  20
  21 pub fn is_min_const_fn<'a, 'tcx>(tcx: TyCtxt<'tcx>, body: &'a Body<'tcx>, msrv: Option<RustcVersion>) -> McfResult {
  22     let def_id = body.source.def_id();
  23     let mut current = def_id;
  24     loop {
  25         let predicates = tcx.predicates_of(current);
  26         for (predicate, _) in predicates.predicates {
  27             match predicate.kind().skip_binder() {
  28                 ty::PredicateKind::RegionOutlives(_)
  29                 | ty::PredicateKind::TypeOutlives(_)
  30                 | ty::PredicateKind::WellFormed(_)
  31                 | ty::PredicateKind::Projection(_)
  32                 | ty::PredicateKind::ConstEvaluatable(..)
  33                 | ty::PredicateKind::ConstEquate(..)
  34                 | ty::PredicateKind::Trait(..)
  35                 | ty::PredicateKind::TypeWellFormedFromEnv(..) => continue,
  36                 ty::PredicateKind::ObjectSafe(_) => panic!("object safe predicate on function: {:#?}", predicate),
  37                 ty::PredicateKind::ClosureKind(..) => panic!("closure kind predicate on function: {:#?}", predicate),
  38                 ty::PredicateKind::Subtype(_) => panic!("subtype predicate on function: {:#?}", predicate),
  39                 ty::PredicateKind::Coerce(_) => panic!("coerce predicate on function: {:#?}", predicate),
  40             }
  41         }
  42         match predicates.parent {
  43             Some(parent) => current = parent,
  44             None => break,
  45         }
  46     }
  47
  48     for local in &body.local_decls {
  49         check_ty(tcx, local.ty, local.source_info.span)?;
  50     }
  51     // impl trait is gone in MIR, so check the return type manually
  52     check_ty(
  53         tcx,
  54         tcx.fn_sig(def_id).output().skip_binder(),
  55         body.local_decls.iter().next().unwrap().source_info.span,
  56     )?;
  57
  58     for bb in body.basic_blocks.iter() {
  59         check_terminator(tcx, body, bb.terminator(), msrv)?;
  60         for stmt in &bb.statements {
  61             check_statement(tcx, body, def_id, stmt)?;
  62         }
  63     }
  64     Ok(())
  65 }
  66
  67 fn check_ty<'tcx>(tcx: TyCtxt<'tcx>, ty: Ty<'tcx>, span: Span) -> McfResult {
  68     for arg in ty.walk() {
  69         let ty = match arg.unpack() {
  70             GenericArgKind::Type(ty) => ty,
  71
  72             // No constraints on lifetimes or constants, except potentially
  73             // constants' types, but `walk` will get to them as well.
  74             GenericArgKind::Lifetime(_) | GenericArgKind::Const(_) => continue,
  75         };
  76
  77         match ty.kind() {
  78             ty::Ref(_, _, hir::Mutability::Mut) => {
  79                 return Err((span, "mutable references in const fn are unstable".into()));
  80             },
  81             ty::Opaque(..) => return Err((span, "`impl Trait` in const fn is unstable".into())),
  82             ty::FnPtr(..) => {
  83                 return Err((span, "function pointers in const fn are unstable".into()));
  84             },
  85             ty::Dynamic(preds, _, _) => {
  86                 for pred in preds.iter() {
  87                     match pred.skip_binder() {
  88                         ty::ExistentialPredicate::AutoTrait(_) | ty::ExistentialPredicate::Projection(_) => {
  89                             return Err((
  90                                 span,
  91                                 "trait bounds other than `Sized` \
  92                                  on const fn parameters are unstable"
  93                                     .into(),
  94                             ));
  95                         },
  96                         ty::ExistentialPredicate::Trait(trait_ref) => {
  97                             if Some(trait_ref.def_id) != tcx.lang_items().sized_trait() {
  98                                 return Err((
  99                                     span,
 100                                     "trait bounds other than `Sized` \
 101                                      on const fn parameters are unstable"
 102                                         .into(),
 103                                 ));
 104                             }
 105                         },
 106                     }
 107                 }
 108             },
 109             _ => {},
 110         }
 111     }
 112     Ok(())
 113 }
 114
 115 fn check_rvalue<'tcx>(
 116     tcx: TyCtxt<'tcx>,
 117     body: &Body<'tcx>,
 118     def_id: DefId,
 119     rvalue: &Rvalue<'tcx>,
 120     span: Span,
 121 ) -> McfResult {
 122     match rvalue {
 123         Rvalue::ThreadLocalRef(_) => Err((span, "cannot access thread local storage in const fn".into())),
 124         Rvalue::Len(place) | Rvalue::Discriminant(place) | Rvalue::Ref(_, _, place) | Rvalue::AddressOf(_, place) => {
 125             check_place(tcx, *place, span, body)
 126         },
 127         Rvalue::CopyForDeref(place) => check_place(tcx, *place, span, body),
 128         Rvalue::Repeat(operand, _)
 129         | Rvalue::Use(operand)
 130         | Rvalue::Cast(
 131             CastKind::PointerFromExposedAddress
 132             | CastKind::Misc
 133             | CastKind::Pointer(PointerCast::MutToConstPointer | PointerCast::ArrayToPointer),
 134             operand,
 135             _,
 136         ) => check_operand(tcx, operand, span, body),
 137         Rvalue::Cast(
 138             CastKind::Pointer(
 139                 PointerCast::UnsafeFnPointer | PointerCast::ClosureFnPointer(_) | PointerCast::ReifyFnPointer,
 140             ),
 141             _,
 142             _,
 143         ) => Err((span, "function pointer casts are not allowed in const fn".into())),
 144         Rvalue::Cast(CastKind::Pointer(PointerCast::Unsize), op, cast_ty) => {
 145             let pointee_ty = if let Some(deref_ty) = cast_ty.builtin_deref(true) {
 146                 deref_ty.ty
 147             } else {
 148                 // We cannot allow this for now.
 149                 return Err((span, "unsizing casts are only allowed for references right now".into()));
 150             };
 151             let unsized_ty = tcx.struct_tail_erasing_lifetimes(pointee_ty, tcx.param_env(def_id));
 152             if let ty::Slice(_) | ty::Str = unsized_ty.kind() {
 153                 check_operand(tcx, op, span, body)?;
 154                 // Casting/coercing things to slices is fine.
 155                 Ok(())
 156             } else {
 157                 // We just can't allow trait objects until we have figured out trait method calls.
 158                 Err((span, "unsizing casts are not allowed in const fn".into()))
 159             }
 160         },
 161         Rvalue::Cast(CastKind::PointerExposeAddress, _, _) => {
 162             Err((span, "casting pointers to ints is unstable in const fn".into()))
 163         },
 164         Rvalue::Cast(CastKind::DynStar, _, _) => {
 165             // FIXME(dyn-star)
 166             unimplemented!()
 167         },
 168         // binops are fine on integers
 169         Rvalue::BinaryOp(_, box (lhs, rhs)) | Rvalue::CheckedBinaryOp(_, box (lhs, rhs)) => {
 170             check_operand(tcx, lhs, span, body)?;
 171             check_operand(tcx, rhs, span, body)?;
 172             let ty = lhs.ty(body, tcx);
 173             if ty.is_integral() || ty.is_bool() || ty.is_char() {
 174                 Ok(())
 175             } else {
 176                 Err((
 177                     span,
 178                     "only int, `bool` and `char` operations are stable in const fn".into(),
 179                 ))
 180             }
 181         },
 182         Rvalue::NullaryOp(NullOp::SizeOf | NullOp::AlignOf, _) | Rvalue::ShallowInitBox(_, _) => Ok(()),
 183         Rvalue::UnaryOp(_, operand) => {
 184             let ty = operand.ty(body, tcx);
 185             if ty.is_integral() || ty.is_bool() {
 186                 check_operand(tcx, operand, span, body)
 187             } else {
 188                 Err((span, "only int and `bool` operations are stable in const fn".into()))
 189             }
 190         },
 191         Rvalue::Aggregate(_, operands) => {
 192             for operand in operands {
 193                 check_operand(tcx, operand, span, body)?;
 194             }
 195             Ok(())
 196         },
 197     }
 198 }
 199
 200 fn check_statement<'tcx>(
 201     tcx: TyCtxt<'tcx>,
 202     body: &Body<'tcx>,
 203     def_id: DefId,
 204     statement: &Statement<'tcx>,
 205 ) -> McfResult {
 206     let span = statement.source_info.span;
 207     match &statement.kind {
 208         StatementKind::Assign(box (place, rval)) => {
 209             check_place(tcx, *place, span, body)?;
 210             check_rvalue(tcx, body, def_id, rval, span)
 211         },
 212
 213         StatementKind::FakeRead(box (_, place)) => check_place(tcx, *place, span, body),
 214         // just an assignment
 215         StatementKind::SetDiscriminant { place, .. } | StatementKind::Deinit(place) => {
 216             check_place(tcx, **place, span, body)
 217         },
 218
 219         StatementKind::Intrinsic(box NonDivergingIntrinsic::Assume(op)) => check_operand(tcx, op, span, body),
 220
 221         StatementKind::Intrinsic(box NonDivergingIntrinsic::CopyNonOverlapping(
 222             rustc_middle::mir::CopyNonOverlapping { dst, src, count },
 223         )) => {
 224             check_operand(tcx, dst, span, body)?;
 225             check_operand(tcx, src, span, body)?;
 226             check_operand(tcx, count, span, body)
 227         },
 228         // These are all NOPs
 229         StatementKind::StorageLive(_)
 230         | StatementKind::StorageDead(_)
 231         | StatementKind::Retag { .. }
 232         | StatementKind::AscribeUserType(..)
 233         | StatementKind::Coverage(..)
 234         | StatementKind::Nop => Ok(()),
 235     }
 236 }
 237
 238 fn check_operand<'tcx>(tcx: TyCtxt<'tcx>, operand: &Operand<'tcx>, span: Span, body: &Body<'tcx>) -> McfResult {
 239     match operand {
 240         Operand::Move(place) | Operand::Copy(place) => check_place(tcx, *place, span, body),
 241         Operand::Constant(c) => match c.check_static_ptr(tcx) {
 242             Some(_) => Err((span, "cannot access `static` items in const fn".into())),
 243             None => Ok(()),
 244         },
 245     }
 246 }
 247
 248 fn check_place<'tcx>(tcx: TyCtxt<'tcx>, place: Place<'tcx>, span: Span, body: &Body<'tcx>) -> McfResult {
 249     let mut cursor = place.projection.as_ref();
 250     while let [ref proj_base @ .., elem] = *cursor {
 251         cursor = proj_base;
 252         match elem {
 253             ProjectionElem::Field(..) => {
 254                 let base_ty = Place::ty_from(place.local, proj_base, body, tcx).ty;
 255                 if let Some(def) = base_ty.ty_adt_def() {
 256                     // No union field accesses in `const fn`
 257                     if def.is_union() {
 258                         return Err((span, "accessing union fields is unstable".into()));
 259                     }
 260                 }
 261             },
 262             ProjectionElem::ConstantIndex { .. }
 263             | ProjectionElem::OpaqueCast(..)
 264             | ProjectionElem::Downcast(..)
 265             | ProjectionElem::Subslice { .. }
 266             | ProjectionElem::Deref
 267             | ProjectionElem::Index(_) => {},
 268         }
 269     }
 270
 271     Ok(())
 272 }
 273
 274 fn check_terminator<'a, 'tcx>(
 275     tcx: TyCtxt<'tcx>,
 276     body: &'a Body<'tcx>,
 277     terminator: &Terminator<'tcx>,
 278     msrv: Option<RustcVersion>,
 279 ) -> McfResult {
 280     let span = terminator.source_info.span;
 281     match &terminator.kind {
 282         TerminatorKind::FalseEdge { .. }
 283         | TerminatorKind::FalseUnwind { .. }
 284         | TerminatorKind::Goto { .. }
 285         | TerminatorKind::Return
 286         | TerminatorKind::Resume
 287         | TerminatorKind::Unreachable => Ok(()),
 288
 289         TerminatorKind::Drop { place, .. } => check_place(tcx, *place, span, body),
 290         TerminatorKind::DropAndReplace { place, value, .. } => {
 291             check_place(tcx, *place, span, body)?;
 292             check_operand(tcx, value, span, body)
 293         },
 294
 295         TerminatorKind::SwitchInt {
 296             discr,
 297             switch_ty: _,
 298             targets: _,
 299         } => check_operand(tcx, discr, span, body),
 300
 301         TerminatorKind::Abort => Err((span, "abort is not stable in const fn".into())),
 302         TerminatorKind::GeneratorDrop | TerminatorKind::Yield { .. } => {
 303             Err((span, "const fn generators are unstable".into()))
 304         },
 305
 306         TerminatorKind::Call {
 307             func,
 308             args,
 309             from_hir_call: _,
 310             destination: _,
 311             target: _,
 312             cleanup: _,
 313             fn_span: _,
 314         } => {
 315             let fn_ty = func.ty(body, tcx);
 316             if let ty::FnDef(fn_def_id, _) = *fn_ty.kind() {
 317                 if !is_const_fn(tcx, fn_def_id, msrv) {
 318                     return Err((
 319                         span,
 320                         format!(
 321                             "can only call other `const fn` within a `const fn`, \
 322                              but `{:?}` is not stable as `const fn`",
 323                             func,
 324                         )
 325                         .into(),
 326                     ));
 327                 }
 328
 329                 // HACK: This is to "unstabilize" the `transmute` intrinsic
 330                 // within const fns. `transmute` is allowed in all other const contexts.
 331                 // This won't really scale to more intrinsics or functions. Let's allow const
 332                 // transmutes in const fn before we add more hacks to this.
 333                 if tcx.is_intrinsic(fn_def_id) && tcx.item_name(fn_def_id) == sym::transmute {
 334                     return Err((
 335                         span,
 336                         "can only call `transmute` from const items, not `const fn`".into(),
 337                     ));
 338                 }
 339
 340                 check_operand(tcx, func, span, body)?;
 341
 342                 for arg in args {
 343                     check_operand(tcx, arg, span, body)?;
 344                 }
 345                 Ok(())
 346             } else {
 347                 Err((span, "can only call other const fns within const fn".into()))
 348             }
 349         },
 350
 351         TerminatorKind::Assert {
 352             cond,
 353             expected: _,
 354             msg: _,
 355             target: _,
 356             cleanup: _,
 357         } => check_operand(tcx, cond, span, body),
 358
 359         TerminatorKind::InlineAsm { .. } => Err((span, "cannot use inline assembly in const fn".into())),
 360     }
 361 }
 362
 363 fn is_const_fn(tcx: TyCtxt<'_>, def_id: DefId, msrv: Option<RustcVersion>) -> bool {
 364     tcx.is_const_fn(def_id)
 365         && tcx.lookup_const_stability(def_id).map_or(true, |const_stab| {
 366             if let rustc_attr::StabilityLevel::Stable { since, .. } = const_stab.level {
 367                 // Checking MSRV is manually necessary because `rustc` has no such concept. This entire
 368                 // function could be removed if `rustc` provided a MSRV-aware version of `is_const_fn`.
 369                 // as a part of an unimplemented MSRV check https://github.com/rust-lang/rust/issues/65262.
 370
 371                 // HACK(nilstrieb): CURRENT_RUSTC_VERSION can return versions like 1.66.0-dev. `rustc-semver` doesn't accept
 372                 //                  the `-dev` version number so we have to strip it off.
 373                 let short_version = since
 374                     .as_str()
 375                     .split('-')
 376                     .next()
 377                     .expect("rustc_attr::StabilityLevel::Stable::since` is empty");
 378
 379                 let since = rustc_span::Symbol::intern(short_version);
 380
 381                 crate::meets_msrv(
 382                     msrv,
 383                     RustcVersion::parse(since.as_str())
 384                         .unwrap_or_else(|err| panic!("`rustc_attr::StabilityLevel::Stable::since` is ill-formatted: `{since}`, {err:?}")),
 385                 )
 386             } else {
 387                 // Unstable const fn with the feature enabled.
 388                 msrv.is_none()
 389             }
 390         })
 391 }