]> git.lizzy.rs Git - rust.git/blob - clippy_lints/src/misc.rs
Rustup to rust-lang/rust#66878
[rust.git] / clippy_lints / src / misc.rs
1 use if_chain::if_chain;
2 use matches::matches;
3 use rustc::declare_lint_pass;
4 use rustc::hir::intravisit::FnKind;
5 use rustc::hir::*;
6 use rustc::lint::{LateContext, LateLintPass, LintArray, LintPass};
7 use rustc::ty;
8 use rustc_errors::Applicability;
9 use rustc_session::declare_tool_lint;
10 use syntax::ast::LitKind;
11 use syntax::source_map::{ExpnKind, Span};
12
13 use crate::consts::{constant, Constant};
14 use crate::utils::sugg::Sugg;
15 use crate::utils::{
16     get_item_name, get_parent_expr, implements_trait, in_constant, is_integer_const, iter_input_pats,
17     last_path_segment, match_qpath, match_trait_method, paths, snippet, snippet_opt, span_lint, span_lint_and_sugg,
18     span_lint_and_then, span_lint_hir_and_then, walk_ptrs_ty, SpanlessEq,
19 };
20
21 declare_clippy_lint! {
22     /// **What it does:** Checks for function arguments and let bindings denoted as
23     /// `ref`.
24     ///
25     /// **Why is this bad?** The `ref` declaration makes the function take an owned
26     /// value, but turns the argument into a reference (which means that the value
27     /// is destroyed when exiting the function). This adds not much value: either
28     /// take a reference type, or take an owned value and create references in the
29     /// body.
30     ///
31     /// For let bindings, `let x = &foo;` is preferred over `let ref x = foo`. The
32     /// type of `x` is more obvious with the former.
33     ///
34     /// **Known problems:** If the argument is dereferenced within the function,
35     /// removing the `ref` will lead to errors. This can be fixed by removing the
36     /// dereferences, e.g., changing `*x` to `x` within the function.
37     ///
38     /// **Example:**
39     /// ```rust
40     /// fn foo(ref x: u8) -> bool {
41     ///     true
42     /// }
43     /// ```
44     pub TOPLEVEL_REF_ARG,
45     style,
46     "an entire binding declared as `ref`, in a function argument or a `let` statement"
47 }
48
49 declare_clippy_lint! {
50     /// **What it does:** Checks for comparisons to NaN.
51     ///
52     /// **Why is this bad?** NaN does not compare meaningfully to anything – not
53     /// even itself – so those comparisons are simply wrong.
54     ///
55     /// **Known problems:** None.
56     ///
57     /// **Example:**
58     /// ```rust
59     /// # use core::f32::NAN;
60     /// # let x = 1.0;
61     ///
62     /// if x == NAN { }
63     /// ```
64     pub CMP_NAN,
65     correctness,
66     "comparisons to NAN, which will always return false, probably not intended"
67 }
68
69 declare_clippy_lint! {
70     /// **What it does:** Checks for (in-)equality comparisons on floating-point
71     /// values (apart from zero), except in functions called `*eq*` (which probably
72     /// implement equality for a type involving floats).
73     ///
74     /// **Why is this bad?** Floating point calculations are usually imprecise, so
75     /// asking if two values are *exactly* equal is asking for trouble. For a good
76     /// guide on what to do, see [the floating point
77     /// guide](http://www.floating-point-gui.de/errors/comparison).
78     ///
79     /// **Known problems:** None.
80     ///
81     /// **Example:**
82     /// ```rust
83     /// let x = 1.2331f64;
84     /// let y = 1.2332f64;
85     /// if y == 1.23f64 { }
86     /// if y != x {} // where both are floats
87     /// ```
88     pub FLOAT_CMP,
89     correctness,
90     "using `==` or `!=` on float values instead of comparing difference with an epsilon"
91 }
92
93 declare_clippy_lint! {
94     /// **What it does:** Checks for conversions to owned values just for the sake
95     /// of a comparison.
96     ///
97     /// **Why is this bad?** The comparison can operate on a reference, so creating
98     /// an owned value effectively throws it away directly afterwards, which is
99     /// needlessly consuming code and heap space.
100     ///
101     /// **Known problems:** None.
102     ///
103     /// **Example:**
104     /// ```rust
105     /// # let x = "foo";
106     /// # let y = String::from("foo");
107     /// if x.to_owned() == y {}
108     /// ```
109     /// Could be written as
110     /// ```rust
111     /// # let x = "foo";
112     /// # let y = String::from("foo");
113     /// if x == y {}
114     /// ```
115     pub CMP_OWNED,
116     perf,
117     "creating owned instances for comparing with others, e.g., `x == \"foo\".to_string()`"
118 }
119
120 declare_clippy_lint! {
121     /// **What it does:** Checks for getting the remainder of a division by one.
122     ///
123     /// **Why is this bad?** The result can only ever be zero. No one will write
124     /// such code deliberately, unless trying to win an Underhanded Rust
125     /// Contest. Even for that contest, it's probably a bad idea. Use something more
126     /// underhanded.
127     ///
128     /// **Known problems:** None.
129     ///
130     /// **Example:**
131     /// ```rust
132     /// # let x = 1;
133     /// let a = x % 1;
134     /// ```
135     pub MODULO_ONE,
136     correctness,
137     "taking a number modulo 1, which always returns 0"
138 }
139
140 declare_clippy_lint! {
141     /// **What it does:** Checks for the use of bindings with a single leading
142     /// underscore.
143     ///
144     /// **Why is this bad?** A single leading underscore is usually used to indicate
145     /// that a binding will not be used. Using such a binding breaks this
146     /// expectation.
147     ///
148     /// **Known problems:** The lint does not work properly with desugaring and
149     /// macro, it has been allowed in the mean time.
150     ///
151     /// **Example:**
152     /// ```rust
153     /// let _x = 0;
154     /// let y = _x + 1; // Here we are using `_x`, even though it has a leading
155     ///                 // underscore. We should rename `_x` to `x`
156     /// ```
157     pub USED_UNDERSCORE_BINDING,
158     pedantic,
159     "using a binding which is prefixed with an underscore"
160 }
161
162 declare_clippy_lint! {
163     /// **What it does:** Checks for the use of short circuit boolean conditions as
164     /// a
165     /// statement.
166     ///
167     /// **Why is this bad?** Using a short circuit boolean condition as a statement
168     /// may hide the fact that the second part is executed or not depending on the
169     /// outcome of the first part.
170     ///
171     /// **Known problems:** None.
172     ///
173     /// **Example:**
174     /// ```rust,ignore
175     /// f() && g(); // We should write `if f() { g(); }`.
176     /// ```
177     pub SHORT_CIRCUIT_STATEMENT,
178     complexity,
179     "using a short circuit boolean condition as a statement"
180 }
181
182 declare_clippy_lint! {
183     /// **What it does:** Catch casts from `0` to some pointer type
184     ///
185     /// **Why is this bad?** This generally means `null` and is better expressed as
186     /// {`std`, `core`}`::ptr::`{`null`, `null_mut`}.
187     ///
188     /// **Known problems:** None.
189     ///
190     /// **Example:**
191     ///
192     /// ```rust
193     /// let a = 0 as *const u32;
194     /// ```
195     pub ZERO_PTR,
196     style,
197     "using 0 as *{const, mut} T"
198 }
199
200 declare_clippy_lint! {
201     /// **What it does:** Checks for (in-)equality comparisons on floating-point
202     /// value and constant, except in functions called `*eq*` (which probably
203     /// implement equality for a type involving floats).
204     ///
205     /// **Why is this bad?** Floating point calculations are usually imprecise, so
206     /// asking if two values are *exactly* equal is asking for trouble. For a good
207     /// guide on what to do, see [the floating point
208     /// guide](http://www.floating-point-gui.de/errors/comparison).
209     ///
210     /// **Known problems:** None.
211     ///
212     /// **Example:**
213     /// ```rust
214     /// let x: f64 = 1.0;
215     /// const ONE: f64 = 1.00;
216     /// x == ONE;  // where both are floats
217     /// ```
218     pub FLOAT_CMP_CONST,
219     restriction,
220     "using `==` or `!=` on float constants instead of comparing difference with an epsilon"
221 }
222
223 declare_lint_pass!(MiscLints => [
224     TOPLEVEL_REF_ARG,
225     CMP_NAN,
226     FLOAT_CMP,
227     CMP_OWNED,
228     MODULO_ONE,
229     USED_UNDERSCORE_BINDING,
230     SHORT_CIRCUIT_STATEMENT,
231     ZERO_PTR,
232     FLOAT_CMP_CONST
233 ]);
234
235 impl<'a, 'tcx> LateLintPass<'a, 'tcx> for MiscLints {
236     fn check_fn(
237         &mut self,
238         cx: &LateContext<'a, 'tcx>,
239         k: FnKind<'tcx>,
240         decl: &'tcx FnDecl,
241         body: &'tcx Body,
242         _: Span,
243         _: HirId,
244     ) {
245         if let FnKind::Closure(_) = k {
246             // Does not apply to closures
247             return;
248         }
249         for arg in iter_input_pats(decl, body) {
250             match arg.pat.kind {
251                 PatKind::Binding(BindingAnnotation::Ref, ..) | PatKind::Binding(BindingAnnotation::RefMut, ..) => {
252                     span_lint(
253                         cx,
254                         TOPLEVEL_REF_ARG,
255                         arg.pat.span,
256                         "`ref` directly on a function argument is ignored. Consider using a reference type \
257                          instead.",
258                     );
259                 },
260                 _ => {},
261             }
262         }
263     }
264
265     fn check_stmt(&mut self, cx: &LateContext<'a, 'tcx>, stmt: &'tcx Stmt) {
266         if_chain! {
267             if let StmtKind::Local(ref local) = stmt.kind;
268             if let PatKind::Binding(an, .., name, None) = local.pat.kind;
269             if let Some(ref init) = local.init;
270             then {
271                 if an == BindingAnnotation::Ref || an == BindingAnnotation::RefMut {
272                     let sugg_init = if init.span.from_expansion() {
273                         Sugg::hir_with_macro_callsite(cx, init, "..")
274                     } else {
275                         Sugg::hir(cx, init, "..")
276                     };
277                     let (mutopt, initref) = if an == BindingAnnotation::RefMut {
278                         ("mut ", sugg_init.mut_addr())
279                     } else {
280                         ("", sugg_init.addr())
281                     };
282                     let tyopt = if let Some(ref ty) = local.ty {
283                         format!(": &{mutopt}{ty}", mutopt=mutopt, ty=snippet(cx, ty.span, "_"))
284                     } else {
285                         String::new()
286                     };
287                     span_lint_hir_and_then(
288                         cx,
289                         TOPLEVEL_REF_ARG,
290                         init.hir_id,
291                         local.pat.span,
292                         "`ref` on an entire `let` pattern is discouraged, take a reference with `&` instead",
293                         |db| {
294                             db.span_suggestion(
295                                 stmt.span,
296                                 "try",
297                                 format!(
298                                     "let {name}{tyopt} = {initref};",
299                                     name=snippet(cx, name.span, "_"),
300                                     tyopt=tyopt,
301                                     initref=initref,
302                                 ),
303                                 Applicability::MachineApplicable,
304                             );
305                         }
306                     );
307                 }
308             }
309         };
310         if_chain! {
311             if let StmtKind::Semi(ref expr) = stmt.kind;
312             if let ExprKind::Binary(ref binop, ref a, ref b) = expr.kind;
313             if binop.node == BinOpKind::And || binop.node == BinOpKind::Or;
314             if let Some(sugg) = Sugg::hir_opt(cx, a);
315             then {
316                 span_lint_and_then(cx,
317                     SHORT_CIRCUIT_STATEMENT,
318                     stmt.span,
319                     "boolean short circuit operator in statement may be clearer using an explicit test",
320                     |db| {
321                         let sugg = if binop.node == BinOpKind::Or { !sugg } else { sugg };
322                         db.span_suggestion(
323                             stmt.span,
324                             "replace it with",
325                             format!(
326                                 "if {} {{ {}; }}",
327                                 sugg,
328                                 &snippet(cx, b.span, ".."),
329                             ),
330                             Applicability::MachineApplicable, // snippet
331                         );
332                     });
333             }
334         };
335     }
336
337     fn check_expr(&mut self, cx: &LateContext<'a, 'tcx>, expr: &'tcx Expr) {
338         match expr.kind {
339             ExprKind::Cast(ref e, ref ty) => {
340                 check_cast(cx, expr.span, e, ty);
341                 return;
342             },
343             ExprKind::Binary(ref cmp, ref left, ref right) => {
344                 let op = cmp.node;
345                 if op.is_comparison() {
346                     if let ExprKind::Path(QPath::Resolved(_, ref path)) = left.kind {
347                         check_nan(cx, path, expr);
348                     }
349                     if let ExprKind::Path(QPath::Resolved(_, ref path)) = right.kind {
350                         check_nan(cx, path, expr);
351                     }
352                     check_to_owned(cx, left, right);
353                     check_to_owned(cx, right, left);
354                 }
355                 if (op == BinOpKind::Eq || op == BinOpKind::Ne) && (is_float(cx, left) || is_float(cx, right)) {
356                     if is_allowed(cx, left) || is_allowed(cx, right) {
357                         return;
358                     }
359
360                     // Allow comparing the results of signum()
361                     if is_signum(cx, left) && is_signum(cx, right) {
362                         return;
363                     }
364
365                     if let Some(name) = get_item_name(cx, expr) {
366                         let name = name.as_str();
367                         if name == "eq"
368                             || name == "ne"
369                             || name == "is_nan"
370                             || name.starts_with("eq_")
371                             || name.ends_with("_eq")
372                         {
373                             return;
374                         }
375                     }
376                     let (lint, msg) = if is_named_constant(cx, left) || is_named_constant(cx, right) {
377                         (FLOAT_CMP_CONST, "strict comparison of f32 or f64 constant")
378                     } else {
379                         (FLOAT_CMP, "strict comparison of f32 or f64")
380                     };
381                     span_lint_and_then(cx, lint, expr.span, msg, |db| {
382                         let lhs = Sugg::hir(cx, left, "..");
383                         let rhs = Sugg::hir(cx, right, "..");
384
385                         db.span_suggestion(
386                             expr.span,
387                             "consider comparing them within some error",
388                             format!(
389                                 "({}).abs() {} error",
390                                 lhs - rhs,
391                                 if op == BinOpKind::Eq { '<' } else { '>' }
392                             ),
393                             Applicability::HasPlaceholders, // snippet
394                         );
395                         db.span_note(expr.span, "std::f32::EPSILON and std::f64::EPSILON are available.");
396                     });
397                 } else if op == BinOpKind::Rem && is_integer_const(cx, right, 1) {
398                     span_lint(cx, MODULO_ONE, expr.span, "any number modulo 1 will be 0");
399                 }
400             },
401             _ => {},
402         }
403         if in_attributes_expansion(expr) {
404             // Don't lint things expanded by #[derive(...)], etc
405             return;
406         }
407         let binding = match expr.kind {
408             ExprKind::Path(ref qpath) => {
409                 let binding = last_path_segment(qpath).ident.as_str();
410                 if binding.starts_with('_') &&
411                     !binding.starts_with("__") &&
412                     binding != "_result" && // FIXME: #944
413                     is_used(cx, expr) &&
414                     // don't lint if the declaration is in a macro
415                     non_macro_local(cx, cx.tables.qpath_res(qpath, expr.hir_id))
416                 {
417                     Some(binding)
418                 } else {
419                     None
420                 }
421             },
422             ExprKind::Field(_, ident) => {
423                 let name = ident.as_str();
424                 if name.starts_with('_') && !name.starts_with("__") {
425                     Some(name)
426                 } else {
427                     None
428                 }
429             },
430             _ => None,
431         };
432         if let Some(binding) = binding {
433             span_lint(
434                 cx,
435                 USED_UNDERSCORE_BINDING,
436                 expr.span,
437                 &format!(
438                     "used binding `{}` which is prefixed with an underscore. A leading \
439                      underscore signals that a binding will not be used.",
440                     binding
441                 ),
442             );
443         }
444     }
445 }
446
447 fn check_nan(cx: &LateContext<'_, '_>, path: &Path, expr: &Expr) {
448     if !in_constant(cx, expr.hir_id) {
449         if let Some(seg) = path.segments.last() {
450             if seg.ident.name == sym!(NAN) {
451                 span_lint(
452                     cx,
453                     CMP_NAN,
454                     expr.span,
455                     "doomed comparison with NAN, use `std::{f32,f64}::is_nan()` instead",
456                 );
457             }
458         }
459     }
460 }
461
462 fn is_named_constant<'a, 'tcx>(cx: &LateContext<'a, 'tcx>, expr: &'tcx Expr) -> bool {
463     if let Some((_, res)) = constant(cx, cx.tables, expr) {
464         res
465     } else {
466         false
467     }
468 }
469
470 fn is_allowed<'a, 'tcx>(cx: &LateContext<'a, 'tcx>, expr: &'tcx Expr) -> bool {
471     match constant(cx, cx.tables, expr) {
472         Some((Constant::F32(f), _)) => f == 0.0 || f.is_infinite(),
473         Some((Constant::F64(f), _)) => f == 0.0 || f.is_infinite(),
474         _ => false,
475     }
476 }
477
478 // Return true if `expr` is the result of `signum()` invoked on a float value.
479 fn is_signum(cx: &LateContext<'_, '_>, expr: &Expr) -> bool {
480     // The negation of a signum is still a signum
481     if let ExprKind::Unary(UnNeg, ref child_expr) = expr.kind {
482         return is_signum(cx, &child_expr);
483     }
484
485     if_chain! {
486         if let ExprKind::MethodCall(ref method_name, _, ref expressions) = expr.kind;
487         if sym!(signum) == method_name.ident.name;
488         // Check that the receiver of the signum() is a float (expressions[0] is the receiver of
489         // the method call)
490         then {
491             return is_float(cx, &expressions[0]);
492         }
493     }
494     false
495 }
496
497 fn is_float(cx: &LateContext<'_, '_>, expr: &Expr) -> bool {
498     matches!(walk_ptrs_ty(cx.tables.expr_ty(expr)).kind, ty::Float(_))
499 }
500
501 fn check_to_owned(cx: &LateContext<'_, '_>, expr: &Expr, other: &Expr) {
502     let (arg_ty, snip) = match expr.kind {
503         ExprKind::MethodCall(.., ref args) if args.len() == 1 => {
504             if match_trait_method(cx, expr, &paths::TO_STRING) || match_trait_method(cx, expr, &paths::TO_OWNED) {
505                 (cx.tables.expr_ty_adjusted(&args[0]), snippet(cx, args[0].span, ".."))
506             } else {
507                 return;
508             }
509         },
510         ExprKind::Call(ref path, ref v) if v.len() == 1 => {
511             if let ExprKind::Path(ref path) = path.kind {
512                 if match_qpath(path, &["String", "from_str"]) || match_qpath(path, &["String", "from"]) {
513                     (cx.tables.expr_ty_adjusted(&v[0]), snippet(cx, v[0].span, ".."))
514                 } else {
515                     return;
516                 }
517             } else {
518                 return;
519             }
520         },
521         _ => return,
522     };
523
524     let other_ty = cx.tables.expr_ty_adjusted(other);
525     let partial_eq_trait_id = match cx.tcx.lang_items().eq_trait() {
526         Some(id) => id,
527         None => return,
528     };
529
530     let deref_arg_impl_partial_eq_other = arg_ty.builtin_deref(true).map_or(false, |tam| {
531         implements_trait(cx, tam.ty, partial_eq_trait_id, &[other_ty.into()])
532     });
533     let arg_impl_partial_eq_deref_other = other_ty.builtin_deref(true).map_or(false, |tam| {
534         implements_trait(cx, arg_ty, partial_eq_trait_id, &[tam.ty.into()])
535     });
536     let arg_impl_partial_eq_other = implements_trait(cx, arg_ty, partial_eq_trait_id, &[other_ty.into()]);
537
538     if !deref_arg_impl_partial_eq_other && !arg_impl_partial_eq_deref_other && !arg_impl_partial_eq_other {
539         return;
540     }
541
542     let other_gets_derefed = match other.kind {
543         ExprKind::Unary(UnDeref, _) => true,
544         _ => false,
545     };
546
547     let lint_span = if other_gets_derefed {
548         expr.span.to(other.span)
549     } else {
550         expr.span
551     };
552
553     span_lint_and_then(
554         cx,
555         CMP_OWNED,
556         lint_span,
557         "this creates an owned instance just for comparison",
558         |db| {
559             // This also catches `PartialEq` implementations that call `to_owned`.
560             if other_gets_derefed {
561                 db.span_label(lint_span, "try implementing the comparison without allocating");
562                 return;
563             }
564
565             let try_hint = if deref_arg_impl_partial_eq_other {
566                 // suggest deref on the left
567                 format!("*{}", snip)
568             } else {
569                 // suggest dropping the to_owned on the left
570                 snip.to_string()
571             };
572
573             db.span_suggestion(
574                 lint_span,
575                 "try",
576                 try_hint,
577                 Applicability::MachineApplicable, // snippet
578             );
579         },
580     );
581 }
582
583 /// Heuristic to see if an expression is used. Should be compatible with
584 /// `unused_variables`'s idea
585 /// of what it means for an expression to be "used".
586 fn is_used(cx: &LateContext<'_, '_>, expr: &Expr) -> bool {
587     if let Some(parent) = get_parent_expr(cx, expr) {
588         match parent.kind {
589             ExprKind::Assign(_, ref rhs) | ExprKind::AssignOp(_, _, ref rhs) => SpanlessEq::new(cx).eq_expr(rhs, expr),
590             _ => is_used(cx, parent),
591         }
592     } else {
593         true
594     }
595 }
596
597 /// Tests whether an expression is in a macro expansion (e.g., something
598 /// generated by `#[derive(...)]` or the like).
599 fn in_attributes_expansion(expr: &Expr) -> bool {
600     use syntax_pos::hygiene::MacroKind;
601     if expr.span.from_expansion() {
602         let data = expr.span.ctxt().outer_expn_data();
603
604         if let ExpnKind::Macro(MacroKind::Attr, _) = data.kind {
605             true
606         } else {
607             false
608         }
609     } else {
610         false
611     }
612 }
613
614 /// Tests whether `res` is a variable defined outside a macro.
615 fn non_macro_local(cx: &LateContext<'_, '_>, res: def::Res) -> bool {
616     if let def::Res::Local(id) = res {
617         !cx.tcx.hir().span(id).from_expansion()
618     } else {
619         false
620     }
621 }
622
623 fn check_cast(cx: &LateContext<'_, '_>, span: Span, e: &Expr, ty: &Ty) {
624     if_chain! {
625         if let TyKind::Ptr(ref mut_ty) = ty.kind;
626         if let ExprKind::Lit(ref lit) = e.kind;
627         if let LitKind::Int(0, _) = lit.node;
628         if !in_constant(cx, e.hir_id);
629         then {
630             let (msg, sugg_fn) = match mut_ty.mutbl {
631                 Mutability::Mutable => ("`0 as *mut _` detected", "std::ptr::null_mut"),
632                 Mutability::Immutable => ("`0 as *const _` detected", "std::ptr::null"),
633             };
634
635             let (sugg, appl) = if let TyKind::Infer = mut_ty.ty.kind {
636                 (format!("{}()", sugg_fn), Applicability::MachineApplicable)
637             } else if let Some(mut_ty_snip) = snippet_opt(cx, mut_ty.ty.span) {
638                 (format!("{}::<{}>()", sugg_fn, mut_ty_snip), Applicability::MachineApplicable)
639             } else {
640                 // `MaybeIncorrect` as type inference may not work with the suggested code
641                 (format!("{}()", sugg_fn), Applicability::MaybeIncorrect)
642             };
643             span_lint_and_sugg(cx, ZERO_PTR, span, msg, "try", sugg, appl);
644         }
645     }
646 }