// Print expression such that it can be parsed back as a statement // consisting of the original expression. // // The effect of this is for binary operators in statement position to set // `leftmost_subexpression_in_stmt` when printing their left-hand operand. // // (match x {}) - 1; // match needs parens when LHS of binary operator // // match x {}; // not when its own statement // #[cfg(feature = "full")]
stmt: bool,
// This is the difference between: // // (match x {}) - 1; // subexpression needs parens // // let _ = match x {} - 1; // no parens // // There are 3 distinguishable contexts in which `print_expr` might be // called with the expression `$match` as its argument, where `$match` // represents an expression of kind `ExprKind::Match`: // // - stmt=false leftmost_subexpression_in_stmt=false // // Example: `let _ = $match - 1;` // // No parentheses required. // // - stmt=false leftmost_subexpression_in_stmt=true // // Example: `$match - 1;` // // Must parenthesize `($match)`, otherwise parsing back the output as a // statement would terminate the statement after the closing brace of // the match, parsing `-1;` as a separate statement. // // - stmt=true leftmost_subexpression_in_stmt=false // // Example: `$match;` // // No parentheses required. #[cfg(feature = "full")]
leftmost_subexpression_in_stmt: bool,
// Print expression such that it can be parsed as a match arm. // // This is almost equivalent to `stmt`, but the grammar diverges a tiny bit // between statements and match arms when it comes to braced macro calls. // Macro calls with brace delimiter terminate a statement without a // semicolon, but do not terminate a match-arm without comma. // // m! {} - 1; // two statements: a macro call followed by -1 literal // // match () { // _ => m! {} - 1, // binary subtraction operator // } // #[cfg(feature = "full")]
match_arm: bool,
// This is almost equivalent to `leftmost_subexpression_in_stmt`, other than // for braced macro calls. // // If we have `m! {} - 1` as an expression, the leftmost subexpression // `m! {}` will need to be parenthesized in the statement case but not the // match-arm case. // // (m! {}) - 1; // subexpression needs parens // // match () { // _ => m! {} - 1, // no parens // } // #[cfg(feature = "full")]
leftmost_subexpression_in_match_arm: bool,
// This is the difference between: // // if let _ = (Struct {}) {} // needs parens // // match () { // () if let _ = Struct {} => {} // no parens // } // #[cfg(feature = "full")]
condition: bool,
// This is the difference between: // // if break Struct {} == (break) {} // needs parens // // if break break == Struct {} {} // no parens // #[cfg(feature = "full")]
rightmost_subexpression_in_condition: bool,
// This is the difference between: // // if break ({ x }).field + 1 {} needs parens // // if break 1 + { x }.field {} // no parens // #[cfg(feature = "full")]
leftmost_subexpression_in_optional_operand: bool,
// This is the difference between: // // let _ = (return) - 1; // without paren, this would return -1 // // let _ = return + 1; // no paren because '+' cannot begin expr // #[cfg(feature = "full")]
next_operator_can_begin_expr: bool,
// This is the difference between: // // let _ = 1 + return 1; // no parens if rightmost subexpression // // let _ = 1 + (return 1) + 1; // needs parens // #[cfg(feature = "full")]
next_operator_can_continue_expr: bool,
// This is the difference between: // // let _ = x as u8 + T; // // let _ = (x as u8) < T; // // Without parens, the latter would want to parse `u8<T...` as a type.
next_operator_can_begin_generics: bool,
}
impl FixupContext { /// The default amount of fixing is minimal fixing. Fixups should be turned /// on in a targeted fashion where needed. pubconst NONE: Self = FixupContext { #[cfg(feature = "full")]
previous_operator: Precedence::MIN, #[cfg(feature = "full")]
next_operator: Precedence::MIN, #[cfg(feature = "full")]
stmt: false, #[cfg(feature = "full")]
leftmost_subexpression_in_stmt: false, #[cfg(feature = "full")]
match_arm: false, #[cfg(feature = "full")]
leftmost_subexpression_in_match_arm: false, #[cfg(feature = "full")]
condition: false, #[cfg(feature = "full")]
rightmost_subexpression_in_condition: false, #[cfg(feature = "full")]
leftmost_subexpression_in_optional_operand: false, #[cfg(feature = "full")]
next_operator_can_begin_expr: false, #[cfg(feature = "full")]
next_operator_can_continue_expr: false,
next_operator_can_begin_generics: false,
};
/// Create the initial fixup for printing an expression in statement /// position. #[cfg(feature = "full")] pubfn new_stmt() -> Self {
FixupContext {
stmt: true,
..FixupContext::NONE
}
}
/// Create the initial fixup for printing an expression as the right-hand /// side of a match arm. #[cfg(feature = "full")] pubfn new_match_arm() -> Self {
FixupContext {
match_arm: true,
..FixupContext::NONE
}
}
/// Create the initial fixup for printing an expression as the "condition" /// of an `if` or `while`. There are a few other positions which are /// grammatically equivalent and also use this, such as the iterator /// expression in `for` and the scrutinee in `match`. #[cfg(feature = "full")] pubfn new_condition() -> Self {
FixupContext {
condition: true,
rightmost_subexpression_in_condition: true,
..FixupContext::NONE
}
}
/// Transform this fixup into the one that should apply when printing the /// leftmost subexpression of the current expression. /// /// The leftmost subexpression is any subexpression that has the same first /// token as the current expression, but has a different last token. /// /// For example in `$a + $b` and `$a.method()`, the subexpression `$a` is a /// leftmost subexpression. /// /// Not every expression has a leftmost subexpression. For example neither /// `-$a` nor `[$a]` have one. pubfn leftmost_subexpression_with_operator( self,
expr: &Expr, #[cfg(feature = "full")] next_operator_can_begin_expr: bool,
next_operator_can_begin_generics: bool, #[cfg(feature = "full")] precedence: Precedence,
) -> (Precedence, Self) { let fixup = FixupContext { #[cfg(feature = "full")]
next_operator: precedence, #[cfg(feature = "full")]
stmt: false, #[cfg(feature = "full")]
leftmost_subexpression_in_stmt: self.stmt || self.leftmost_subexpression_in_stmt, #[cfg(feature = "full")]
match_arm: false, #[cfg(feature = "full")]
leftmost_subexpression_in_match_arm: self.match_arm
|| self.leftmost_subexpression_in_match_arm, #[cfg(feature = "full")]
rightmost_subexpression_in_condition: false, #[cfg(feature = "full")]
next_operator_can_begin_expr, #[cfg(feature = "full")]
next_operator_can_continue_expr: true,
next_operator_can_begin_generics,
..self
};
/// Transform this fixup into the one that should apply when printing the /// rightmost subexpression of the current expression. /// /// The rightmost subexpression is any subexpression that has a different /// first token than the current expression, but has the same last token. /// /// For example in `$a + $b` and `-$b`, the subexpression `$b` is a /// rightmost subexpression. /// /// Not every expression has a rightmost subexpression. For example neither /// `[$b]` nor `$a.f($b)` have one. pubfn rightmost_subexpression( self,
expr: &Expr, #[cfg(feature = "full")] precedence: Precedence,
) -> (Precedence, Self) { let fixup = self.rightmost_subexpression_fixup( #[cfg(feature = "full")] false, #[cfg(feature = "full")] false, #[cfg(feature = "full")]
precedence,
);
(fixup.rightmost_subexpression_precedence(expr), fixup)
}
/// Determine whether parentheses are needed around the given expression to /// head off the early termination of a statement or condition. #[cfg(feature = "full")] pubfn parenthesize(self, expr: &Expr) -> bool {
(self.leftmost_subexpression_in_stmt && !classify::requires_semi_to_be_stmt(expr))
|| ((self.stmt || self.leftmost_subexpression_in_stmt) && matches!(expr, Expr::Let(_)))
|| (self.leftmost_subexpression_in_match_arm
&& !classify::requires_comma_to_be_match_arm(expr))
|| (self.condition && matches!(expr, Expr::Struct(_)))
|| (self.rightmost_subexpression_in_condition
&& matches!(
expr,
Expr::Return(ExprReturn { expr: None, .. })
| Expr::Yield(ExprYield { expr: None, .. })
))
|| (self.rightmost_subexpression_in_condition
&& !self.condition
&& matches!(
expr,
Expr::Break(ExprBreak { expr: None, .. })
| Expr::Path(_)
| Expr::Range(ExprRange { end: None, .. })
))
|| (self.leftmost_subexpression_in_optional_operand
&& matches!(expr, Expr::Block(expr) if expr.attrs.is_empty() && expr.label.is_none()))
}
/// Determines the effective precedence of a subexpression. Some expressions /// have higher or lower precedence when adjacent to particular operators. fn precedence(self, expr: &Expr) -> Precedence { #[cfg(feature = "full")] ifself.next_operator_can_begin_expr { // Decrease precedence of value-less jumps when followed by an // operator that would otherwise get interpreted as beginning a // value for the jump. iflet Expr::Break(ExprBreak { expr: None, .. })
| Expr::Return(ExprReturn { expr: None, .. })
| Expr::Yield(ExprYield { expr: None, .. }) = expr
{ return Precedence::Jump;
}
}
#[cfg(feature = "full")] if !self.next_operator_can_continue_expr { match expr { // Increase precedence of expressions that extend to the end of // current statement or group.
Expr::Break(_)
| Expr::Closure(_)
| Expr::Let(_)
| Expr::Return(_)
| Expr::Yield(_) => { return Precedence::Prefix;
}
Expr::Range(e) if e.start.is_none() => return Precedence::Prefix,
_ => {}
}
}
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.