1 // Copyright 2012 The Rust Project Developers. See the COPYRIGHT
2 // file at the top-level directory of this distribution and at
3 // http://rust-lang.org/COPYRIGHT.
5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
8 // option. This file may not be copied, modified, or distributed
9 // except according to those terms.
12 use ast::{self, Ident, Generics, Expr, BlockCheckMode, UnOp, PatKind};
14 use syntax_pos::{Pos, Span, DUMMY_SP};
15 use codemap::{dummy_spanned, respan, Spanned};
16 use ext::base::ExtCtxt;
18 use symbol::{Symbol, keywords};
20 // Transitional re-exports so qquote can find the paths it is looking for
26 pub trait AstBuilder {
28 fn path(&self, span: Span, strs: Vec<ast::Ident> ) -> ast::Path;
29 fn path_ident(&self, span: Span, id: ast::Ident) -> ast::Path;
30 fn path_global(&self, span: Span, strs: Vec<ast::Ident> ) -> ast::Path;
31 fn path_all(&self, sp: Span,
33 idents: Vec<ast::Ident> ,
34 lifetimes: Vec<ast::Lifetime>,
35 types: Vec<P<ast::Ty>>,
36 bindings: Vec<ast::TypeBinding> )
39 fn qpath(&self, self_type: P<ast::Ty>,
40 trait_path: ast::Path,
41 ident: ast::SpannedIdent)
42 -> (ast::QSelf, ast::Path);
43 fn qpath_all(&self, self_type: P<ast::Ty>,
44 trait_path: ast::Path,
45 ident: ast::SpannedIdent,
46 lifetimes: Vec<ast::Lifetime>,
47 types: Vec<P<ast::Ty>>,
48 bindings: Vec<ast::TypeBinding>)
49 -> (ast::QSelf, ast::Path);
52 fn ty_mt(&self, ty: P<ast::Ty>, mutbl: ast::Mutability) -> ast::MutTy;
54 fn ty(&self, span: Span, ty: ast::TyKind) -> P<ast::Ty>;
55 fn ty_path(&self, path: ast::Path) -> P<ast::Ty>;
56 fn ty_ident(&self, span: Span, idents: ast::Ident) -> P<ast::Ty>;
58 fn ty_rptr(&self, span: Span,
60 lifetime: Option<ast::Lifetime>,
61 mutbl: ast::Mutability) -> P<ast::Ty>;
62 fn ty_ptr(&self, span: Span,
64 mutbl: ast::Mutability) -> P<ast::Ty>;
66 fn ty_option(&self, ty: P<ast::Ty>) -> P<ast::Ty>;
67 fn ty_infer(&self, sp: Span) -> P<ast::Ty>;
72 attrs: Vec<ast::Attribute>,
73 bounds: ast::TyParamBounds,
74 default: Option<P<ast::Ty>>) -> ast::TyParam;
76 fn trait_ref(&self, path: ast::Path) -> ast::TraitRef;
77 fn poly_trait_ref(&self, span: Span, path: ast::Path) -> ast::PolyTraitRef;
78 fn typarambound(&self, path: ast::Path) -> ast::TyParamBound;
79 fn lifetime(&self, span: Span, ident: ast::Ident) -> ast::Lifetime;
80 fn lifetime_def(&self,
83 attrs: Vec<ast::Attribute>,
84 bounds: Vec<ast::Lifetime>)
88 fn stmt_expr(&self, expr: P<ast::Expr>) -> ast::Stmt;
89 fn stmt_semi(&self, expr: P<ast::Expr>) -> ast::Stmt;
90 fn stmt_let(&self, sp: Span, mutbl: bool, ident: ast::Ident, ex: P<ast::Expr>) -> ast::Stmt;
91 fn stmt_let_typed(&self,
98 fn stmt_let_type_only(&self, span: Span, ty: P<ast::Ty>) -> ast::Stmt;
99 fn stmt_item(&self, sp: Span, item: P<ast::Item>) -> ast::Stmt;
102 fn block(&self, span: Span, stmts: Vec<ast::Stmt>) -> P<ast::Block>;
103 fn block_expr(&self, expr: P<ast::Expr>) -> P<ast::Block>;
106 fn expr(&self, span: Span, node: ast::ExprKind) -> P<ast::Expr>;
107 fn expr_path(&self, path: ast::Path) -> P<ast::Expr>;
108 fn expr_qpath(&self, span: Span, qself: ast::QSelf, path: ast::Path) -> P<ast::Expr>;
109 fn expr_ident(&self, span: Span, id: ast::Ident) -> P<ast::Expr>;
111 fn expr_self(&self, span: Span) -> P<ast::Expr>;
112 fn expr_binary(&self, sp: Span, op: ast::BinOpKind,
113 lhs: P<ast::Expr>, rhs: P<ast::Expr>) -> P<ast::Expr>;
114 fn expr_deref(&self, sp: Span, e: P<ast::Expr>) -> P<ast::Expr>;
115 fn expr_unary(&self, sp: Span, op: ast::UnOp, e: P<ast::Expr>) -> P<ast::Expr>;
117 fn expr_addr_of(&self, sp: Span, e: P<ast::Expr>) -> P<ast::Expr>;
118 fn expr_mut_addr_of(&self, sp: Span, e: P<ast::Expr>) -> P<ast::Expr>;
119 fn expr_field_access(&self, span: Span, expr: P<ast::Expr>, ident: ast::Ident) -> P<ast::Expr>;
120 fn expr_tup_field_access(&self, sp: Span, expr: P<ast::Expr>,
121 idx: usize) -> P<ast::Expr>;
122 fn expr_call(&self, span: Span, expr: P<ast::Expr>, args: Vec<P<ast::Expr>>) -> P<ast::Expr>;
123 fn expr_call_ident(&self, span: Span, id: ast::Ident, args: Vec<P<ast::Expr>>) -> P<ast::Expr>;
124 fn expr_call_global(&self, sp: Span, fn_path: Vec<ast::Ident>,
125 args: Vec<P<ast::Expr>> ) -> P<ast::Expr>;
126 fn expr_method_call(&self, span: Span,
127 expr: P<ast::Expr>, ident: ast::Ident,
128 args: Vec<P<ast::Expr>> ) -> P<ast::Expr>;
129 fn expr_block(&self, b: P<ast::Block>) -> P<ast::Expr>;
130 fn expr_cast(&self, sp: Span, expr: P<ast::Expr>, ty: P<ast::Ty>) -> P<ast::Expr>;
132 fn field_imm(&self, span: Span, name: Ident, e: P<ast::Expr>) -> ast::Field;
133 fn expr_struct(&self, span: Span, path: ast::Path, fields: Vec<ast::Field>) -> P<ast::Expr>;
134 fn expr_struct_ident(&self, span: Span, id: ast::Ident,
135 fields: Vec<ast::Field>) -> P<ast::Expr>;
137 fn expr_lit(&self, sp: Span, lit: ast::LitKind) -> P<ast::Expr>;
139 fn expr_usize(&self, span: Span, i: usize) -> P<ast::Expr>;
140 fn expr_isize(&self, sp: Span, i: isize) -> P<ast::Expr>;
141 fn expr_u8(&self, sp: Span, u: u8) -> P<ast::Expr>;
142 fn expr_u32(&self, sp: Span, u: u32) -> P<ast::Expr>;
143 fn expr_bool(&self, sp: Span, value: bool) -> P<ast::Expr>;
145 fn expr_vec(&self, sp: Span, exprs: Vec<P<ast::Expr>>) -> P<ast::Expr>;
146 fn expr_vec_ng(&self, sp: Span) -> P<ast::Expr>;
147 fn expr_vec_slice(&self, sp: Span, exprs: Vec<P<ast::Expr>>) -> P<ast::Expr>;
148 fn expr_str(&self, sp: Span, s: Symbol) -> P<ast::Expr>;
150 fn expr_some(&self, sp: Span, expr: P<ast::Expr>) -> P<ast::Expr>;
151 fn expr_none(&self, sp: Span) -> P<ast::Expr>;
153 fn expr_break(&self, sp: Span) -> P<ast::Expr>;
155 fn expr_tuple(&self, sp: Span, exprs: Vec<P<ast::Expr>>) -> P<ast::Expr>;
157 fn expr_fail(&self, span: Span, msg: Symbol) -> P<ast::Expr>;
158 fn expr_unreachable(&self, span: Span) -> P<ast::Expr>;
160 fn expr_ok(&self, span: Span, expr: P<ast::Expr>) -> P<ast::Expr>;
161 fn expr_err(&self, span: Span, expr: P<ast::Expr>) -> P<ast::Expr>;
162 fn expr_try(&self, span: Span, head: P<ast::Expr>) -> P<ast::Expr>;
164 fn pat(&self, span: Span, pat: PatKind) -> P<ast::Pat>;
165 fn pat_wild(&self, span: Span) -> P<ast::Pat>;
166 fn pat_lit(&self, span: Span, expr: P<ast::Expr>) -> P<ast::Pat>;
167 fn pat_ident(&self, span: Span, ident: ast::Ident) -> P<ast::Pat>;
169 fn pat_ident_binding_mode(&self,
172 bm: ast::BindingMode) -> P<ast::Pat>;
173 fn pat_path(&self, span: Span, path: ast::Path) -> P<ast::Pat>;
174 fn pat_tuple_struct(&self, span: Span, path: ast::Path,
175 subpats: Vec<P<ast::Pat>>) -> P<ast::Pat>;
176 fn pat_struct(&self, span: Span, path: ast::Path,
177 field_pats: Vec<Spanned<ast::FieldPat>>) -> P<ast::Pat>;
178 fn pat_tuple(&self, span: Span, pats: Vec<P<ast::Pat>>) -> P<ast::Pat>;
180 fn pat_some(&self, span: Span, pat: P<ast::Pat>) -> P<ast::Pat>;
181 fn pat_none(&self, span: Span) -> P<ast::Pat>;
183 fn pat_ok(&self, span: Span, pat: P<ast::Pat>) -> P<ast::Pat>;
184 fn pat_err(&self, span: Span, pat: P<ast::Pat>) -> P<ast::Pat>;
186 fn arm(&self, span: Span, pats: Vec<P<ast::Pat>>, expr: P<ast::Expr>) -> ast::Arm;
187 fn arm_unreachable(&self, span: Span) -> ast::Arm;
189 fn expr_match(&self, span: Span, arg: P<ast::Expr>, arms: Vec<ast::Arm> ) -> P<ast::Expr>;
190 fn expr_if(&self, span: Span,
191 cond: P<ast::Expr>, then: P<ast::Expr>, els: Option<P<ast::Expr>>) -> P<ast::Expr>;
192 fn expr_loop(&self, span: Span, block: P<ast::Block>) -> P<ast::Expr>;
194 fn lambda_fn_decl(&self,
196 fn_decl: P<ast::FnDecl>,
201 fn lambda(&self, span: Span, ids: Vec<ast::Ident>, body: P<ast::Expr>) -> P<ast::Expr>;
202 fn lambda0(&self, span: Span, body: P<ast::Expr>) -> P<ast::Expr>;
203 fn lambda1(&self, span: Span, body: P<ast::Expr>, ident: ast::Ident) -> P<ast::Expr>;
205 fn lambda_stmts(&self, span: Span, ids: Vec<ast::Ident>,
206 blk: Vec<ast::Stmt>) -> P<ast::Expr>;
207 fn lambda_stmts_0(&self, span: Span, stmts: Vec<ast::Stmt>) -> P<ast::Expr>;
208 fn lambda_stmts_1(&self, span: Span, stmts: Vec<ast::Stmt>,
209 ident: ast::Ident) -> P<ast::Expr>;
212 fn item(&self, span: Span,
213 name: Ident, attrs: Vec<ast::Attribute> , node: ast::ItemKind) -> P<ast::Item>;
215 fn arg(&self, span: Span, name: Ident, ty: P<ast::Ty>) -> ast::Arg;
217 fn fn_decl(&self, inputs: Vec<ast::Arg> , output: P<ast::Ty>) -> P<ast::FnDecl>;
219 fn item_fn_poly(&self,
222 inputs: Vec<ast::Arg> ,
225 body: P<ast::Block>) -> P<ast::Item>;
229 inputs: Vec<ast::Arg> ,
231 body: P<ast::Block>) -> P<ast::Item>;
233 fn variant(&self, span: Span, name: Ident, tys: Vec<P<ast::Ty>> ) -> ast::Variant;
234 fn item_enum_poly(&self,
237 enum_definition: ast::EnumDef,
238 generics: Generics) -> P<ast::Item>;
239 fn item_enum(&self, span: Span, name: Ident, enum_def: ast::EnumDef) -> P<ast::Item>;
241 fn item_struct_poly(&self,
244 struct_def: ast::VariantData,
245 generics: Generics) -> P<ast::Item>;
246 fn item_struct(&self, span: Span, name: Ident, struct_def: ast::VariantData) -> P<ast::Item>;
248 fn item_mod(&self, span: Span, inner_span: Span,
249 name: Ident, attrs: Vec<ast::Attribute>,
250 items: Vec<P<ast::Item>>) -> P<ast::Item>;
252 fn item_extern_crate(&self, span: Span, name: Ident) -> P<ast::Item>;
254 fn item_static(&self,
258 mutbl: ast::Mutability,
269 fn item_ty_poly(&self,
273 generics: Generics) -> P<ast::Item>;
274 fn item_ty(&self, span: Span, name: Ident, ty: P<ast::Ty>) -> P<ast::Item>;
276 fn attribute(&self, sp: Span, mi: ast::MetaItem) -> ast::Attribute;
278 fn meta_word(&self, sp: Span, w: ast::Name) -> ast::MetaItem;
280 fn meta_list_item_word(&self, sp: Span, w: ast::Name) -> ast::NestedMetaItem;
285 mis: Vec<ast::NestedMetaItem> )
287 fn meta_name_value(&self,
293 fn item_use(&self, sp: Span,
294 vis: ast::Visibility, vp: P<ast::UseTree>) -> P<ast::Item>;
295 fn item_use_simple(&self, sp: Span, vis: ast::Visibility, path: ast::Path) -> P<ast::Item>;
296 fn item_use_simple_(&self, sp: Span, vis: ast::Visibility,
297 ident: ast::Ident, path: ast::Path) -> P<ast::Item>;
298 fn item_use_list(&self, sp: Span, vis: ast::Visibility,
299 path: Vec<ast::Ident>, imports: &[ast::Ident]) -> P<ast::Item>;
300 fn item_use_glob(&self, sp: Span,
301 vis: ast::Visibility, path: Vec<ast::Ident>) -> P<ast::Item>;
304 impl<'a> AstBuilder for ExtCtxt<'a> {
305 fn path(&self, span: Span, strs: Vec<ast::Ident> ) -> ast::Path {
306 self.path_all(span, false, strs, Vec::new(), Vec::new(), Vec::new())
308 fn path_ident(&self, span: Span, id: ast::Ident) -> ast::Path {
309 self.path(span, vec![id])
311 fn path_global(&self, span: Span, strs: Vec<ast::Ident> ) -> ast::Path {
312 self.path_all(span, true, strs, Vec::new(), Vec::new(), Vec::new())
317 mut idents: Vec<ast::Ident> ,
318 lifetimes: Vec<ast::Lifetime>,
319 types: Vec<P<ast::Ty>>,
320 bindings: Vec<ast::TypeBinding> )
322 use syntax::parse::token;
324 let last_identifier = idents.pop().unwrap();
325 let mut segments: Vec<ast::PathSegment> = Vec::new();
327 !idents.first().map_or(false, |&ident| token::Ident(ident).is_path_segment_keyword()) {
328 segments.push(ast::PathSegment::crate_root(span));
331 segments.extend(idents.into_iter().map(|i| ast::PathSegment::from_ident(i, span)));
332 let parameters = if !lifetimes.is_empty() || !types.is_empty() || !bindings.is_empty() {
333 ast::AngleBracketedParameterData { lifetimes, types, bindings, span }.into()
337 segments.push(ast::PathSegment { identifier: last_identifier, span, parameters });
338 ast::Path { span, segments }
341 /// Constructs a qualified path.
343 /// Constructs a path like `<self_type as trait_path>::ident`.
345 self_type: P<ast::Ty>,
346 trait_path: ast::Path,
347 ident: ast::SpannedIdent)
348 -> (ast::QSelf, ast::Path) {
349 self.qpath_all(self_type, trait_path, ident, vec![], vec![], vec![])
352 /// Constructs a qualified path.
354 /// Constructs a path like `<self_type as trait_path>::ident<'a, T, A=Bar>`.
356 self_type: P<ast::Ty>,
357 trait_path: ast::Path,
358 ident: ast::SpannedIdent,
359 lifetimes: Vec<ast::Lifetime>,
360 types: Vec<P<ast::Ty>>,
361 bindings: Vec<ast::TypeBinding>)
362 -> (ast::QSelf, ast::Path) {
363 let mut path = trait_path;
364 let parameters = if !lifetimes.is_empty() || !types.is_empty() || !bindings.is_empty() {
365 ast::AngleBracketedParameterData { lifetimes, types, bindings, span: ident.span }.into()
369 path.segments.push(ast::PathSegment {
370 identifier: ident.node,
377 position: path.segments.len() - 1
381 fn ty_mt(&self, ty: P<ast::Ty>, mutbl: ast::Mutability) -> ast::MutTy {
388 fn ty(&self, span: Span, ty: ast::TyKind) -> P<ast::Ty> {
390 id: ast::DUMMY_NODE_ID,
396 fn ty_path(&self, path: ast::Path) -> P<ast::Ty> {
397 self.ty(path.span, ast::TyKind::Path(None, path))
400 // Might need to take bounds as an argument in the future, if you ever want
401 // to generate a bounded existential trait type.
402 fn ty_ident(&self, span: Span, ident: ast::Ident)
404 self.ty_path(self.path_ident(span, ident))
410 lifetime: Option<ast::Lifetime>,
411 mutbl: ast::Mutability)
414 ast::TyKind::Rptr(lifetime, self.ty_mt(ty, mutbl)))
420 mutbl: ast::Mutability)
423 ast::TyKind::Ptr(self.ty_mt(ty, mutbl)))
426 fn ty_option(&self, ty: P<ast::Ty>) -> P<ast::Ty> {
428 self.path_all(DUMMY_SP,
430 self.std_path(&["option", "Option"]),
436 fn ty_infer(&self, span: Span) -> P<ast::Ty> {
437 self.ty(span, ast::TyKind::Infer)
443 attrs: Vec<ast::Attribute>,
444 bounds: ast::TyParamBounds,
445 default: Option<P<ast::Ty>>) -> ast::TyParam {
448 id: ast::DUMMY_NODE_ID,
456 fn trait_ref(&self, path: ast::Path) -> ast::TraitRef {
459 ref_id: ast::DUMMY_NODE_ID,
463 fn poly_trait_ref(&self, span: Span, path: ast::Path) -> ast::PolyTraitRef {
465 bound_generic_params: Vec::new(),
466 trait_ref: self.trait_ref(path),
471 fn typarambound(&self, path: ast::Path) -> ast::TyParamBound {
472 ast::TraitTyParamBound(self.poly_trait_ref(path.span, path), ast::TraitBoundModifier::None)
475 fn lifetime(&self, span: Span, ident: ast::Ident) -> ast::Lifetime {
476 ast::Lifetime { id: ast::DUMMY_NODE_ID, span: span, ident: ident }
479 fn lifetime_def(&self,
482 attrs: Vec<ast::Attribute>,
483 bounds: Vec<ast::Lifetime>)
484 -> ast::LifetimeDef {
487 lifetime: self.lifetime(span, ident),
492 fn stmt_expr(&self, expr: P<ast::Expr>) -> ast::Stmt {
494 id: ast::DUMMY_NODE_ID,
496 node: ast::StmtKind::Expr(expr),
500 fn stmt_semi(&self, expr: P<ast::Expr>) -> ast::Stmt {
502 id: ast::DUMMY_NODE_ID,
504 node: ast::StmtKind::Semi(expr),
508 fn stmt_let(&self, sp: Span, mutbl: bool, ident: ast::Ident,
509 ex: P<ast::Expr>) -> ast::Stmt {
511 let binding_mode = ast::BindingMode::ByValue(ast::Mutability::Mutable);
512 self.pat_ident_binding_mode(sp, ident, binding_mode)
514 self.pat_ident(sp, ident)
516 let local = P(ast::Local {
520 id: ast::DUMMY_NODE_ID,
522 attrs: ast::ThinVec::new(),
525 id: ast::DUMMY_NODE_ID,
526 node: ast::StmtKind::Local(local),
531 fn stmt_let_typed(&self,
539 let binding_mode = ast::BindingMode::ByValue(ast::Mutability::Mutable);
540 self.pat_ident_binding_mode(sp, ident, binding_mode)
542 self.pat_ident(sp, ident)
544 let local = P(ast::Local {
548 id: ast::DUMMY_NODE_ID,
550 attrs: ast::ThinVec::new(),
553 id: ast::DUMMY_NODE_ID,
554 node: ast::StmtKind::Local(local),
559 // Generate `let _: Type;`, usually used for type assertions.
560 fn stmt_let_type_only(&self, span: Span, ty: P<ast::Ty>) -> ast::Stmt {
561 let local = P(ast::Local {
562 pat: self.pat_wild(span),
565 id: ast::DUMMY_NODE_ID,
567 attrs: ast::ThinVec::new(),
570 id: ast::DUMMY_NODE_ID,
571 node: ast::StmtKind::Local(local),
576 fn stmt_item(&self, sp: Span, item: P<ast::Item>) -> ast::Stmt {
578 id: ast::DUMMY_NODE_ID,
579 node: ast::StmtKind::Item(item),
584 fn block_expr(&self, expr: P<ast::Expr>) -> P<ast::Block> {
585 self.block(expr.span, vec![ast::Stmt {
586 id: ast::DUMMY_NODE_ID,
588 node: ast::StmtKind::Expr(expr),
591 fn block(&self, span: Span, stmts: Vec<ast::Stmt>) -> P<ast::Block> {
594 id: ast::DUMMY_NODE_ID,
595 rules: BlockCheckMode::Default,
601 fn expr(&self, span: Span, node: ast::ExprKind) -> P<ast::Expr> {
603 id: ast::DUMMY_NODE_ID,
606 attrs: ast::ThinVec::new(),
610 fn expr_path(&self, path: ast::Path) -> P<ast::Expr> {
611 self.expr(path.span, ast::ExprKind::Path(None, path))
614 /// Constructs a QPath expression.
615 fn expr_qpath(&self, span: Span, qself: ast::QSelf, path: ast::Path) -> P<ast::Expr> {
616 self.expr(span, ast::ExprKind::Path(Some(qself), path))
619 fn expr_ident(&self, span: Span, id: ast::Ident) -> P<ast::Expr> {
620 self.expr_path(self.path_ident(span, id))
622 fn expr_self(&self, span: Span) -> P<ast::Expr> {
623 self.expr_ident(span, keywords::SelfValue.ident())
626 fn expr_binary(&self, sp: Span, op: ast::BinOpKind,
627 lhs: P<ast::Expr>, rhs: P<ast::Expr>) -> P<ast::Expr> {
628 self.expr(sp, ast::ExprKind::Binary(Spanned { node: op, span: sp }, lhs, rhs))
631 fn expr_deref(&self, sp: Span, e: P<ast::Expr>) -> P<ast::Expr> {
632 self.expr_unary(sp, UnOp::Deref, e)
634 fn expr_unary(&self, sp: Span, op: ast::UnOp, e: P<ast::Expr>) -> P<ast::Expr> {
635 self.expr(sp, ast::ExprKind::Unary(op, e))
638 fn expr_field_access(&self, sp: Span, expr: P<ast::Expr>, ident: ast::Ident) -> P<ast::Expr> {
639 let id = Spanned { node: ident, span: sp };
640 self.expr(sp, ast::ExprKind::Field(expr, id))
642 fn expr_tup_field_access(&self, sp: Span, expr: P<ast::Expr>, idx: usize) -> P<ast::Expr> {
643 let id = Spanned { node: idx, span: sp };
644 self.expr(sp, ast::ExprKind::TupField(expr, id))
646 fn expr_addr_of(&self, sp: Span, e: P<ast::Expr>) -> P<ast::Expr> {
647 self.expr(sp, ast::ExprKind::AddrOf(ast::Mutability::Immutable, e))
649 fn expr_mut_addr_of(&self, sp: Span, e: P<ast::Expr>) -> P<ast::Expr> {
650 self.expr(sp, ast::ExprKind::AddrOf(ast::Mutability::Mutable, e))
653 fn expr_call(&self, span: Span, expr: P<ast::Expr>, args: Vec<P<ast::Expr>>) -> P<ast::Expr> {
654 self.expr(span, ast::ExprKind::Call(expr, args))
656 fn expr_call_ident(&self, span: Span, id: ast::Ident,
657 args: Vec<P<ast::Expr>>) -> P<ast::Expr> {
658 self.expr(span, ast::ExprKind::Call(self.expr_ident(span, id), args))
660 fn expr_call_global(&self, sp: Span, fn_path: Vec<ast::Ident> ,
661 args: Vec<P<ast::Expr>> ) -> P<ast::Expr> {
662 let pathexpr = self.expr_path(self.path_global(sp, fn_path));
663 self.expr_call(sp, pathexpr, args)
665 fn expr_method_call(&self, span: Span,
668 mut args: Vec<P<ast::Expr>> ) -> P<ast::Expr> {
669 args.insert(0, expr);
670 self.expr(span, ast::ExprKind::MethodCall(ast::PathSegment::from_ident(ident, span), args))
672 fn expr_block(&self, b: P<ast::Block>) -> P<ast::Expr> {
673 self.expr(b.span, ast::ExprKind::Block(b))
675 fn field_imm(&self, span: Span, name: Ident, e: P<ast::Expr>) -> ast::Field {
677 ident: respan(span, name),
681 attrs: ast::ThinVec::new(),
684 fn expr_struct(&self, span: Span, path: ast::Path, fields: Vec<ast::Field>) -> P<ast::Expr> {
685 self.expr(span, ast::ExprKind::Struct(path, fields, None))
687 fn expr_struct_ident(&self, span: Span,
688 id: ast::Ident, fields: Vec<ast::Field>) -> P<ast::Expr> {
689 self.expr_struct(span, self.path_ident(span, id), fields)
692 fn expr_lit(&self, sp: Span, lit: ast::LitKind) -> P<ast::Expr> {
693 self.expr(sp, ast::ExprKind::Lit(P(respan(sp, lit))))
695 fn expr_usize(&self, span: Span, i: usize) -> P<ast::Expr> {
696 self.expr_lit(span, ast::LitKind::Int(i as u128,
697 ast::LitIntType::Unsigned(ast::UintTy::Usize)))
699 fn expr_isize(&self, sp: Span, i: isize) -> P<ast::Expr> {
701 let i = (-i) as u128;
702 let lit_ty = ast::LitIntType::Signed(ast::IntTy::Isize);
703 let lit = self.expr_lit(sp, ast::LitKind::Int(i, lit_ty));
704 self.expr_unary(sp, ast::UnOp::Neg, lit)
706 self.expr_lit(sp, ast::LitKind::Int(i as u128,
707 ast::LitIntType::Signed(ast::IntTy::Isize)))
710 fn expr_u32(&self, sp: Span, u: u32) -> P<ast::Expr> {
711 self.expr_lit(sp, ast::LitKind::Int(u as u128,
712 ast::LitIntType::Unsigned(ast::UintTy::U32)))
714 fn expr_u8(&self, sp: Span, u: u8) -> P<ast::Expr> {
715 self.expr_lit(sp, ast::LitKind::Int(u as u128, ast::LitIntType::Unsigned(ast::UintTy::U8)))
717 fn expr_bool(&self, sp: Span, value: bool) -> P<ast::Expr> {
718 self.expr_lit(sp, ast::LitKind::Bool(value))
721 fn expr_vec(&self, sp: Span, exprs: Vec<P<ast::Expr>>) -> P<ast::Expr> {
722 self.expr(sp, ast::ExprKind::Array(exprs))
724 fn expr_vec_ng(&self, sp: Span) -> P<ast::Expr> {
725 self.expr_call_global(sp, self.std_path(&["vec", "Vec", "new"]),
728 fn expr_vec_slice(&self, sp: Span, exprs: Vec<P<ast::Expr>>) -> P<ast::Expr> {
729 self.expr_addr_of(sp, self.expr_vec(sp, exprs))
731 fn expr_str(&self, sp: Span, s: Symbol) -> P<ast::Expr> {
732 self.expr_lit(sp, ast::LitKind::Str(s, ast::StrStyle::Cooked))
735 fn expr_cast(&self, sp: Span, expr: P<ast::Expr>, ty: P<ast::Ty>) -> P<ast::Expr> {
736 self.expr(sp, ast::ExprKind::Cast(expr, ty))
740 fn expr_some(&self, sp: Span, expr: P<ast::Expr>) -> P<ast::Expr> {
741 let some = self.std_path(&["option", "Option", "Some"]);
742 self.expr_call_global(sp, some, vec![expr])
745 fn expr_none(&self, sp: Span) -> P<ast::Expr> {
746 let none = self.std_path(&["option", "Option", "None"]);
747 let none = self.path_global(sp, none);
752 fn expr_break(&self, sp: Span) -> P<ast::Expr> {
753 self.expr(sp, ast::ExprKind::Break(None, None))
757 fn expr_tuple(&self, sp: Span, exprs: Vec<P<ast::Expr>>) -> P<ast::Expr> {
758 self.expr(sp, ast::ExprKind::Tup(exprs))
761 fn expr_fail(&self, span: Span, msg: Symbol) -> P<ast::Expr> {
762 let loc = self.codemap().lookup_char_pos(span.lo());
763 let expr_file = self.expr_str(span, Symbol::intern(&loc.file.name.to_string()));
764 let expr_line = self.expr_u32(span, loc.line as u32);
765 let expr_col = self.expr_u32(span, loc.col.to_usize() as u32 + 1);
766 let expr_loc_tuple = self.expr_tuple(span, vec![expr_file, expr_line, expr_col]);
767 let expr_loc_ptr = self.expr_addr_of(span, expr_loc_tuple);
768 self.expr_call_global(
770 self.std_path(&["rt", "begin_panic"]),
772 self.expr_str(span, msg),
776 fn expr_unreachable(&self, span: Span) -> P<ast::Expr> {
777 self.expr_fail(span, Symbol::intern("internal error: entered unreachable code"))
780 fn expr_ok(&self, sp: Span, expr: P<ast::Expr>) -> P<ast::Expr> {
781 let ok = self.std_path(&["result", "Result", "Ok"]);
782 self.expr_call_global(sp, ok, vec![expr])
785 fn expr_err(&self, sp: Span, expr: P<ast::Expr>) -> P<ast::Expr> {
786 let err = self.std_path(&["result", "Result", "Err"]);
787 self.expr_call_global(sp, err, vec![expr])
790 fn expr_try(&self, sp: Span, head: P<ast::Expr>) -> P<ast::Expr> {
791 let ok = self.std_path(&["result", "Result", "Ok"]);
792 let ok_path = self.path_global(sp, ok);
793 let err = self.std_path(&["result", "Result", "Err"]);
794 let err_path = self.path_global(sp, err);
796 let binding_variable = self.ident_of("__try_var");
797 let binding_pat = self.pat_ident(sp, binding_variable);
798 let binding_expr = self.expr_ident(sp, binding_variable);
800 // Ok(__try_var) pattern
801 let ok_pat = self.pat_tuple_struct(sp, ok_path, vec![binding_pat.clone()]);
803 // Err(__try_var) (pattern and expression resp.)
804 let err_pat = self.pat_tuple_struct(sp, err_path.clone(), vec![binding_pat]);
805 let err_inner_expr = self.expr_call(sp, self.expr_path(err_path),
806 vec![binding_expr.clone()]);
807 // return Err(__try_var)
808 let err_expr = self.expr(sp, ast::ExprKind::Ret(Some(err_inner_expr)));
810 // Ok(__try_var) => __try_var
811 let ok_arm = self.arm(sp, vec![ok_pat], binding_expr);
812 // Err(__try_var) => return Err(__try_var)
813 let err_arm = self.arm(sp, vec![err_pat], err_expr);
815 // match head { Ok() => ..., Err() => ... }
816 self.expr_match(sp, head, vec![ok_arm, err_arm])
820 fn pat(&self, span: Span, pat: PatKind) -> P<ast::Pat> {
821 P(ast::Pat { id: ast::DUMMY_NODE_ID, node: pat, span: span })
823 fn pat_wild(&self, span: Span) -> P<ast::Pat> {
824 self.pat(span, PatKind::Wild)
826 fn pat_lit(&self, span: Span, expr: P<ast::Expr>) -> P<ast::Pat> {
827 self.pat(span, PatKind::Lit(expr))
829 fn pat_ident(&self, span: Span, ident: ast::Ident) -> P<ast::Pat> {
830 let binding_mode = ast::BindingMode::ByValue(ast::Mutability::Immutable);
831 self.pat_ident_binding_mode(span, ident, binding_mode)
834 fn pat_ident_binding_mode(&self,
837 bm: ast::BindingMode) -> P<ast::Pat> {
838 let pat = PatKind::Ident(bm, Spanned{span: span, node: ident}, None);
841 fn pat_path(&self, span: Span, path: ast::Path) -> P<ast::Pat> {
842 self.pat(span, PatKind::Path(None, path))
844 fn pat_tuple_struct(&self, span: Span, path: ast::Path,
845 subpats: Vec<P<ast::Pat>>) -> P<ast::Pat> {
846 self.pat(span, PatKind::TupleStruct(path, subpats, None))
848 fn pat_struct(&self, span: Span, path: ast::Path,
849 field_pats: Vec<Spanned<ast::FieldPat>>) -> P<ast::Pat> {
850 self.pat(span, PatKind::Struct(path, field_pats, false))
852 fn pat_tuple(&self, span: Span, pats: Vec<P<ast::Pat>>) -> P<ast::Pat> {
853 self.pat(span, PatKind::Tuple(pats, None))
856 fn pat_some(&self, span: Span, pat: P<ast::Pat>) -> P<ast::Pat> {
857 let some = self.std_path(&["option", "Option", "Some"]);
858 let path = self.path_global(span, some);
859 self.pat_tuple_struct(span, path, vec![pat])
862 fn pat_none(&self, span: Span) -> P<ast::Pat> {
863 let some = self.std_path(&["option", "Option", "None"]);
864 let path = self.path_global(span, some);
865 self.pat_path(span, path)
868 fn pat_ok(&self, span: Span, pat: P<ast::Pat>) -> P<ast::Pat> {
869 let some = self.std_path(&["result", "Result", "Ok"]);
870 let path = self.path_global(span, some);
871 self.pat_tuple_struct(span, path, vec![pat])
874 fn pat_err(&self, span: Span, pat: P<ast::Pat>) -> P<ast::Pat> {
875 let some = self.std_path(&["result", "Result", "Err"]);
876 let path = self.path_global(span, some);
877 self.pat_tuple_struct(span, path, vec![pat])
880 fn arm(&self, _span: Span, pats: Vec<P<ast::Pat>>, expr: P<ast::Expr>) -> ast::Arm {
889 fn arm_unreachable(&self, span: Span) -> ast::Arm {
890 self.arm(span, vec![self.pat_wild(span)], self.expr_unreachable(span))
893 fn expr_match(&self, span: Span, arg: P<ast::Expr>, arms: Vec<ast::Arm>) -> P<Expr> {
894 self.expr(span, ast::ExprKind::Match(arg, arms))
897 fn expr_if(&self, span: Span, cond: P<ast::Expr>,
898 then: P<ast::Expr>, els: Option<P<ast::Expr>>) -> P<ast::Expr> {
899 let els = els.map(|x| self.expr_block(self.block_expr(x)));
900 self.expr(span, ast::ExprKind::If(cond, self.block_expr(then), els))
903 fn expr_loop(&self, span: Span, block: P<ast::Block>) -> P<ast::Expr> {
904 self.expr(span, ast::ExprKind::Loop(block, None))
907 fn lambda_fn_decl(&self,
909 fn_decl: P<ast::FnDecl>,
911 fn_decl_span: Span) // span of the `|...|` part
913 self.expr(span, ast::ExprKind::Closure(ast::CaptureBy::Ref,
914 ast::Movability::Movable,
922 ids: Vec<ast::Ident>,
925 let fn_decl = self.fn_decl(
926 ids.iter().map(|id| self.arg(span, *id, self.ty_infer(span))).collect(),
927 self.ty_infer(span));
929 // FIXME -- We are using `span` as the span of the `|...|`
930 // part of the lambda, but it probably (maybe?) corresponds to
931 // the entire lambda body. Probably we should extend the API
932 // here, but that's not entirely clear.
933 self.expr(span, ast::ExprKind::Closure(ast::CaptureBy::Ref,
934 ast::Movability::Movable,
940 fn lambda0(&self, span: Span, body: P<ast::Expr>) -> P<ast::Expr> {
941 self.lambda(span, Vec::new(), body)
944 fn lambda1(&self, span: Span, body: P<ast::Expr>, ident: ast::Ident) -> P<ast::Expr> {
945 self.lambda(span, vec![ident], body)
948 fn lambda_stmts(&self,
950 ids: Vec<ast::Ident>,
951 stmts: Vec<ast::Stmt>)
953 self.lambda(span, ids, self.expr_block(self.block(span, stmts)))
955 fn lambda_stmts_0(&self, span: Span, stmts: Vec<ast::Stmt>) -> P<ast::Expr> {
956 self.lambda0(span, self.expr_block(self.block(span, stmts)))
958 fn lambda_stmts_1(&self, span: Span, stmts: Vec<ast::Stmt>,
959 ident: ast::Ident) -> P<ast::Expr> {
960 self.lambda1(span, self.expr_block(self.block(span, stmts)), ident)
963 fn arg(&self, span: Span, ident: ast::Ident, ty: P<ast::Ty>) -> ast::Arg {
964 let arg_pat = self.pat_ident(span, ident);
968 id: ast::DUMMY_NODE_ID
973 fn fn_decl(&self, inputs: Vec<ast::Arg>, output: P<ast::Ty>) -> P<ast::FnDecl> {
976 output: ast::FunctionRetTy::Ty(output),
981 fn item(&self, span: Span, name: Ident,
982 attrs: Vec<ast::Attribute>, node: ast::ItemKind) -> P<ast::Item> {
983 // FIXME: Would be nice if our generated code didn't violate
984 // Rust coding conventions
988 id: ast::DUMMY_NODE_ID,
990 vis: ast::Visibility::Inherited,
996 fn item_fn_poly(&self,
999 inputs: Vec<ast::Arg> ,
1002 body: P<ast::Block>) -> P<ast::Item> {
1006 ast::ItemKind::Fn(self.fn_decl(inputs, output),
1007 ast::Unsafety::Normal,
1008 dummy_spanned(ast::Constness::NotConst),
1017 inputs: Vec<ast::Arg> ,
1026 Generics::default(),
1030 fn variant(&self, span: Span, name: Ident, tys: Vec<P<ast::Ty>> ) -> ast::Variant {
1031 let fields: Vec<_> = tys.into_iter().map(|ty| {
1036 vis: ast::Visibility::Inherited,
1038 id: ast::DUMMY_NODE_ID,
1042 let vdata = if fields.is_empty() {
1043 ast::VariantData::Unit(ast::DUMMY_NODE_ID)
1045 ast::VariantData::Tuple(fields, ast::DUMMY_NODE_ID)
1057 fn item_enum_poly(&self, span: Span, name: Ident,
1058 enum_definition: ast::EnumDef,
1059 generics: Generics) -> P<ast::Item> {
1060 self.item(span, name, Vec::new(), ast::ItemKind::Enum(enum_definition, generics))
1063 fn item_enum(&self, span: Span, name: Ident,
1064 enum_definition: ast::EnumDef) -> P<ast::Item> {
1065 self.item_enum_poly(span, name, enum_definition,
1066 Generics::default())
1069 fn item_struct(&self, span: Span, name: Ident,
1070 struct_def: ast::VariantData) -> P<ast::Item> {
1071 self.item_struct_poly(
1079 fn item_struct_poly(&self, span: Span, name: Ident,
1080 struct_def: ast::VariantData, generics: Generics) -> P<ast::Item> {
1081 self.item(span, name, Vec::new(), ast::ItemKind::Struct(struct_def, generics))
1084 fn item_mod(&self, span: Span, inner_span: Span, name: Ident,
1085 attrs: Vec<ast::Attribute>,
1086 items: Vec<P<ast::Item>>) -> P<ast::Item> {
1091 ast::ItemKind::Mod(ast::Mod {
1098 fn item_extern_crate(&self, span: Span, name: Ident) -> P<ast::Item> {
1099 self.item(span, name, Vec::new(), ast::ItemKind::ExternCrate(None))
1102 fn item_static(&self,
1106 mutbl: ast::Mutability,
1109 self.item(span, name, Vec::new(), ast::ItemKind::Static(ty, mutbl, expr))
1112 fn item_const(&self,
1118 self.item(span, name, Vec::new(), ast::ItemKind::Const(ty, expr))
1121 fn item_ty_poly(&self, span: Span, name: Ident, ty: P<ast::Ty>,
1122 generics: Generics) -> P<ast::Item> {
1123 self.item(span, name, Vec::new(), ast::ItemKind::Ty(ty, generics))
1126 fn item_ty(&self, span: Span, name: Ident, ty: P<ast::Ty>) -> P<ast::Item> {
1127 self.item_ty_poly(span, name, ty, Generics::default())
1130 fn attribute(&self, sp: Span, mi: ast::MetaItem) -> ast::Attribute {
1131 attr::mk_spanned_attr_outer(sp, attr::mk_attr_id(), mi)
1134 fn meta_word(&self, sp: Span, w: ast::Name) -> ast::MetaItem {
1135 attr::mk_spanned_word_item(sp, w)
1138 fn meta_list_item_word(&self, sp: Span, w: ast::Name) -> ast::NestedMetaItem {
1139 respan(sp, ast::NestedMetaItemKind::MetaItem(attr::mk_spanned_word_item(sp, w)))
1142 fn meta_list(&self, sp: Span, name: ast::Name, mis: Vec<ast::NestedMetaItem>)
1144 attr::mk_spanned_list_item(sp, name, mis)
1147 fn meta_name_value(&self, sp: Span, name: ast::Name, value: ast::LitKind)
1149 attr::mk_spanned_name_value_item(sp, name, respan(sp, value))
1152 fn item_use(&self, sp: Span,
1153 vis: ast::Visibility, vp: P<ast::UseTree>) -> P<ast::Item> {
1155 id: ast::DUMMY_NODE_ID,
1156 ident: keywords::Invalid.ident(),
1158 node: ast::ItemKind::Use(vp),
1165 fn item_use_simple(&self, sp: Span, vis: ast::Visibility, path: ast::Path) -> P<ast::Item> {
1166 let last = path.segments.last().unwrap().identifier;
1167 self.item_use_simple_(sp, vis, last, path)
1170 fn item_use_simple_(&self, sp: Span, vis: ast::Visibility,
1171 ident: ast::Ident, path: ast::Path) -> P<ast::Item> {
1172 self.item_use(sp, vis, P(ast::UseTree {
1175 kind: ast::UseTreeKind::Simple(ident),
1179 fn item_use_list(&self, sp: Span, vis: ast::Visibility,
1180 path: Vec<ast::Ident>, imports: &[ast::Ident]) -> P<ast::Item> {
1181 let imports = imports.iter().map(|id| {
1184 prefix: self.path(sp, vec![*id]),
1185 kind: ast::UseTreeKind::Simple(*id),
1186 }, ast::DUMMY_NODE_ID)
1189 self.item_use(sp, vis, P(ast::UseTree {
1191 prefix: self.path(sp, path),
1192 kind: ast::UseTreeKind::Nested(imports),
1196 fn item_use_glob(&self, sp: Span,
1197 vis: ast::Visibility, path: Vec<ast::Ident>) -> P<ast::Item> {
1198 self.item_use(sp, vis, P(ast::UseTree {
1200 prefix: self.path(sp, path),
1201 kind: ast::UseTreeKind::Glob,