//! Various extension methods to ast Expr Nodes, which are hard to code-generate. use crate::{ ast::{self, child_opt, children, AstChildren, AstNode}, SmolStr, SyntaxKind::*, SyntaxToken, T, }; #[derive(Debug, Clone, PartialEq, Eq)] pub enum ElseBranch { Block(ast::BlockExpr), IfExpr(ast::IfExpr), } impl ast::IfExpr { pub fn then_branch(&self) -> Option { self.blocks().nth(0) } pub fn else_branch(&self) -> Option { let res = match self.blocks().nth(1) { Some(block) => ElseBranch::Block(block), None => { let elif: ast::IfExpr = child_opt(self)?; ElseBranch::IfExpr(elif) } }; Some(res) } fn blocks(&self) -> AstChildren { children(self) } } impl ast::RefExpr { pub fn is_mut(&self) -> bool { self.syntax().children_with_tokens().any(|n| n.kind() == T![mut]) } } #[derive(Copy, Clone, Debug, PartialEq, Eq, Hash)] pub enum PrefixOp { /// The `*` operator for dereferencing Deref, /// The `!` operator for logical inversion Not, /// The `-` operator for negation Neg, } impl ast::PrefixExpr { pub fn op_kind(&self) -> Option { match self.op_token()?.kind() { T![*] => Some(PrefixOp::Deref), T![!] => Some(PrefixOp::Not), T![-] => Some(PrefixOp::Neg), _ => None, } } pub fn op_token(&self) -> Option { self.syntax().first_child_or_token()?.into_token() } } #[derive(Copy, Clone, Debug, PartialEq, Eq, Hash)] pub enum BinOp { /// The `||` operator for boolean OR BooleanOr, /// The `&&` operator for boolean AND BooleanAnd, /// The `==` operator for equality testing EqualityTest, /// The `!=` operator for equality testing NegatedEqualityTest, /// The `<=` operator for lesser-equal testing LesserEqualTest, /// The `>=` operator for greater-equal testing GreaterEqualTest, /// The `<` operator for comparison LesserTest, /// The `>` operator for comparison GreaterTest, /// The `+` operator for addition Addition, /// The `*` operator for multiplication Multiplication, /// The `-` operator for subtraction Subtraction, /// The `/` operator for division Division, /// The `%` operator for remainder after division Remainder, /// The `<<` operator for left shift LeftShift, /// The `>>` operator for right shift RightShift, /// The `^` operator for bitwise XOR BitwiseXor, /// The `|` operator for bitwise OR BitwiseOr, /// The `&` operator for bitwise AND BitwiseAnd, /// The `=` operator for assignment Assignment, /// The `+=` operator for assignment after addition AddAssign, /// The `/=` operator for assignment after division DivAssign, /// The `*=` operator for assignment after multiplication MulAssign, /// The `%=` operator for assignment after remainders RemAssign, /// The `>>=` operator for assignment after shifting right ShrAssign, /// The `<<=` operator for assignment after shifting left ShlAssign, /// The `-=` operator for assignment after subtraction SubAssign, /// The `|=` operator for assignment after bitwise OR BitOrAssign, /// The `&=` operator for assignment after bitwise AND BitAndAssign, /// The `^=` operator for assignment after bitwise XOR BitXorAssign, } impl ast::BinExpr { fn op_details(&self) -> Option<(SyntaxToken, BinOp)> { self.syntax().children_with_tokens().filter_map(|it| it.into_token()).find_map(|c| { let bin_op = match c.kind() { T![||] => BinOp::BooleanOr, T![&&] => BinOp::BooleanAnd, T![==] => BinOp::EqualityTest, T![!=] => BinOp::NegatedEqualityTest, T![<=] => BinOp::LesserEqualTest, T![>=] => BinOp::GreaterEqualTest, T![<] => BinOp::LesserTest, T![>] => BinOp::GreaterTest, T![+] => BinOp::Addition, T![*] => BinOp::Multiplication, T![-] => BinOp::Subtraction, T![/] => BinOp::Division, T![%] => BinOp::Remainder, T![<<] => BinOp::LeftShift, T![>>] => BinOp::RightShift, T![^] => BinOp::BitwiseXor, T![|] => BinOp::BitwiseOr, T![&] => BinOp::BitwiseAnd, T![=] => BinOp::Assignment, T![+=] => BinOp::AddAssign, T![/=] => BinOp::DivAssign, T![*=] => BinOp::MulAssign, T![%=] => BinOp::RemAssign, T![>>=] => BinOp::ShrAssign, T![<<=] => BinOp::ShlAssign, T![-=] => BinOp::SubAssign, T![|=] => BinOp::BitOrAssign, T![&=] => BinOp::BitAndAssign, T![^=] => BinOp::BitXorAssign, _ => return None, }; Some((c, bin_op)) }) } pub fn op_kind(&self) -> Option { self.op_details().map(|t| t.1) } pub fn op_token(&self) -> Option { self.op_details().map(|t| t.0) } pub fn lhs(&self) -> Option { children(self).nth(0) } pub fn rhs(&self) -> Option { children(self).nth(1) } pub fn sub_exprs(&self) -> (Option, Option) { let mut children = children(self); let first = children.next(); let second = children.next(); (first, second) } } impl ast::IndexExpr { pub fn base(&self) -> Option { children(self).nth(0) } pub fn index(&self) -> Option { children(self).nth(1) } } pub enum ArrayExprKind { Repeat { initializer: Option, repeat: Option }, ElementList(AstChildren), } impl ast::ArrayExpr { pub fn kind(&self) -> ArrayExprKind { if self.is_repeat() { ArrayExprKind::Repeat { initializer: children(self).nth(0), repeat: children(self).nth(1), } } else { ArrayExprKind::ElementList(children(self)) } } fn is_repeat(&self) -> bool { self.syntax().children_with_tokens().any(|it| it.kind() == T![;]) } } #[derive(Clone, Debug, PartialEq, Eq, Hash)] pub enum LiteralKind { String, ByteString, Char, Byte, IntNumber { suffix: Option }, FloatNumber { suffix: Option }, Bool, } impl ast::Literal { pub fn token(&self) -> SyntaxToken { self.syntax() .children_with_tokens() .find(|e| e.kind() != ATTR && !e.kind().is_trivia()) .and_then(|e| e.into_token()) .unwrap() } pub fn kind(&self) -> LiteralKind { match self.token().kind() { INT_NUMBER => { let int_suffix_list = [ "isize", "i128", "i64", "i32", "i16", "i8", "usize", "u128", "u64", "u32", "u16", "u8", ]; // The lexer treats e.g. `1f64` as an integer literal. See // https://github.com/rust-analyzer/rust-analyzer/issues/1592 // and the comments on the linked PR. let float_suffix_list = ["f32", "f64"]; let text = self.token().text().to_string(); let float_suffix = float_suffix_list .iter() .find(|&s| text.ends_with(s)) .map(|&suf| SmolStr::new(suf)); if float_suffix.is_some() { LiteralKind::FloatNumber { suffix: float_suffix } } else { let suffix = int_suffix_list .iter() .find(|&s| text.ends_with(s)) .map(|&suf| SmolStr::new(suf)); LiteralKind::IntNumber { suffix } } } FLOAT_NUMBER => { let allowed_suffix_list = ["f64", "f32"]; let text = self.token().text().to_string(); let suffix = allowed_suffix_list .iter() .find(|&s| text.ends_with(s)) .map(|&suf| SmolStr::new(suf)); LiteralKind::FloatNumber { suffix } } STRING | RAW_STRING => LiteralKind::String, T![true] | T![false] => LiteralKind::Bool, BYTE_STRING | RAW_BYTE_STRING => LiteralKind::ByteString, CHAR => LiteralKind::Char, BYTE => LiteralKind::Byte, _ => unreachable!(), } } } impl ast::BlockExpr { /// false if the block is an intrinsic part of the syntax and can't be /// replaced with arbitrary expression. /// /// ```not_rust /// fn foo() { not_stand_alone } /// const FOO: () = { stand_alone }; /// ``` pub fn is_standalone(&self) -> bool { let kind = match self.syntax().parent() { None => return true, Some(it) => it.kind(), }; match kind { FN_DEF | MATCH_ARM | IF_EXPR | WHILE_EXPR | LOOP_EXPR | TRY_BLOCK_EXPR => false, _ => true, } } } #[test] fn test_literal_with_attr() { let parse = ast::SourceFile::parse(r#"const _: &str = { #[attr] "Hello" };"#); let lit = parse.tree().syntax().descendants().find_map(ast::Literal::cast).unwrap(); assert_eq!(lit.token().text(), r#""Hello""#); } impl ast::RecordField { pub fn parent_record_lit(&self) -> ast::RecordLit { self.syntax().ancestors().find_map(ast::RecordLit::cast).unwrap() } }