astconv.rs 83.6 KB
Newer Older
V
Virgile Andreani 已提交
1
// Copyright 2012-2014 The Rust Project Developers. See the COPYRIGHT
2 3 4 5 6 7 8 9 10
// file at the top-level directory of this distribution and at
// http://rust-lang.org/COPYRIGHT.
//
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. This file may not be copied, modified, or distributed
// except according to those terms.

S
Steve Klabnik 已提交
11 12 13 14 15 16 17 18
//! Conversion from AST representation of types to the ty.rs
//! representation.  The main routine here is `ast_ty_to_ty()`: each use
//! is parameterized by an instance of `AstConv` and a `RegionScope`.
//!
//! The parameterization of `ast_ty_to_ty()` is because it behaves
//! somewhat differently during the collect and check phases,
//! particularly with respect to looking up the types of top-level
//! items.  In the collect phase, the crate context is used as the
19 20 21 22 23 24
//! `AstConv` instance; in this phase, the `get_item_type_scheme()`
//! function triggers a recursive call to `type_scheme_of_item()`
//! (note that `ast_ty_to_ty()` will detect recursive types and report
//! an error).  In the check phase, when the FnCtxt is used as the
//! `AstConv`, `get_item_type_scheme()` just looks up the item type in
//! `tcx.tcache` (using `ty::lookup_item_type`).
S
Steve Klabnik 已提交
25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49
//!
//! The `RegionScope` trait controls what happens when the user does
//! not specify a region in some location where a region is required
//! (e.g., if the user writes `&Foo` as a type rather than `&'a Foo`).
//! See the `rscope` module for more details.
//!
//! Unlike the `AstConv` trait, the region scope can change as we descend
//! the type.  This is to accommodate the fact that (a) fn types are binding
//! scopes and (b) the default region may change.  To understand case (a),
//! consider something like:
//!
//!   type foo = { x: &a.int, y: |&a.int| }
//!
//! The type of `x` is an error because there is no region `a` in scope.
//! In the type of `y`, however, region `a` is considered a bound region
//! as it does not already appear in scope.
//!
//! Case (b) says that if you have a type:
//!   type foo<'a> = ...;
//!   type bar = fn(&foo, &a.foo)
//! The fully expanded version of type bar is:
//!   type bar = fn(&'foo &, &a.foo<'a>)
//! Note that the self region for the `foo` defaulted to `&` in the first
//! case but `&a` in the second.  Basically, defaults that appear inside
//! an rptr (`&r.T`) use the region `r` that appears in the rptr.
50

51
use middle::astconv_util::{prim_ty_to_ty, check_path_args, NO_TPS, NO_REGIONS};
52
use middle::const_eval;
53
use middle::def;
54
use middle::resolve_lifetime as rl;
55
use middle::privacy::{AllPublic, LastMod};
56
use middle::subst::{FnSpace, TypeSpace, SelfSpace, Subst, Substs};
57
use middle::traits;
58
use middle::ty::{self, RegionEscape, Ty};
59
use rscope::{self, UnelidableRscope, RegionScope, ElidableRscope,
60
             ObjectLifetimeDefaultRscope, ShiftedRscope, BindingRscope};
61
use util::common::{ErrorReported, FN_OUTPUT_NAME};
62
use util::ppaux::{self, Repr, UserString};
63

A
Aaron Turon 已提交
64
use std::iter::{repeat, AdditiveIterator};
65 66
use std::rc::Rc;
use std::slice;
67
use syntax::{abi, ast, ast_util};
68
use syntax::codemap::Span;
69
use syntax::parse::token;
70
use syntax::print::pprust;
71

72 73
pub trait AstConv<'tcx> {
    fn tcx<'a>(&'a self) -> &'a ty::ctxt<'tcx>;
74

75 76 77
    /// Identify the type scheme for an item with a type, like a type
    /// alias, fn, or struct. This allows you to figure out the set of
    /// type parameters defined on the item.
78 79
    fn get_item_type_scheme(&self, span: Span, id: ast::DefId)
                            -> Result<ty::TypeScheme<'tcx>, ErrorReported>;
80

81 82
    /// Returns the `TraitDef` for a given trait. This allows you to
    /// figure out the set of type parameters defined on the trait.
83 84
    fn get_trait_def(&self, span: Span, id: ast::DefId)
                     -> Result<Rc<ty::TraitDef<'tcx>>, ErrorReported>;
N
Nick Cameron 已提交
85

86 87 88 89 90 91 92 93
    /// Ensure that the super-predicates for the trait with the given
    /// id are available and also for the transitive set of
    /// super-predicates.
    fn ensure_super_predicates(&self, span: Span, id: ast::DefId)
                               -> Result<(), ErrorReported>;

    /// Returns the set of bounds in scope for the type parameter with
    /// the given id.
94 95
    fn get_type_parameter_bounds(&self, span: Span, def_id: ast::NodeId)
                                 -> Result<Vec<ty::PolyTraitRef<'tcx>>, ErrorReported>;
96

97 98
    /// Returns true if the trait with id `trait_def_id` defines an
    /// associated type with the name `name`.
99 100 101
    fn trait_defines_associated_type_named(&self, trait_def_id: ast::DefId, name: ast::Name)
                                           -> bool;

N
Nick Cameron 已提交
102 103 104 105
    /// Return an (optional) substitution to convert bound type parameters that
    /// are in scope into free ones. This function should only return Some
    /// within a fn body.
    /// See ParameterEnvironment::free_substs for more information.
106 107 108
    fn get_free_substs(&self) -> Option<&Substs<'tcx>> {
        None
    }
109

110
    /// What type should we use when a type is omitted?
111
    fn ty_infer(&self, span: Span) -> Ty<'tcx>;
112

113 114 115 116 117 118 119 120 121 122 123 124 125 126
    /// Projecting an associated type from a (potentially)
    /// higher-ranked trait reference is more complicated, because of
    /// the possibility of late-bound regions appearing in the
    /// associated type binding. This is not legal in function
    /// signatures for that reason. In a function body, we can always
    /// handle it because we can use inference variables to remove the
    /// late-bound regions.
    fn projected_ty_from_poly_trait_ref(&self,
                                        span: Span,
                                        poly_trait_ref: ty::PolyTraitRef<'tcx>,
                                        item_name: ast::Name)
                                        -> Ty<'tcx>
    {
        if ty::binds_late_bound_regions(self.tcx(), &poly_trait_ref) {
B
Brian Anderson 已提交
127
            span_err!(self.tcx().sess, span, E0212,
128 129 130 131 132 133 134 135 136 137 138 139 140 141 142
                "cannot extract an associated type from a higher-ranked trait bound \
                 in this context");
            self.tcx().types.err
        } else {
            // no late-bound regions, we can just ignore the binder
            self.projected_ty(span, poly_trait_ref.0.clone(), item_name)
        }
    }

    /// Project an associated type from a non-higher-ranked trait reference.
    /// This is fairly straightforward and can be accommodated in any context.
    fn projected_ty(&self,
                    span: Span,
                    _trait_ref: Rc<ty::TraitRef<'tcx>>,
                    _item_name: ast::Name)
N
Nick Cameron 已提交
143
                    -> Ty<'tcx>;
144 145
}

E
Eduard Burtescu 已提交
146
pub fn ast_region_to_region(tcx: &ty::ctxt, lifetime: &ast::Lifetime)
147
                            -> ty::Region {
148
    let r = match tcx.named_region_map.get(&lifetime.id) {
149 150 151
        None => {
            // should have been recorded by the `resolve_lifetime` pass
            tcx.sess.span_bug(lifetime.span, "unresolved lifetime");
152
        }
153

154
        Some(&rl::DefStaticRegion) => {
155
            ty::ReStatic
156 157
        }

158 159
        Some(&rl::DefLateBoundRegion(debruijn, id)) => {
            ty::ReLateBound(debruijn, ty::BrNamed(ast_util::local_def(id), lifetime.name))
160 161
        }

162 163
        Some(&rl::DefEarlyBoundRegion(space, index, id)) => {
            ty::ReEarlyBound(id, space, index, lifetime.name)
164 165
        }

166
        Some(&rl::DefFreeRegion(scope, id)) => {
167
            ty::ReFree(ty::FreeRegion {
168
                    scope: scope,
169
                    bound_region: ty::BrNamed(ast_util::local_def(id),
170
                                              lifetime.name)
171 172 173 174 175
                })
        }
    };

    debug!("ast_region_to_region(lifetime={} id={}) yields {}",
176 177 178
           lifetime.repr(tcx),
           lifetime.id,
           r.repr(tcx));
179 180

    r
181 182
}

183 184 185
pub fn opt_ast_region_to_region<'tcx>(
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
186
    default_span: Span,
J
James Miller 已提交
187
    opt_lifetime: &Option<ast::Lifetime>) -> ty::Region
188
{
189 190 191
    let r = match *opt_lifetime {
        Some(ref lifetime) => {
            ast_region_to_region(this.tcx(), lifetime)
192
        }
193 194 195

        None => {
            match rscope.anon_regions(default_span, 1) {
196
                Err(v) => {
197
                    debug!("optional region in illegal location");
J
Jakub Wieczorek 已提交
198 199
                    span_err!(this.tcx().sess, default_span, E0106,
                        "missing lifetime specifier");
200 201 202 203
                    match v {
                        Some(v) => {
                            let mut m = String::new();
                            let len = v.len();
204
                            for (i, (name, n)) in v.into_iter().enumerate() {
205 206 207
                                let help_name = if name.is_empty() {
                                    format!("argument {}", i + 1)
                                } else {
208
                                    format!("`{}`", name)
209 210
                                };

J
Jorge Aparicio 已提交
211
                                m.push_str(&(if n == 1 {
212
                                    help_name
213
                                } else {
214
                                    format!("one of {}'s {} elided lifetimes", help_name, n)
215
                                })[..]);
216 217 218

                                if len == 2 && i == 0 {
                                    m.push_str(" or ");
219
                                } else if i + 2 == len {
220
                                    m.push_str(", or ");
221
                                } else if i + 1 != len {
222 223 224 225
                                    m.push_str(", ");
                                }
                            }
                            if len == 1 {
226
                                fileline_help!(this.tcx().sess, default_span,
227 228 229 230
                                    "this function's return type contains a borrowed value, but \
                                     the signature does not say which {} it is borrowed from",
                                    m);
                            } else if len == 0 {
231
                                fileline_help!(this.tcx().sess, default_span,
232 233
                                    "this function's return type contains a borrowed value, but \
                                     there is no value for it to be borrowed from");
234
                                fileline_help!(this.tcx().sess, default_span,
235 236
                                    "consider giving it a 'static lifetime");
                            } else {
237
                                fileline_help!(this.tcx().sess, default_span,
238 239 240 241 242 243 244
                                    "this function's return type contains a borrowed value, but \
                                     the signature does not say whether it is borrowed from {}",
                                    m);
                            }
                        }
                        None => {},
                    }
245
                    ty::ReStatic
246 247
                }

248
                Ok(rs) => rs[0],
249
            }
250
        }
251 252
    };

B
Ben Gamari 已提交
253
    debug!("opt_ast_region_to_region(opt_lifetime={}) yields {}",
254
            opt_lifetime.repr(this.tcx()),
255 256 257
            r.repr(this.tcx()));

    r
258 259
}

S
Steve Klabnik 已提交
260 261
/// Given a path `path` that refers to an item `I` with the declared generics `decl_generics`,
/// returns an appropriate set of substitutions for this particular reference to `I`.
262
pub fn ast_path_substs_for_ty<'tcx>(
263 264
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
265
    span: Span,
266
    param_mode: PathParamMode,
267
    decl_generics: &ty::Generics<'tcx>,
268
    item_segment: &ast::PathSegment)
269
    -> Substs<'tcx>
270
{
271
    let tcx = this.tcx();
272

273 274 275 276 277 278 279 280
    // ast_path_substs() is only called to convert paths that are
    // known to refer to traits, types, or structs. In these cases,
    // all type parameters defined for the item being referenced will
    // be in the TypeSpace or SelfSpace.
    //
    // Note: in the case of traits, the self parameter is also
    // defined, but we don't currently create a `type_param_def` for
    // `Self` because it is implicit.
281 282
    assert!(decl_generics.regions.all(|d| d.space == TypeSpace));
    assert!(decl_generics.types.all(|d| d.space != FnSpace));
283

284
    let (regions, types, assoc_bindings) = match item_segment.parameters {
285
        ast::AngleBracketedParameters(ref data) => {
286
            convert_angle_bracketed_parameters(this, rscope, span, decl_generics, data)
287 288
        }
        ast::ParenthesizedParameters(ref data) => {
289
            span_err!(tcx.sess, span, E0214,
290
                "parenthesized parameters may only be used with a trait");
291
            convert_parenthesized_parameters(this, rscope, span, decl_generics, data)
292
        }
293 294
    };

295
    prohibit_projections(this.tcx(), &assoc_bindings);
296

297
    create_substs_for_ast_path(this,
298
                               span,
299
                               param_mode,
300 301 302
                               decl_generics,
                               None,
                               types,
303
                               regions)
304 305
}

306 307 308 309 310 311 312 313
#[derive(PartialEq, Eq)]
pub enum PathParamMode {
    // Any path in a type context.
    Explicit,
    // The `module::Type` in `module::Type::method` in an expression.
    Optional
}

314
fn create_region_substs<'tcx>(
315 316
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
317
    span: Span,
318
    decl_generics: &ty::Generics<'tcx>,
319
    regions_provided: Vec<ty::Region>)
320
    -> Substs<'tcx>
321 322 323
{
    let tcx = this.tcx();

324
    // If the type is parameterized by the this region, then replace this
325 326
    // region with the current anon region binding (in other words,
    // whatever & would get replaced with).
327
    let expected_num_region_params = decl_generics.regions.len(TypeSpace);
328
    let supplied_num_region_params = regions_provided.len();
329
    let regions = if expected_num_region_params == supplied_num_region_params {
330
        regions_provided
331 332
    } else {
        let anon_regions =
333
            rscope.anon_regions(span, expected_num_region_params);
334

335
        if supplied_num_region_params != 0 || anon_regions.is_err() {
336 337 338
            report_lifetime_number_error(tcx, span,
                                         supplied_num_region_params,
                                         expected_num_region_params);
339
        }
340 341

        match anon_regions {
342 343
            Ok(anon_regions) => anon_regions,
            Err(_) => (0..expected_num_region_params).map(|_| ty::ReStatic).collect()
344
        }
345
    };
346 347 348 349 350 351 352 353 354 355 356 357 358 359 360
    Substs::new_type(vec![], regions)
}

/// Given the type/region arguments provided to some path (along with
/// an implicit Self, if this is a trait reference) returns the complete
/// set of substitutions. This may involve applying defaulted type parameters.
///
/// Note that the type listing given here is *exactly* what the user provided.
///
/// The `region_substs` should be the result of `create_region_substs`
/// -- that is, a substitution with no types but the correct number of
/// regions.
fn create_substs_for_ast_path<'tcx>(
    this: &AstConv<'tcx>,
    span: Span,
361
    param_mode: PathParamMode,
362 363 364 365 366 367 368 369 370 371 372 373 374 375 376
    decl_generics: &ty::Generics<'tcx>,
    self_ty: Option<Ty<'tcx>>,
    types_provided: Vec<Ty<'tcx>>,
    region_substs: Substs<'tcx>)
    -> Substs<'tcx>
{
    let tcx = this.tcx();

    debug!("create_substs_for_ast_path(decl_generics={}, self_ty={}, \
           types_provided={}, region_substs={}",
           decl_generics.repr(tcx), self_ty.repr(tcx), types_provided.repr(tcx),
           region_substs.repr(tcx));

    assert_eq!(region_substs.regions().len(TypeSpace), decl_generics.regions.len(TypeSpace));
    assert!(region_substs.types.is_empty());
377 378

    // Convert the type parameters supplied by the user.
379
    let ty_param_defs = decl_generics.types.get_slice(TypeSpace);
380 381 382 383 384
    let formal_ty_param_count = ty_param_defs.len();
    let required_ty_param_count = ty_param_defs.iter()
                                               .take_while(|x| x.default.is_none())
                                               .count();

385 386 387 388 389 390 391 392 393 394
    // Fill with `ty_infer` if no params were specified, as long as
    // they were optional (e.g. paths inside expressions).
    let mut type_substs = if param_mode == PathParamMode::Optional &&
                             types_provided.is_empty() {
        (0..formal_ty_param_count).map(|_| this.ty_infer(span)).collect()
    } else {
        types_provided
    };

    let supplied_ty_param_count = type_substs.len();
395 396 397
    check_type_argument_count(this.tcx(), span, supplied_ty_param_count,
                              required_ty_param_count, formal_ty_param_count);

398
    if supplied_ty_param_count < required_ty_param_count {
399 400 401
        while type_substs.len() < required_ty_param_count {
            type_substs.push(tcx.types.err);
        }
402
    } else if supplied_ty_param_count > formal_ty_param_count {
403
        type_substs.truncate(formal_ty_param_count);
404
    }
405 406
    assert!(type_substs.len() >= required_ty_param_count &&
            type_substs.len() <= formal_ty_param_count);
407

408 409
    let mut substs = region_substs;
    substs.types.extend(TypeSpace, type_substs.into_iter());
410

411 412 413 414 415 416 417 418 419 420
    match self_ty {
        None => {
            // If no self-type is provided, it's still possible that
            // one was declared, because this could be an object type.
        }
        Some(ty) => {
            // If a self-type is provided, one should have been
            // "declared" (in other words, this should be a
            // trait-ref).
            assert!(decl_generics.types.get_self().is_some());
421
            substs.types.push(SelfSpace, ty);
422
        }
423
    }
424

425 426
    let actual_supplied_ty_param_count = substs.types.len(TypeSpace);
    for param in &ty_param_defs[actual_supplied_ty_param_count..] {
427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442
        if let Some(default) = param.default {
            // If we are converting an object type, then the
            // `Self` parameter is unknown. However, some of the
            // other type parameters may reference `Self` in their
            // defaults. This will lead to an ICE if we are not
            // careful!
            if self_ty.is_none() && ty::type_has_self(default) {
                tcx.sess.span_err(
                    span,
                    &format!("the type parameter `{}` must be explicitly specified \
                              in an object type because its default value `{}` references \
                              the type `Self`",
                             param.name.user_string(tcx),
                             default.user_string(tcx)));
                substs.types.push(TypeSpace, tcx.types.err);
            } else {
443 444 445
                // This is a default type parameter.
                let default = default.subst_spanned(tcx,
                                                    &substs,
446
                                                    Some(span));
447 448
                substs.types.push(TypeSpace, default);
            }
449 450
        } else {
            tcx.sess.span_bug(span, "extra parameter without default");
451
        }
452
    }
453

454
    substs
455
}
456

457 458 459 460 461 462
struct ConvertedBinding<'tcx> {
    item_name: ast::Name,
    ty: Ty<'tcx>,
    span: Span,
}

463 464
fn convert_angle_bracketed_parameters<'tcx>(this: &AstConv<'tcx>,
                                            rscope: &RegionScope,
465 466
                                            span: Span,
                                            decl_generics: &ty::Generics<'tcx>,
467
                                            data: &ast::AngleBracketedParameterData)
468
                                            -> (Substs<'tcx>,
469 470
                                                Vec<Ty<'tcx>>,
                                                Vec<ConvertedBinding<'tcx>>)
471 472 473
{
    let regions: Vec<_> =
        data.lifetimes.iter()
474 475
                      .map(|l| ast_region_to_region(this.tcx(), l))
                      .collect();
476

477 478
    let region_substs =
        create_region_substs(this, rscope, span, decl_generics, regions);
479

480 481
    let types: Vec<_> =
        data.types.iter()
482 483 484 485
                  .enumerate()
                  .map(|(i,t)| ast_ty_arg_to_ty(this, rscope, decl_generics,
                                                i, &region_substs, t))
                  .collect();
486

487 488
    let assoc_bindings: Vec<_> =
        data.bindings.iter()
489 490 491 492
                     .map(|b| ConvertedBinding { item_name: b.ident.name,
                                                 ty: ast_ty_to_ty(this, rscope, &*b.ty),
                                                 span: b.span })
                     .collect();
493

494
    (region_substs, types, assoc_bindings)
495 496
}

497 498 499 500
/// Returns the appropriate lifetime to use for any output lifetimes
/// (if one exists) and a vector of the (pattern, number of lifetimes)
/// corresponding to each input type/pattern.
fn find_implied_output_region(input_tys: &[Ty], input_pats: Vec<String>)
501
                              -> (Option<ty::Region>, Vec<(String, usize)>)
502
{
503
    let mut lifetimes_for_params: Vec<(String, usize)> = Vec::new();
504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528
    let mut possible_implied_output_region = None;

    for (input_type, input_pat) in input_tys.iter().zip(input_pats.into_iter()) {
        let mut accumulator = Vec::new();
        ty::accumulate_lifetimes_in_type(&mut accumulator, *input_type);

        if accumulator.len() == 1 {
            // there's a chance that the unique lifetime of this
            // iteration will be the appropriate lifetime for output
            // parameters, so lets store it.
            possible_implied_output_region = Some(accumulator[0])
        }

        lifetimes_for_params.push((input_pat, accumulator.len()));
    }

    let implied_output_region = if lifetimes_for_params.iter().map(|&(_, n)| n).sum() == 1 {
        assert!(possible_implied_output_region.is_some());
        possible_implied_output_region
    } else {
        None
    };
    (implied_output_region, lifetimes_for_params)
}

529 530
fn convert_ty_with_lifetime_elision<'tcx>(this: &AstConv<'tcx>,
                                          implied_output_region: Option<ty::Region>,
531
                                          param_lifetimes: Vec<(String, usize)>,
532 533
                                          ty: &ast::Ty)
                                          -> Ty<'tcx>
534 535 536
{
    match implied_output_region {
        Some(implied_output_region) => {
537
            let rb = ElidableRscope::new(implied_output_region);
538 539 540 541 542 543 544 545 546 547 548 549
            ast_ty_to_ty(this, &rb, ty)
        }
        None => {
            // All regions must be explicitly specified in the output
            // if the lifetime elision rules do not apply. This saves
            // the user from potentially-confusing errors.
            let rb = UnelidableRscope::new(param_lifetimes);
            ast_ty_to_ty(this, &rb, ty)
        }
    }
}

550
fn convert_parenthesized_parameters<'tcx>(this: &AstConv<'tcx>,
551 552 553
                                          rscope: &RegionScope,
                                          span: Span,
                                          decl_generics: &ty::Generics<'tcx>,
554
                                          data: &ast::ParenthesizedParameterData)
555
                                          -> (Substs<'tcx>,
556 557
                                              Vec<Ty<'tcx>>,
                                              Vec<ConvertedBinding<'tcx>>)
558
{
559 560 561
    let region_substs =
        create_region_substs(this, rscope, span, decl_generics, Vec::new());

562
    let binding_rscope = BindingRscope::new();
563 564 565 566 567
    let inputs =
        data.inputs.iter()
                   .map(|a_t| ast_ty_arg_to_ty(this, &binding_rscope, decl_generics,
                                               0, &region_substs, a_t))
                   .collect::<Vec<Ty<'tcx>>>();
568

A
Aaron Turon 已提交
569
    let input_params: Vec<_> = repeat(String::new()).take(inputs.len()).collect();
570 571 572
    let (implied_output_region,
         params_lifetimes) = find_implied_output_region(&*inputs, input_params);

573 574
    let input_ty = ty::mk_tup(this.tcx(), inputs);

575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591
    let (output, output_span) = match data.output {
        Some(ref output_ty) => {
            (convert_ty_with_lifetime_elision(this,
                                              implied_output_region,
                                              params_lifetimes,
                                              &**output_ty),
             output_ty.span)
        }
        None => {
            (ty::mk_nil(this.tcx()), data.span)
        }
    };

    let output_binding = ConvertedBinding {
        item_name: token::intern(FN_OUTPUT_NAME),
        ty: output,
        span: output_span
592 593
    };

594
    (region_substs, vec![input_ty], vec![output_binding])
595
}
596

597 598 599
pub fn instantiate_poly_trait_ref<'tcx>(
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
600 601
    ast_trait_ref: &ast::PolyTraitRef,
    self_ty: Option<Ty<'tcx>>,
602 603
    poly_projections: &mut Vec<ty::PolyProjectionPredicate<'tcx>>)
    -> ty::PolyTraitRef<'tcx>
604
{
605 606 607 608 609 610 611 612 613 614
    let trait_ref = &ast_trait_ref.trait_ref;
    let trait_def_id = trait_def_id(this, trait_ref);
    ast_path_to_poly_trait_ref(this,
                               rscope,
                               trait_ref.path.span,
                               PathParamMode::Explicit,
                               trait_def_id,
                               self_ty,
                               trait_ref.path.segments.last().unwrap(),
                               poly_projections)
615
}
616

617 618 619
/// Instantiates the path for the given trait reference, assuming that it's
/// bound to a valid trait type. Returns the def_id for the defining trait.
/// Fails if the type is a type other than a trait type.
620 621 622
///
/// If the `projections` argument is `None`, then assoc type bindings like `Foo<T=X>`
/// are disallowed. Otherwise, they are pushed onto the vector given.
623
pub fn instantiate_mono_trait_ref<'tcx>(
624 625
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
626
    trait_ref: &ast::TraitRef,
627
    self_ty: Option<Ty<'tcx>>)
628
    -> Rc<ty::TraitRef<'tcx>>
N
Niko Matsakis 已提交
629
{
630 631 632 633 634 635 636 637 638 639 640
    let trait_def_id = trait_def_id(this, trait_ref);
    ast_path_to_mono_trait_ref(this,
                               rscope,
                               trait_ref.path.span,
                               PathParamMode::Explicit,
                               trait_def_id,
                               self_ty,
                               trait_ref.path.segments.last().unwrap())
}

fn trait_def_id<'tcx>(this: &AstConv<'tcx>, trait_ref: &ast::TraitRef) -> ast::DefId {
641
    let path = &trait_ref.path;
642
    match ::lookup_full_def(this.tcx(), path.span, trait_ref.ref_id) {
643
        def::DefTrait(trait_def_id) => trait_def_id,
N
Niko Matsakis 已提交
644
        _ => {
645 646
            span_fatal!(this.tcx().sess, path.span, E0245, "`{}` is not a trait",
                        path.user_string(this.tcx()));
N
Niko Matsakis 已提交
647 648 649 650
        }
    }
}

651 652 653
fn object_path_to_poly_trait_ref<'a,'tcx>(
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
654
    span: Span,
655
    param_mode: PathParamMode,
656
    trait_def_id: ast::DefId,
657
    trait_segment: &ast::PathSegment,
658 659 660
    mut projections: &mut Vec<ty::PolyProjectionPredicate<'tcx>>)
    -> ty::PolyTraitRef<'tcx>
{
661 662 663 664 665 666 667 668
    ast_path_to_poly_trait_ref(this,
                               rscope,
                               span,
                               param_mode,
                               trait_def_id,
                               None,
                               trait_segment,
                               projections)
669 670
}

671
fn ast_path_to_poly_trait_ref<'a,'tcx>(
672 673
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
674
    span: Span,
675
    param_mode: PathParamMode,
676
    trait_def_id: ast::DefId,
677
    self_ty: Option<Ty<'tcx>>,
678
    trait_segment: &ast::PathSegment,
679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746
    poly_projections: &mut Vec<ty::PolyProjectionPredicate<'tcx>>)
    -> ty::PolyTraitRef<'tcx>
{
    // The trait reference introduces a binding level here, so
    // we need to shift the `rscope`. It'd be nice if we could
    // do away with this rscope stuff and work this knowledge
    // into resolve_lifetimes, as we do with non-omitted
    // lifetimes. Oh well, not there yet.
    let shifted_rscope = &ShiftedRscope::new(rscope);

    let (substs, assoc_bindings) =
        create_substs_for_ast_trait_ref(this,
                                        shifted_rscope,
                                        span,
                                        param_mode,
                                        trait_def_id,
                                        self_ty,
                                        trait_segment);
    let poly_trait_ref = ty::Binder(Rc::new(ty::TraitRef::new(trait_def_id, substs)));

    {
        let converted_bindings =
            assoc_bindings
            .iter()
            .filter_map(|binding| {
                // specify type to assert that error was already reported in Err case:
                let predicate: Result<_, ErrorReported> =
                    ast_type_binding_to_poly_projection_predicate(this,
                                                                  poly_trait_ref.clone(),
                                                                  self_ty,
                                                                  binding);
                predicate.ok() // ok to ignore Err() because ErrorReported (see above)
            });
        poly_projections.extend(converted_bindings);
    }

    poly_trait_ref
}

fn ast_path_to_mono_trait_ref<'a,'tcx>(this: &AstConv<'tcx>,
                                       rscope: &RegionScope,
                                       span: Span,
                                       param_mode: PathParamMode,
                                       trait_def_id: ast::DefId,
                                       self_ty: Option<Ty<'tcx>>,
                                       trait_segment: &ast::PathSegment)
                                       -> Rc<ty::TraitRef<'tcx>>
{
    let (substs, assoc_bindings) =
        create_substs_for_ast_trait_ref(this,
                                        rscope,
                                        span,
                                        param_mode,
                                        trait_def_id,
                                        self_ty,
                                        trait_segment);
    prohibit_projections(this.tcx(), &assoc_bindings);
    Rc::new(ty::TraitRef::new(trait_def_id, substs))
}

fn create_substs_for_ast_trait_ref<'a,'tcx>(this: &AstConv<'tcx>,
                                            rscope: &RegionScope,
                                            span: Span,
                                            param_mode: PathParamMode,
                                            trait_def_id: ast::DefId,
                                            self_ty: Option<Ty<'tcx>>,
                                            trait_segment: &ast::PathSegment)
                                            -> (&'tcx Substs<'tcx>, Vec<ConvertedBinding<'tcx>>)
747
{
748 749 750
    debug!("create_substs_for_ast_trait_ref(trait_segment={:?})",
           trait_segment);

751
    let trait_def = match this.get_trait_def(span, trait_def_id) {
752 753 754 755 756 757 758
        Ok(trait_def) => trait_def,
        Err(ErrorReported) => {
            // No convenient way to recover from a cycle here. Just bail. Sorry!
            this.tcx().sess.abort_if_errors();
            this.tcx().sess.bug("ErrorReported returned, but no errors reports?")
        }
    };
759

760
    let (regions, types, assoc_bindings) = match trait_segment.parameters {
761
        ast::AngleBracketedParameters(ref data) => {
762
            // For now, require that parenthetical notation be used
763
            // only with `Fn()` etc.
764
            if !this.tcx().sess.features.borrow().unboxed_closures && trait_def.paren_sugar {
765
                span_err!(this.tcx().sess, span, E0215,
766 767
                                         "angle-bracket notation is not stable when \
                                         used with the `Fn` family of traits, use parentheses");
768
                fileline_help!(this.tcx().sess, span,
769 770 771 772
                           "add `#![feature(unboxed_closures)]` to \
                            the crate attributes to enable");
            }

773
            convert_angle_bracketed_parameters(this, rscope, span, &trait_def.generics, data)
774 775
        }
        ast::ParenthesizedParameters(ref data) => {
776 777
            // For now, require that parenthetical notation be used
            // only with `Fn()` etc.
778
            if !this.tcx().sess.features.borrow().unboxed_closures && !trait_def.paren_sugar {
779
                span_err!(this.tcx().sess, span, E0216,
780 781
                                         "parenthetical notation is only stable when \
                                         used with the `Fn` family of traits");
782
                fileline_help!(this.tcx().sess, span,
783 784 785 786
                           "add `#![feature(unboxed_closures)]` to \
                            the crate attributes to enable");
            }

787
            convert_parenthesized_parameters(this, rscope, span, &trait_def.generics, data)
788 789 790 791
        }
    };

    let substs = create_substs_for_ast_path(this,
792
                                            span,
793
                                            param_mode,
794 795 796
                                            &trait_def.generics,
                                            self_ty,
                                            types,
797 798
                                            regions);

799
    (this.tcx().mk_substs(substs), assoc_bindings)
800
}
801

802
fn ast_type_binding_to_poly_projection_predicate<'tcx>(
803
    this: &AstConv<'tcx>,
804
    mut trait_ref: ty::PolyTraitRef<'tcx>,
805
    self_ty: Option<Ty<'tcx>>,
806
    binding: &ConvertedBinding<'tcx>)
807
    -> Result<ty::PolyProjectionPredicate<'tcx>, ErrorReported>
808
{
809 810
    let tcx = this.tcx();

811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826
    // Given something like `U : SomeTrait<T=X>`, we want to produce a
    // predicate like `<U as SomeTrait>::T = X`. This is somewhat
    // subtle in the event that `T` is defined in a supertrait of
    // `SomeTrait`, because in that case we need to upcast.
    //
    // That is, consider this case:
    //
    // ```
    // trait SubTrait : SuperTrait<int> { }
    // trait SuperTrait<A> { type T; }
    //
    // ... B : SubTrait<T=foo> ...
    // ```
    //
    // We want to produce `<B as SuperTrait<int>>::T == foo`.

827
    // Simple case: X is defined in the current trait.
828 829 830 831
    if this.trait_defines_associated_type_named(trait_ref.def_id(), binding.item_name) {
        return Ok(ty::Binder(ty::ProjectionPredicate {      // <-------------------+
            projection_ty: ty::ProjectionTy {               //                     |
                trait_ref: trait_ref.skip_binder().clone(), // Binder moved here --+
832 833 834
                item_name: binding.item_name,
            },
            ty: binding.ty,
835
        }));
836 837
    }

838 839 840 841 842 843 844 845 846 847
    // Otherwise, we have to walk through the supertraits to find
    // those that do.  This is complicated by the fact that, for an
    // object type, the `Self` type is not present in the
    // substitutions (after all, it's being constructed right now),
    // but the `supertraits` iterator really wants one. To handle
    // this, we currently insert a dummy type and then remove it
    // later. Yuck.

    let dummy_self_ty = ty::mk_infer(tcx, ty::FreshTy(0));
    if self_ty.is_none() { // if converting for an object type
848 849 850 851 852
        let mut dummy_substs = trait_ref.skip_binder().substs.clone(); // binder moved here -+
        assert!(dummy_substs.self_ty().is_none());                     //                    |
        dummy_substs.types.push(SelfSpace, dummy_self_ty);             //                    |
        trait_ref = ty::Binder(Rc::new(ty::TraitRef::new(trait_ref.def_id(), // <------------+
                                                         tcx.mk_substs(dummy_substs))));
853 854
    }

855
    try!(this.ensure_super_predicates(binding.span, trait_ref.def_id()));
856

857
    let mut candidates: Vec<ty::PolyTraitRef> =
858
        traits::supertraits(tcx, trait_ref.clone())
859
        .filter(|r| this.trait_defines_associated_type_named(r.def_id(), binding.item_name))
860
        .collect();
861

862 863 864
    // If converting for an object type, then remove the dummy-ty from `Self` now.
    // Yuckety yuck.
    if self_ty.is_none() {
865
        for candidate in &mut candidates {
866 867 868 869 870 871 872 873
            let mut dummy_substs = candidate.0.substs.clone();
            assert!(dummy_substs.self_ty() == Some(dummy_self_ty));
            dummy_substs.types.pop(SelfSpace);
            *candidate = ty::Binder(Rc::new(ty::TraitRef::new(candidate.def_id(),
                                                              tcx.mk_substs(dummy_substs))));
        }
    }

874
    if candidates.len() > 1 {
B
Brian Anderson 已提交
875 876
        span_err!(tcx.sess, binding.span, E0217,
            "ambiguous associated type: `{}` defined in multiple supertraits `{}`",
877
                    token::get_name(binding.item_name),
B
Brian Anderson 已提交
878
                    candidates.user_string(tcx));
879 880 881 882 883 884
        return Err(ErrorReported);
    }

    let candidate = match candidates.pop() {
        Some(c) => c,
        None => {
B
Brian Anderson 已提交
885 886
            span_err!(tcx.sess, binding.span, E0218,
                "no associated type `{}` defined in `{}`",
887
                        token::get_name(binding.item_name),
B
Brian Anderson 已提交
888
                        trait_ref.user_string(tcx));
889 890 891 892
            return Err(ErrorReported);
        }
    };

893 894 895
    Ok(ty::Binder(ty::ProjectionPredicate {             // <-------------------------+
        projection_ty: ty::ProjectionTy {               //                           |
            trait_ref: candidate.skip_binder().clone(), // binder is moved up here --+
896 897 898
            item_name: binding.item_name,
        },
        ty: binding.ty,
899
    }))
900 901
}

902
fn ast_path_to_ty<'tcx>(
903 904
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
905
    span: Span,
906
    param_mode: PathParamMode,
907
    did: ast::DefId,
908 909
    item_segment: &ast::PathSegment)
    -> Ty<'tcx>
910
{
911
    let tcx = this.tcx();
912
    let (generics, decl_ty) = match this.get_item_type_scheme(span, did) {
913
        Ok(ty::TypeScheme { generics,  ty: decl_ty }) => {
914
            (generics, decl_ty)
915 916
        }
        Err(ErrorReported) => {
917
            return tcx.types.err;
918 919
        }
    };
920

N
Nick Cameron 已提交
921 922 923 924 925 926
    let substs = ast_path_substs_for_ty(this,
                                        rscope,
                                        span,
                                        param_mode,
                                        &generics,
                                        item_segment);
927

928 929 930 931
    // FIXME(#12938): This is a hack until we have full support for DST.
    if Some(did) == this.tcx().lang_items.owned_box() {
        assert_eq!(substs.types.len(TypeSpace), 1);
        return ty::mk_uniq(this.tcx(), *substs.types.get(TypeSpace, 0));
932 933
    }

934
    decl_ty.subst(this.tcx(), &substs)
935 936
}

937 938
type TraitAndProjections<'tcx> = (ty::PolyTraitRef<'tcx>, Vec<ty::PolyProjectionPredicate<'tcx>>);

939 940 941 942 943
fn ast_ty_to_trait_ref<'tcx>(this: &AstConv<'tcx>,
                             rscope: &RegionScope,
                             ty: &ast::Ty,
                             bounds: &[ast::TyParamBound])
                             -> Result<TraitAndProjections<'tcx>, ErrorReported>
944
{
945 946 947 948 949 950 951 952 953 954
    /*!
     * In a type like `Foo + Send`, we want to wait to collect the
     * full set of bounds before we make the object type, because we
     * need them to infer a region bound.  (For example, if we tried
     * made a type from just `Foo`, then it wouldn't be enough to
     * infer a 'static bound, and hence the user would get an error.)
     * So this function is used when we're dealing with a sum type to
     * convert the LHS. It only accepts a type that refers to a trait
     * name, and reports an error otherwise.
     */
955

956
    match ty.node {
957
        ast::TyPath(None, ref path) => {
958 959 960 961
            let def = match this.tcx().def_map.borrow().get(&ty.id) {
                Some(&def::PathResolution { base_def, depth: 0, .. }) => Some(base_def),
                _ => None
            };
962 963
            match def {
                Some(def::DefTrait(trait_def_id)) => {
964
                    let mut projection_bounds = Vec::new();
965 966
                    let trait_ref = object_path_to_poly_trait_ref(this,
                                                                  rscope,
967
                                                                  path.span,
968
                                                                  PathParamMode::Explicit,
969
                                                                  trait_def_id,
970
                                                                  path.segments.last().unwrap(),
971
                                                                  &mut projection_bounds);
972
                    Ok((trait_ref, projection_bounds))
973 974
                }
                _ => {
975
                    span_err!(this.tcx().sess, ty.span, E0172, "expected a reference to a trait");
976 977 978
                    Err(ErrorReported)
                }
            }
979
        }
980
        _ => {
981
            span_err!(this.tcx().sess, ty.span, E0178,
982 983 984 985
                      "expected a path on the left-hand side of `+`, not `{}`",
                      pprust::ty_to_string(ty));
            match ty.node {
                ast::TyRptr(None, ref mut_ty) => {
986
                    fileline_help!(this.tcx().sess, ty.span,
C
Chris Morgan 已提交
987
                               "perhaps you meant `&{}({} +{})`? (per RFC 438)",
988 989 990
                               ppaux::mutability_to_string(mut_ty.mutbl),
                               pprust::ty_to_string(&*mut_ty.ty),
                               pprust::bounds_to_string(bounds));
991
                }
992
               ast::TyRptr(Some(ref lt), ref mut_ty) => {
993
                    fileline_help!(this.tcx().sess, ty.span,
C
Chris Morgan 已提交
994
                               "perhaps you meant `&{} {}({} +{})`? (per RFC 438)",
995 996 997 998 999 1000 1001
                               pprust::lifetime_to_string(lt),
                               ppaux::mutability_to_string(mut_ty.mutbl),
                               pprust::ty_to_string(&*mut_ty.ty),
                               pprust::bounds_to_string(bounds));
                }

                _ => {
1002
                    fileline_help!(this.tcx().sess, ty.span,
C
Chris Morgan 已提交
1003
                               "perhaps you forgot parentheses? (per RFC 438)");
1004 1005
                }
            }
1006
            Err(ErrorReported)
1007
        }
1008
    }
1009 1010
}

1011 1012 1013 1014 1015 1016 1017
fn trait_ref_to_object_type<'tcx>(this: &AstConv<'tcx>,
                                  rscope: &RegionScope,
                                  span: Span,
                                  trait_ref: ty::PolyTraitRef<'tcx>,
                                  projection_bounds: Vec<ty::PolyProjectionPredicate<'tcx>>,
                                  bounds: &[ast::TyParamBound])
                                  -> Ty<'tcx>
1018 1019 1020 1021
{
    let existential_bounds = conv_existential_bounds(this,
                                                     rscope,
                                                     span,
1022
                                                     trait_ref.clone(),
1023
                                                     projection_bounds,
1024 1025 1026 1027 1028 1029 1030
                                                     bounds);

    let result = ty::mk_trait(this.tcx(), trait_ref, existential_bounds);
    debug!("trait_ref_to_object_type: result={}",
           result.repr(this.tcx()));

    result
1031 1032
}

1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043
fn report_ambiguous_associated_type(tcx: &ty::ctxt,
                                    span: Span,
                                    type_str: &str,
                                    trait_str: &str,
                                    name: &str) {
    span_err!(tcx.sess, span, E0223,
              "ambiguous associated type; specify the type using the syntax \
               `<{} as {}>::{}`",
              type_str, trait_str, name);
}

N
Nick Cameron 已提交
1044 1045 1046 1047 1048 1049
// Create a type from a a path to an associated type.
// For a path A::B::C::D, ty and ty_path_def are the type and def for A::B::C
// and item_segment is the path segment for D. We return a type and a def for
// the whole path.
// Will fail except for T::A and Self::A; i.e., if ty/ty_path_def are not a type
// parameter or Self.
1050
fn associated_path_def_to_ty<'tcx>(this: &AstConv<'tcx>,
1051 1052 1053 1054 1055
                                   span: Span,
                                   ty: Ty<'tcx>,
                                   ty_path_def: def::Def,
                                   item_segment: &ast::PathSegment)
                                   -> (Ty<'tcx>, def::Def)
1056 1057
{
    let tcx = this.tcx();
1058 1059
    let assoc_name = item_segment.identifier.name;

N
Nick Cameron 已提交
1060
    debug!("associated_path_def_to_ty: {}::{}", ty.repr(tcx), token::get_name(assoc_name));
1061

N
Nick Cameron 已提交
1062
    check_path_args(tcx, slice::ref_slice(item_segment), NO_TPS | NO_REGIONS);
1063

N
Nick Cameron 已提交
1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078
    // Check that the path prefix given by ty/ty_path_def is a type parameter/Self.
    match (&ty.sty, ty_path_def) {
        (&ty::ty_param(_), def::DefTyParam(..)) |
        (&ty::ty_param(_), def::DefSelfTy(_)) => {}
        _ => {
            report_ambiguous_associated_type(tcx,
                                             span,
                                             &ty.user_string(tcx),
                                             "Trait",
                                             &token::get_name(assoc_name));
            return (tcx.types.err, ty_path_def);
        }
    }

    let ty_param_node_id = ty_path_def.local_node_id();
1079
    let ty_param_name = tcx.ty_param_defs.borrow().get(&ty_param_node_id).unwrap().name;
1080

1081 1082
    let bounds = match this.get_type_parameter_bounds(span, ty_param_node_id) {
        Ok(v) => v,
N
Nick Cameron 已提交
1083 1084 1085
        Err(ErrorReported) => {
            return (tcx.types.err, ty_path_def);
        }
1086 1087
    };

N
Nick Cameron 已提交
1088
    // Ensure the super predicates and stop if we encountered an error.
1089 1090 1091
    if bounds.iter().any(|b| this.ensure_super_predicates(span, b.def_id()).is_err()) {
        return (this.tcx().types.err, ty_path_def);
    }
1092

N
Nick Cameron 已提交
1093 1094
    // Check that there is exactly one way to find an associated type with the
    // correct name.
1095 1096
    let mut suitable_bounds: Vec<_> =
        traits::transitive_bounds(tcx, &bounds)
1097
        .filter(|b| this.trait_defines_associated_type_named(b.def_id(), assoc_name))
1098
        .collect();
1099 1100

    if suitable_bounds.len() == 0 {
1101
        span_err!(tcx.sess, span, E0220,
B
Brian Anderson 已提交
1102
                          "associated type `{}` not found for type parameter `{}`",
1103
                                  token::get_name(assoc_name),
B
Brian Anderson 已提交
1104
                                  token::get_name(ty_param_name));
1105
        return (this.tcx().types.err, ty_path_def);
1106 1107 1108
    }

    if suitable_bounds.len() > 1 {
1109
        span_err!(tcx.sess, span, E0221,
B
Brian Anderson 已提交
1110
                          "ambiguous associated type `{}` in bounds of `{}`",
1111
                                  token::get_name(assoc_name),
B
Brian Anderson 已提交
1112
                                  token::get_name(ty_param_name));
1113

1114
        for suitable_bound in &suitable_bounds {
1115
            span_note!(this.tcx().sess, span,
1116 1117 1118 1119 1120 1121 1122
                       "associated type `{}` could derive from `{}`",
                       token::get_name(ty_param_name),
                       suitable_bound.user_string(this.tcx()));
        }
    }

    let suitable_bound = suitable_bounds.pop().unwrap().clone();
1123 1124 1125 1126 1127 1128 1129 1130 1131
    let trait_did = suitable_bound.0.def_id;

    let ty = this.projected_ty_from_poly_trait_ref(span, suitable_bound, assoc_name);

    let item_did = if trait_did.krate == ast::LOCAL_CRATE {
        // `ty::trait_items` used below requires information generated
        // by type collection, which may be in progress at this point.
        match this.tcx().map.expect_item(trait_did.node).node {
            ast::ItemTrait(_, _, _, ref trait_items) => {
N
Nick Cameron 已提交
1132 1133
                let item = trait_items.iter()
                                      .find(|i| i.ident.name == assoc_name)
1134 1135
                                      .expect("missing associated type");
                ast_util::local_def(item.id)
1136 1137 1138 1139 1140 1141 1142 1143
            }
            _ => unreachable!()
        }
    } else {
        let trait_items = ty::trait_items(this.tcx(), trait_did);
        let item = trait_items.iter().find(|i| i.name() == assoc_name);
        item.expect("missing associated type").def_id()
    };
N
Nick Cameron 已提交
1144

1145
    (ty, def::DefAssociatedTy(trait_did, item_did))
1146 1147
}

1148 1149
fn qpath_to_ty<'tcx>(this: &AstConv<'tcx>,
                     rscope: &RegionScope,
1150
                     span: Span,
1151 1152
                     param_mode: PathParamMode,
                     opt_self_ty: Option<Ty<'tcx>>,
1153 1154 1155
                     trait_def_id: ast::DefId,
                     trait_segment: &ast::PathSegment,
                     item_segment: &ast::PathSegment)
1156
                     -> Ty<'tcx>
1157
{
1158
    let tcx = this.tcx();
1159

1160
    check_path_args(tcx, slice::ref_slice(item_segment), NO_TPS | NO_REGIONS);
1161

1162
    let self_ty = if let Some(ty) = opt_self_ty {
1163
        ty
1164 1165
    } else {
        let path_str = ty::item_path_str(tcx, trait_def_id);
N
Nick Cameron 已提交
1166 1167 1168 1169 1170
        report_ambiguous_associated_type(tcx,
                                         span,
                                         "Type",
                                         &path_str,
                                         &token::get_ident(item_segment.identifier));
1171 1172
        return tcx.types.err;
    };
1173

1174
    debug!("qpath_to_ty: self_type={}", self_ty.repr(tcx));
1175

1176 1177 1178 1179 1180 1181 1182 1183
    let trait_ref =
        ast_path_to_mono_trait_ref(this,
                                   rscope,
                                   span,
                                   param_mode,
                                   trait_def_id,
                                   Some(self_ty),
                                   trait_segment);
1184

1185
    debug!("qpath_to_ty: trait_ref={}", trait_ref.repr(tcx));
1186

1187
    this.projected_ty(span, trait_ref, item_segment.identifier.name)
1188 1189
}

1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222
/// Convert a type supplied as value for a type argument from AST into our
/// our internal representation. This is the same as `ast_ty_to_ty` but that
/// it applies the object lifetime default.
///
/// # Parameters
///
/// * `this`, `rscope`: the surrounding context
/// * `decl_generics`: the generics of the struct/enum/trait declaration being
///   referenced
/// * `index`: the index of the type parameter being instantiated from the list
///   (we assume it is in the `TypeSpace`)
/// * `region_substs`: a partial substitution consisting of
///   only the region type parameters being supplied to this type.
/// * `ast_ty`: the ast representation of the type being supplied
pub fn ast_ty_arg_to_ty<'tcx>(this: &AstConv<'tcx>,
                              rscope: &RegionScope,
                              decl_generics: &ty::Generics<'tcx>,
                              index: usize,
                              region_substs: &Substs<'tcx>,
                              ast_ty: &ast::Ty)
                              -> Ty<'tcx>
{
    let tcx = this.tcx();

    if let Some(def) = decl_generics.types.opt_get(TypeSpace, index) {
        let object_lifetime_default = def.object_lifetime_default.subst(tcx, region_substs);
        let rscope1 = &ObjectLifetimeDefaultRscope::new(rscope, object_lifetime_default);
        ast_ty_to_ty(this, rscope1, ast_ty)
    } else {
        ast_ty_to_ty(this, rscope, ast_ty)
    }
}

N
Nick Cameron 已提交
1223 1224
// Note that both base_segments and assoc_segments may be empty, although not at
// the same time.
1225 1226 1227 1228
pub fn finish_resolving_def_to_ty<'tcx>(this: &AstConv<'tcx>,
                                        rscope: &RegionScope,
                                        span: Span,
                                        param_mode: PathParamMode,
N
Nick Cameron 已提交
1229
                                        def: &def::Def,
1230
                                        opt_self_ty: Option<Ty<'tcx>>,
N
Nick Cameron 已提交
1231
                                        base_segments: &[ast::PathSegment],
1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246
                                        assoc_segments: &[ast::PathSegment])
                                        -> Ty<'tcx> {
    let tcx = this.tcx();

    let base_ty = match *def {
        def::DefTrait(trait_def_id) => {
            // N.B. this case overlaps somewhat with
            // TyObjectSum, see that fn for details
            let mut projection_bounds = Vec::new();

            let trait_ref = object_path_to_poly_trait_ref(this,
                                                          rscope,
                                                          span,
                                                          param_mode,
                                                          trait_def_id,
N
Nick Cameron 已提交
1247
                                                          base_segments.last().unwrap(),
1248 1249
                                                          &mut projection_bounds);

N
Nick Cameron 已提交
1250 1251 1252 1253 1254 1255 1256
            check_path_args(tcx, base_segments.init(), NO_TPS | NO_REGIONS);
            trait_ref_to_object_type(this,
                                     rscope,
                                     span,
                                     trait_ref,
                                     projection_bounds,
                                     &[])
1257 1258
        }
        def::DefTy(did, _) | def::DefStruct(did) => {
N
Nick Cameron 已提交
1259
            check_path_args(tcx, base_segments.init(), NO_TPS | NO_REGIONS);
1260 1261
            ast_path_to_ty(this, rscope, span,
                           param_mode, did,
N
Nick Cameron 已提交
1262
                           base_segments.last().unwrap())
1263 1264
        }
        def::DefTyParam(space, index, _, name) => {
N
Nick Cameron 已提交
1265
            check_path_args(tcx, base_segments, NO_TPS | NO_REGIONS);
1266 1267 1268
            ty::mk_param(tcx, space, index, name)
        }
        def::DefSelfTy(_) => {
N
Nick Cameron 已提交
1269
            // N.b.: resolve guarantees that the this type only appears in a
1270
            // trait, which we rely upon in various places when creating
N
Nick Cameron 已提交
1271 1272
            // substs.
            check_path_args(tcx, base_segments, NO_TPS | NO_REGIONS);
1273 1274 1275
            ty::mk_self_type(tcx)
        }
        def::DefAssociatedTy(trait_did, _) => {
N
Nick Cameron 已提交
1276 1277 1278 1279 1280 1281 1282 1283 1284
            check_path_args(tcx, &base_segments[..base_segments.len()-2], NO_TPS | NO_REGIONS);
            qpath_to_ty(this,
                        rscope,
                        span,
                        param_mode,
                        opt_self_ty,
                        trait_did,
                        &base_segments[base_segments.len()-2],
                        base_segments.last().unwrap())
1285 1286
        }
        def::DefMod(id) => {
1287 1288 1289 1290
            // Used as sentinel by callers to indicate the `<T>::A::B::C` form.
            // FIXME(#22519) This part of the resolution logic should be
            // avoided entirely for that form, once we stop needed a Def
            // for `associated_path_def_to_ty`.
N
Nick Cameron 已提交
1291 1292 1293 1294 1295 1296

            if !base_segments.is_empty() {
                span_err!(tcx.sess,
                          span,
                          E0247,
                          "found module name used as a type: {}",
1297 1298
                          tcx.map.node_to_string(id.node));
                return this.tcx().types.err;
1299
            }
N
Nick Cameron 已提交
1300 1301

            opt_self_ty.expect("missing T in <T>::a::b::c")
1302 1303
        }
        def::DefPrimTy(prim_ty) => {
N
Nick Cameron 已提交
1304
            prim_ty_to_ty(tcx, base_segments, prim_ty)
1305 1306
        }
        _ => {
1307 1308 1309
            span_err!(tcx.sess, span, E0248,
                      "found value name used as a type: {:?}", *def);
            return this.tcx().types.err;
1310 1311 1312 1313 1314
        }
    };

    // If any associated type segments remain, attempt to resolve them.
    let mut ty = base_ty;
N
Nick Cameron 已提交
1315
    let mut def = *def;
1316 1317 1318 1319 1320
    for segment in assoc_segments {
        if ty.sty == ty::ty_err {
            break;
        }
        // This is pretty bad (it will fail except for T::A and Self::A).
N
Nick Cameron 已提交
1321 1322 1323 1324 1325
        let (a_ty, a_def) = associated_path_def_to_ty(this,
                                                      span,
                                                      ty,
                                                      def,
                                                      segment);
1326
        ty = a_ty;
N
Nick Cameron 已提交
1327
        def = a_def;
1328 1329 1330 1331
    }
    ty
}

1332 1333 1334 1335 1336 1337
/// Parses the programmer's textual representation of a type into our
/// internal notion of a type.
pub fn ast_ty_to_ty<'tcx>(this: &AstConv<'tcx>,
                          rscope: &RegionScope,
                          ast_ty: &ast::Ty)
                          -> Ty<'tcx>
1338 1339 1340
{
    debug!("ast_ty_to_ty(ast_ty={})",
           ast_ty.repr(this.tcx()));
1341

1342
    let tcx = this.tcx();
1343

1344 1345
    if let Some(&ty) = tcx.ast_ty_to_ty_cache.borrow().get(&ast_ty.id) {
        return ty;
1346 1347
    }

1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360
    let typ = match ast_ty.node {
        ast::TyVec(ref ty) => {
            ty::mk_vec(tcx, ast_ty_to_ty(this, rscope, &**ty), None)
        }
        ast::TyObjectSum(ref ty, ref bounds) => {
            match ast_ty_to_trait_ref(this, rscope, &**ty, bounds) {
                Ok((trait_ref, projection_bounds)) => {
                    trait_ref_to_object_type(this,
                                             rscope,
                                             ast_ty.span,
                                             trait_ref,
                                             projection_bounds,
                                             bounds)
1361
                }
1362 1363
                Err(ErrorReported) => {
                    this.tcx().types.err
1364 1365
                }
            }
1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393
        }
        ast::TyPtr(ref mt) => {
            ty::mk_ptr(tcx, ty::mt {
                ty: ast_ty_to_ty(this, rscope, &*mt.ty),
                mutbl: mt.mutbl
            })
        }
        ast::TyRptr(ref region, ref mt) => {
            let r = opt_ast_region_to_region(this, rscope, ast_ty.span, region);
            debug!("ty_rptr r={}", r.repr(this.tcx()));
            let rscope1 =
                &ObjectLifetimeDefaultRscope::new(
                    rscope,
                    Some(ty::ObjectLifetimeDefault::Specific(r)));
            let t = ast_ty_to_ty(this, rscope1, &*mt.ty);
            ty::mk_rptr(tcx, tcx.mk_region(r), ty::mt {ty: t, mutbl: mt.mutbl})
        }
        ast::TyTup(ref fields) => {
            let flds = fields.iter()
                             .map(|t| ast_ty_to_ty(this, rscope, &**t))
                             .collect();
            ty::mk_tup(tcx, flds)
        }
        ast::TyParen(ref typ) => ast_ty_to_ty(this, rscope, &**typ),
        ast::TyBareFn(ref bf) => {
            if bf.decl.variadic && bf.abi != abi::C {
                span_err!(tcx.sess, ast_ty.span, E0222,
                          "variadic function must have C calling convention");
N
Niko Matsakis 已提交
1394
            }
1395 1396 1397 1398 1399 1400
            let bare_fn = ty_of_bare_fn(this, bf.unsafety, bf.abi, &*bf.decl);
            ty::mk_bare_fn(tcx, None, tcx.mk_bare_fn(bare_fn))
        }
        ast::TyPolyTraitRef(ref bounds) => {
            conv_ty_poly_trait_ref(this, rscope, ast_ty.span, bounds)
        }
1401
        ast::TyPath(ref maybe_qself, ref path) => {
1402 1403
            let path_res = if let Some(&d) = tcx.def_map.borrow().get(&ast_ty.id) {
                d
1404 1405 1406 1407 1408 1409 1410
            } else if let Some(ast::QSelf { position: 0, .. }) = *maybe_qself {
                // Create some fake resolution that can't possibly be a type.
                def::PathResolution {
                    base_def: def::DefMod(ast_util::local_def(ast::CRATE_NODE_ID)),
                    last_private: LastMod(AllPublic),
                    depth: path.segments.len()
                }
1411 1412 1413 1414
            } else {
                tcx.sess.span_bug(ast_ty.span,
                                  &format!("unbound path {}", ast_ty.repr(tcx)))
            };
N
Nick Cameron 已提交
1415
            let def = path_res.base_def;
1416
            let base_ty_end = path.segments.len() - path_res.depth;
1417 1418 1419
            let opt_self_ty = maybe_qself.as_ref().map(|qself| {
                ast_ty_to_ty(this, rscope, &qself.ty)
            });
N
Nick Cameron 已提交
1420 1421 1422 1423 1424
            let ty = finish_resolving_def_to_ty(this,
                                                rscope,
                                                ast_ty.span,
                                                PathParamMode::Explicit,
                                                &def,
1425 1426 1427
                                                opt_self_ty,
                                                &path.segments[..base_ty_end],
                                                &path.segments[base_ty_end..]);
1428

1429
            if path_res.depth != 0 && ty.sty != ty::ty_err {
1430
                // Write back the new resolution.
1431 1432 1433 1434 1435
                tcx.def_map.borrow_mut().insert(ast_ty.id, def::PathResolution {
                    base_def: def,
                    last_private: path_res.last_private,
                    depth: 0
                });
1436 1437 1438 1439 1440
            }

            ty
        }
        ast::TyFixedLengthVec(ref ty, ref e) => {
1441
            match const_eval::eval_const_expr_partial(tcx, &**e, Some(tcx.types.usize)) {
1442 1443 1444 1445
                Ok(r) => {
                    match r {
                        const_eval::const_int(i) =>
                            ty::mk_vec(tcx, ast_ty_to_ty(this, rscope, &**ty),
1446
                                        Some(i as usize)),
1447 1448
                        const_eval::const_uint(i) =>
                            ty::mk_vec(tcx, ast_ty_to_ty(this, rscope, &**ty),
1449
                                        Some(i as usize)),
1450
                        _ => {
1451 1452 1453
                            span_err!(tcx.sess, ast_ty.span, E0249,
                                      "expected constant expr for array length");
                            this.tcx().types.err
1454 1455
                        }
                    }
1456
                }
1457 1458 1459
                Err(ref r) => {
                    let subspan  =
                        ast_ty.span.lo <= r.span.lo && r.span.hi <= ast_ty.span.hi;
1460
                    span_err!(tcx.sess, r.span, E0250,
1461
                              "array length constant evaluation error: {}",
1462
                              r.description());
1463 1464 1465 1466
                    if !subspan {
                        span_note!(tcx.sess, ast_ty.span, "for array length here")
                    }
                    this.tcx().types.err
1467 1468
                }
            }
1469
        }
1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480
        ast::TyTypeof(ref _e) => {
            tcx.sess.span_bug(ast_ty.span, "typeof is reserved but unimplemented");
        }
        ast::TyInfer => {
            // TyInfer also appears as the type of arguments or return
            // values in a ExprClosure, or as
            // the type of local variables. Both of these cases are
            // handled specially and will not descend into this routine.
            this.ty_infer(ast_ty.span)
        }
    };
1481

1482
    tcx.ast_ty_to_ty_cache.borrow_mut().insert(ast_ty.id, typ);
B
Brian Anderson 已提交
1483
    return typ;
1484 1485
}

1486 1487 1488 1489 1490 1491
pub fn ty_of_arg<'tcx>(this: &AstConv<'tcx>,
                       rscope: &RegionScope,
                       a: &ast::Arg,
                       expected_ty: Option<Ty<'tcx>>)
                       -> Ty<'tcx>
{
E
Erick Tryzelaar 已提交
1492
    match a.ty.node {
1493 1494
        ast::TyInfer if expected_ty.is_some() => expected_ty.unwrap(),
        ast::TyInfer => this.ty_infer(a.ty.span),
1495
        _ => ast_ty_to_ty(this, rscope, &*a.ty),
1496
    }
1497 1498
}

1499 1500
struct SelfInfo<'a, 'tcx> {
    untransformed_self_ty: Ty<'tcx>,
1501
    explicit_self: &'a ast::ExplicitSelf,
1502 1503
}

1504
pub fn ty_of_method<'tcx>(this: &AstConv<'tcx>,
1505 1506
                          sig: &ast::MethodSig,
                          untransformed_self_ty: Ty<'tcx>)
1507
                          -> (ty::BareFnTy<'tcx>, ty::ExplicitSelfCategory) {
1508
    let self_info = Some(SelfInfo {
1509
        untransformed_self_ty: untransformed_self_ty,
1510
        explicit_self: &sig.explicit_self,
1511 1512 1513
    });
    let (bare_fn_ty, optional_explicit_self_category) =
        ty_of_method_or_bare_fn(this,
1514 1515
                                sig.unsafety,
                                sig.abi,
1516
                                self_info,
1517
                                &sig.decl);
1518
    (bare_fn_ty, optional_explicit_self_category.unwrap())
1519 1520
}

1521
pub fn ty_of_bare_fn<'tcx>(this: &AstConv<'tcx>, unsafety: ast::Unsafety, abi: abi::Abi,
1522
                                              decl: &ast::FnDecl) -> ty::BareFnTy<'tcx> {
N
Niko Matsakis 已提交
1523
    let (bare_fn_ty, _) = ty_of_method_or_bare_fn(this, unsafety, abi, None, decl);
1524
    bare_fn_ty
1525 1526
}

1527 1528 1529 1530 1531 1532
fn ty_of_method_or_bare_fn<'a, 'tcx>(this: &AstConv<'tcx>,
                                     unsafety: ast::Unsafety,
                                     abi: abi::Abi,
                                     opt_self_info: Option<SelfInfo<'a, 'tcx>>,
                                     decl: &ast::FnDecl)
                                     -> (ty::BareFnTy<'tcx>, Option<ty::ExplicitSelfCategory>)
1533
{
1534
    debug!("ty_of_method_or_bare_fn");
1535

1536 1537
    // New region names that appear inside of the arguments of the function
    // declaration are bound to that function type.
1538
    let rb = rscope::BindingRscope::new();
1539

1540 1541 1542 1543 1544
    // `implied_output_region` is the region that will be assumed for any
    // region parameters in the return type. In accordance with the rules for
    // lifetime elision, we can determine it in two ways. First (determined
    // here), if self is by-reference, then the implied output region is the
    // region of the self parameter.
1545
    let mut explicit_self_category_result = None;
1546 1547 1548
    let (self_ty, mut implied_output_region) = match opt_self_info {
        None => (None, None),
        Some(self_info) => {
1549 1550 1551
            // This type comes from an impl or trait; no late-bound
            // regions should be present.
            assert!(!self_info.untransformed_self_ty.has_escaping_regions());
1552

1553 1554 1555 1556 1557
            // Figure out and record the explicit self category.
            let explicit_self_category =
                determine_explicit_self_category(this, &rb, &self_info);
            explicit_self_category_result = Some(explicit_self_category);
            match explicit_self_category {
1558 1559 1560
                ty::StaticExplicitSelfCategory => {
                    (None, None)
                }
1561
                ty::ByValueExplicitSelfCategory => {
1562
                    (Some(self_info.untransformed_self_ty), None)
1563 1564 1565
                }
                ty::ByReferenceExplicitSelfCategory(region, mutability) => {
                    (Some(ty::mk_rptr(this.tcx(),
H
Huon Wilson 已提交
1566
                                      this.tcx().mk_region(region),
1567
                                      ty::mt {
1568
                                        ty: self_info.untransformed_self_ty,
1569 1570 1571 1572 1573
                                        mutbl: mutability
                                      })),
                     Some(region))
                }
                ty::ByBoxExplicitSelfCategory => {
1574
                    (Some(ty::mk_uniq(this.tcx(), self_info.untransformed_self_ty)), None)
1575
                }
1576 1577
            }
        }
1578
    };
1579 1580

    // HACK(eddyb) replace the fake self type in the AST with the actual type.
1581
    let input_params = if self_ty.is_some() {
A
Aaron Turon 已提交
1582
        &decl.inputs[1..]
1583
    } else {
1584
        &decl.inputs[..]
1585
    };
1586 1587 1588 1589
    let input_tys = input_params.iter().map(|a| ty_of_arg(this, &rb, a, None));
    let input_pats: Vec<String> = input_params.iter()
                                              .map(|a| pprust::pat_to_string(&*a.pat))
                                              .collect();
1590
    let self_and_input_tys: Vec<Ty> =
A
Aaron Turon 已提交
1591
        self_ty.into_iter().chain(input_tys).collect();
1592

1593

1594 1595 1596
    // Second, if there was exactly one lifetime (either a substitution or a
    // reference) in the arguments, then any anonymous regions in the output
    // have that lifetime.
1597 1598
    let lifetimes_for_params = if implied_output_region.is_none() {
        let input_tys = if self_ty.is_some() {
1599
            // Skip the first argument if `self` is present.
A
Aaron Turon 已提交
1600
            &self_and_input_tys[1..]
1601
        } else {
1602
            &self_and_input_tys[..]
1603
        };
1604

1605 1606 1607 1608 1609 1610
        let (ior, lfp) = find_implied_output_region(input_tys, input_pats);
        implied_output_region = ior;
        lfp
    } else {
        vec![]
    };
1611

1612 1613 1614 1615
    let output_ty = match decl.output {
        ast::Return(ref output) if output.node == ast::TyInfer =>
            ty::FnConverging(this.ty_infer(output.span)),
        ast::Return(ref output) =>
1616 1617 1618 1619
            ty::FnConverging(convert_ty_with_lifetime_elision(this,
                                                              implied_output_region,
                                                              lifetimes_for_params,
                                                              &**output)),
1620 1621
        ast::DefaultReturn(..) => ty::FnConverging(ty::mk_nil(this.tcx())),
        ast::NoReturn(..) => ty::FnDiverging
1622 1623
    };

1624
    (ty::BareFnTy {
N
Niko Matsakis 已提交
1625
        unsafety: unsafety,
1626
        abi: abi,
1627
        sig: ty::Binder(ty::FnSig {
1628 1629 1630
            inputs: self_and_input_tys,
            output: output_ty,
            variadic: decl.variadic
1631
        }),
1632 1633 1634
    }, explicit_self_category_result)
}

1635 1636 1637 1638
fn determine_explicit_self_category<'a, 'tcx>(this: &AstConv<'tcx>,
                                              rscope: &RegionScope,
                                              self_info: &SelfInfo<'a, 'tcx>)
                                              -> ty::ExplicitSelfCategory
1639 1640
{
    return match self_info.explicit_self.node {
1641 1642 1643 1644 1645 1646 1647 1648 1649 1650
        ast::SelfStatic => ty::StaticExplicitSelfCategory,
        ast::SelfValue(_) => ty::ByValueExplicitSelfCategory,
        ast::SelfRegion(ref lifetime, mutability, _) => {
            let region =
                opt_ast_region_to_region(this,
                                         rscope,
                                         self_info.explicit_self.span,
                                         lifetime);
            ty::ByReferenceExplicitSelfCategory(region, mutability)
        }
1651 1652
        ast::SelfExplicit(ref ast_type, _) => {
            let explicit_type = ast_ty_to_ty(this, rscope, &**ast_type);
1653

1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696
            // We wish to (for now) categorize an explicit self
            // declaration like `self: SomeType` into either `self`,
            // `&self`, `&mut self`, or `Box<self>`. We do this here
            // by some simple pattern matching. A more precise check
            // is done later in `check_method_self_type()`.
            //
            // Examples:
            //
            // ```
            // impl Foo for &T {
            //     // Legal declarations:
            //     fn method1(self: &&T); // ByReferenceExplicitSelfCategory
            //     fn method2(self: &T); // ByValueExplicitSelfCategory
            //     fn method3(self: Box<&T>); // ByBoxExplicitSelfCategory
            //
            //     // Invalid cases will be caught later by `check_method_self_type`:
            //     fn method_err1(self: &mut T); // ByReferenceExplicitSelfCategory
            // }
            // ```
            //
            // To do the check we just count the number of "modifiers"
            // on each type and compare them. If they are the same or
            // the impl has more, we call it "by value". Otherwise, we
            // look at the outermost modifier on the method decl and
            // call it by-ref, by-box as appropriate. For method1, for
            // example, the impl type has one modifier, but the method
            // type has two, so we end up with
            // ByReferenceExplicitSelfCategory.

            let impl_modifiers = count_modifiers(self_info.untransformed_self_ty);
            let method_modifiers = count_modifiers(explicit_type);

            debug!("determine_explicit_self_category(self_info.untransformed_self_ty={} \
                   explicit_type={} \
                   modifiers=({},{})",
                   self_info.untransformed_self_ty.repr(this.tcx()),
                   explicit_type.repr(this.tcx()),
                   impl_modifiers,
                   method_modifiers);

            if impl_modifiers >= method_modifiers {
                ty::ByValueExplicitSelfCategory
            } else {
1697
                match explicit_type.sty {
H
Huon Wilson 已提交
1698
                    ty::ty_rptr(r, mt) => ty::ByReferenceExplicitSelfCategory(*r, mt.mutbl),
1699 1700
                    ty::ty_uniq(_) => ty::ByBoxExplicitSelfCategory,
                    _ => ty::ByValueExplicitSelfCategory,
1701 1702
                }
            }
1703 1704
        }
    };
1705

1706
    fn count_modifiers(ty: Ty) -> usize {
1707
        match ty.sty {
1708 1709 1710
            ty::ty_rptr(_, mt) => count_modifiers(mt.ty) + 1,
            ty::ty_uniq(t) => count_modifiers(t) + 1,
            _ => 0,
1711 1712
        }
    }
1713 1714
}

1715 1716
pub fn ty_of_closure<'tcx>(
    this: &AstConv<'tcx>,
N
Niko Matsakis 已提交
1717
    unsafety: ast::Unsafety,
1718
    decl: &ast::FnDecl,
1719
    abi: abi::Abi,
1720 1721
    expected_sig: Option<ty::FnSig<'tcx>>)
    -> ty::ClosureTy<'tcx>
1722
{
1723 1724
    debug!("ty_of_closure(expected_sig={})",
           expected_sig.repr(this.tcx()));
1725 1726 1727

    // new region names that appear inside of the fn decl are bound to
    // that function type
1728
    let rb = rscope::BindingRscope::new();
1729

1730
    let input_tys: Vec<_> = decl.inputs.iter().enumerate().map(|(i, a)| {
1731
        let expected_arg_ty = expected_sig.as_ref().and_then(|e| {
1732 1733
            // no guarantee that the correct number of expected args
            // were supplied
1734
            if i < e.inputs.len() {
1735
                Some(e.inputs[i])
1736 1737 1738
            } else {
                None
            }
1739
        });
J
James Miller 已提交
1740
        ty_of_arg(this, &rb, a, expected_arg_ty)
1741
    }).collect();
1742

1743
    let expected_ret_ty = expected_sig.map(|e| e.output);
J
Jakub Bukaj 已提交
1744

1745 1746 1747 1748 1749 1750
    let is_infer = match decl.output {
        ast::Return(ref output) if output.node == ast::TyInfer => true,
        ast::DefaultReturn(..) => true,
        _ => false
    };

1751
    let output_ty = match decl.output {
1752
        _ if is_infer && expected_ret_ty.is_some() =>
1753
            expected_ret_ty.unwrap(),
1754 1755
        _ if is_infer =>
            ty::FnConverging(this.ty_infer(decl.output.span())),
1756 1757
        ast::Return(ref output) =>
            ty::FnConverging(ast_ty_to_ty(this, &rb, &**output)),
1758 1759
        ast::DefaultReturn(..) => unreachable!(),
        ast::NoReturn(..) => ty::FnDiverging
1760 1761
    };

1762 1763 1764
    debug!("ty_of_closure: input_tys={}", input_tys.repr(this.tcx()));
    debug!("ty_of_closure: output_ty={}", output_ty.repr(this.tcx()));

1765
    ty::ClosureTy {
N
Niko Matsakis 已提交
1766
        unsafety: unsafety,
1767
        abi: abi,
1768 1769 1770
        sig: ty::Binder(ty::FnSig {inputs: input_tys,
                                   output: output_ty,
                                   variadic: decl.variadic}),
1771 1772
    }
}
1773

S
Steve Klabnik 已提交
1774 1775 1776 1777
/// Given an existential type like `Foo+'a+Bar`, this routine converts the `'a` and `Bar` intos an
/// `ExistentialBounds` struct. The `main_trait_refs` argument specifies the `Foo` -- it is absent
/// for closures. Eventually this should all be normalized, I think, so that there is no "main
/// trait ref" and instead we just have a flat list of bounds as the existential type.
1778
fn conv_existential_bounds<'tcx>(
1779 1780
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
1781
    span: Span,
1782
    principal_trait_ref: ty::PolyTraitRef<'tcx>,
1783
    projection_bounds: Vec<ty::PolyProjectionPredicate<'tcx>>,
1784
    ast_bounds: &[ast::TyParamBound])
1785
    -> ty::ExistentialBounds<'tcx>
1786
{
1787
    let partitioned_bounds =
1788
        partition_bounds(this.tcx(), span, ast_bounds);
1789 1790

    conv_existential_bounds_from_partitioned_bounds(
1791
        this, rscope, span, principal_trait_ref, projection_bounds, partitioned_bounds)
1792 1793
}

1794 1795 1796
fn conv_ty_poly_trait_ref<'tcx>(
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
1797 1798
    span: Span,
    ast_bounds: &[ast::TyParamBound])
1799
    -> Ty<'tcx>
1800
{
1801
    let mut partitioned_bounds = partition_bounds(this.tcx(), span, &ast_bounds[..]);
1802

1803
    let mut projection_bounds = Vec::new();
A
Aaron Turon 已提交
1804 1805
    let main_trait_bound = if !partitioned_bounds.trait_bounds.is_empty() {
        let trait_bound = partitioned_bounds.trait_bounds.remove(0);
1806 1807 1808 1809 1810
        instantiate_poly_trait_ref(this,
                                   rscope,
                                   trait_bound,
                                   None,
                                   &mut projection_bounds)
A
Aaron Turon 已提交
1811
    } else {
B
Brian Anderson 已提交
1812
        span_err!(this.tcx().sess, span, E0224,
1813 1814
                  "at least one non-builtin trait is required for an object type");
        return this.tcx().types.err;
1815 1816
    };

1817 1818 1819 1820
    let bounds =
        conv_existential_bounds_from_partitioned_bounds(this,
                                                        rscope,
                                                        span,
1821
                                                        main_trait_bound.clone(),
1822
                                                        projection_bounds,
1823
                                                        partitioned_bounds);
1824

1825
    ty::mk_trait(this.tcx(), main_trait_bound, bounds)
1826 1827
}

1828 1829 1830
pub fn conv_existential_bounds_from_partitioned_bounds<'tcx>(
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
1831
    span: Span,
1832
    principal_trait_ref: ty::PolyTraitRef<'tcx>,
1833
    mut projection_bounds: Vec<ty::PolyProjectionPredicate<'tcx>>, // Empty for boxed closures
1834
    partitioned_bounds: PartitionedBounds)
1835
    -> ty::ExistentialBounds<'tcx>
1836
{
1837 1838
    let PartitionedBounds { builtin_bounds,
                            trait_bounds,
1839
                            region_bounds } =
1840
        partitioned_bounds;
1841 1842

    if !trait_bounds.is_empty() {
1843
        let b = &trait_bounds[0];
B
Brian Anderson 已提交
1844
        span_err!(this.tcx().sess, b.trait_ref.path.span, E0225,
1845
                  "only the builtin traits can be used as closure or object bounds");
1846 1847
    }

1848 1849 1850 1851 1852 1853
    let region_bound = compute_object_lifetime_bound(this,
                                                     rscope,
                                                     span,
                                                     &region_bounds,
                                                     principal_trait_ref,
                                                     builtin_bounds);
1854

1855
    ty::sort_bounds_list(&mut projection_bounds);
1856

1857 1858 1859
    ty::ExistentialBounds {
        region_bound: region_bound,
        builtin_bounds: builtin_bounds,
1860
        projection_bounds: projection_bounds,
1861 1862 1863
    }
}

1864
/// Given the bounds on an object, determines what single region bound
S
Steve Klabnik 已提交
1865 1866 1867
/// (if any) we can use to summarize this type. The basic idea is that we will use the bound the
/// user provided, if they provided one, and otherwise search the supertypes of trait bounds for
/// region bounds. It may be that we can derive no bound at all, in which case we return `None`.
1868 1869 1870 1871 1872 1873 1874 1875
fn compute_object_lifetime_bound<'tcx>(
    this: &AstConv<'tcx>,
    rscope: &RegionScope,
    span: Span,
    explicit_region_bounds: &[&ast::Lifetime],
    principal_trait_ref: ty::PolyTraitRef<'tcx>,
    builtin_bounds: ty::BuiltinBounds)
    -> ty::Region
1876
{
1877 1878
    let tcx = this.tcx();

1879
    debug!("compute_opt_region_bound(explicit_region_bounds={:?}, \
1880 1881 1882 1883 1884 1885
           principal_trait_ref={}, builtin_bounds={})",
           explicit_region_bounds,
           principal_trait_ref.repr(tcx),
           builtin_bounds.repr(tcx));

    if explicit_region_bounds.len() > 1 {
B
Brian Anderson 已提交
1886 1887
        span_err!(tcx.sess, explicit_region_bounds[1].span, E0226,
            "only a single explicit lifetime bound is permitted");
1888 1889
    }

1890
    if explicit_region_bounds.len() != 0 {
1891
        // Explicitly specified region bound. Use that.
1892
        let r = explicit_region_bounds[0];
1893
        return ast_region_to_region(tcx, r);
1894 1895
    }

1896 1897 1898 1899
    if let Err(ErrorReported) = this.ensure_super_predicates(span,principal_trait_ref.def_id()) {
        return ty::ReStatic;
    }

1900 1901 1902
    // No explicit region bound specified. Therefore, examine trait
    // bounds and see if we can derive region bounds from those.
    let derived_region_bounds =
1903
        object_region_bounds(tcx, &principal_trait_ref, builtin_bounds);
1904 1905 1906 1907

    // If there are no derived region bounds, then report back that we
    // can find no region bound.
    if derived_region_bounds.len() == 0 {
1908 1909 1910 1911 1912 1913 1914 1915 1916
        match rscope.object_lifetime_default(span) {
            Some(r) => { return r; }
            None => {
                span_err!(this.tcx().sess, span, E0228,
                          "the lifetime bound for this object type cannot be deduced \
                           from context; please supply an explicit bound");
                return ty::ReStatic;
            }
        }
1917 1918 1919 1920 1921
    }

    // If any of the derived region bounds are 'static, that is always
    // the best choice.
    if derived_region_bounds.iter().any(|r| ty::ReStatic == *r) {
1922
        return ty::ReStatic;
1923 1924 1925 1926 1927
    }

    // Determine whether there is exactly one unique region in the set
    // of derived region bounds. If so, use that. Otherwise, report an
    // error.
1928
    let r = derived_region_bounds[0];
A
Aaron Turon 已提交
1929
    if derived_region_bounds[1..].iter().any(|r1| r != *r1) {
B
Brian Anderson 已提交
1930
        span_err!(tcx.sess, span, E0227,
1931
                  "ambiguous lifetime bound, explicit lifetime bound required");
1932
    }
1933
    return r;
1934 1935
}

N
Niko Matsakis 已提交
1936 1937 1938 1939 1940 1941
/// Given an object type like `SomeTrait+Send`, computes the lifetime
/// bounds that must hold on the elided self type. These are derived
/// from the declarations of `SomeTrait`, `Send`, and friends -- if
/// they declare `trait SomeTrait : 'static`, for example, then
/// `'static` would appear in the list. The hard work is done by
/// `ty::required_region_bounds`, see that for more information.
1942 1943 1944 1945 1946
pub fn object_region_bounds<'tcx>(
    tcx: &ty::ctxt<'tcx>,
    principal: &ty::PolyTraitRef<'tcx>,
    others: ty::BuiltinBounds)
    -> Vec<ty::Region>
1947
{
1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966
    // Since we don't actually *know* the self type for an object,
    // this "open(err)" serves as a kind of dummy standin -- basically
    // a skolemized type.
    let open_ty = ty::mk_infer(tcx, ty::FreshTy(0));

    // Note that we preserve the overall binding levels here.
    assert!(!open_ty.has_escaping_regions());
    let substs = tcx.mk_substs(principal.0.substs.with_self_ty(open_ty));
    let trait_refs = vec!(ty::Binder(Rc::new(ty::TraitRef::new(principal.0.def_id, substs))));

    let param_bounds = ty::ParamBounds {
        region_bounds: Vec::new(),
        builtin_bounds: others,
        trait_bounds: trait_refs,
        projection_bounds: Vec::new(), // not relevant to computing region bounds
    };

    let predicates = ty::predicates(tcx, open_ty, &param_bounds);
    ty::required_region_bounds(tcx, open_ty, predicates)
1967 1968 1969 1970
}

pub struct PartitionedBounds<'a> {
    pub builtin_bounds: ty::BuiltinBounds,
1971
    pub trait_bounds: Vec<&'a ast::PolyTraitRef>,
1972 1973 1974
    pub region_bounds: Vec<&'a ast::Lifetime>,
}

S
Steve Klabnik 已提交
1975 1976
/// Divides a list of bounds from the AST into three groups: builtin bounds (Copy, Sized etc),
/// general trait bounds, and region bounds.
1977 1978
pub fn partition_bounds<'a>(tcx: &ty::ctxt,
                            _span: Span,
1979
                            ast_bounds: &'a [ast::TyParamBound])
1980 1981 1982 1983 1984
                            -> PartitionedBounds<'a>
{
    let mut builtin_bounds = ty::empty_builtin_bounds();
    let mut region_bounds = Vec::new();
    let mut trait_bounds = Vec::new();
1985
    for ast_bound in ast_bounds {
1986
        match *ast_bound {
N
Nick Cameron 已提交
1987
            ast::TraitTyParamBound(ref b, ast::TraitBoundModifier::None) => {
1988
                match ::lookup_full_def(tcx, b.trait_ref.path.span, b.trait_ref.ref_id) {
1989
                    def::DefTrait(trait_did) => {
1990 1991 1992
                        if ty::try_add_builtin_trait(tcx,
                                                     trait_did,
                                                     &mut builtin_bounds) {
1993 1994
                            let segments = &b.trait_ref.path.segments;
                            let parameters = &segments[segments.len() - 1].parameters;
1995 1996 1997 1998 1999 2000 2001
                            if parameters.types().len() > 0 {
                                check_type_argument_count(tcx, b.trait_ref.path.span,
                                                          parameters.types().len(), 0, 0);
                            }
                            if parameters.lifetimes().len() > 0{
                                report_lifetime_number_error(tcx, b.trait_ref.path.span,
                                                             parameters.lifetimes().len(), 0);
2002
                            }
2003
                            continue; // success
2004 2005
                        }
                    }
2006 2007 2008 2009
                    _ => {
                        // Not a trait? that's an error, but it'll get
                        // reported later.
                    }
2010
                }
2011 2012
                trait_bounds.push(b);
            }
N
Nick Cameron 已提交
2013
            ast::TraitTyParamBound(_, ast::TraitBoundModifier::Maybe) => {}
2014 2015 2016
            ast::RegionTyParamBound(ref l) => {
                region_bounds.push(l);
            }
2017
        }
2018 2019 2020 2021 2022 2023
    }

    PartitionedBounds {
        builtin_bounds: builtin_bounds,
        trait_bounds: trait_bounds,
        region_bounds: region_bounds,
2024 2025
    }
}
2026 2027 2028 2029 2030

fn prohibit_projections<'tcx>(tcx: &ty::ctxt<'tcx>,
                              bindings: &[ConvertedBinding<'tcx>])
{
    for binding in bindings.iter().take(1) {
B
Brian Anderson 已提交
2031
        span_err!(tcx.sess, binding.span, E0229,
2032 2033 2034
            "associated type bindings are not allowed here");
    }
}
2035 2036 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065

fn check_type_argument_count(tcx: &ty::ctxt, span: Span, supplied: usize,
                             required: usize, accepted: usize) {
    if supplied < required {
        let expected = if required < accepted {
            "expected at least"
        } else {
            "expected"
        };
        span_err!(tcx.sess, span, E0243,
                  "wrong number of type arguments: {} {}, found {}",
                  expected, required, supplied);
    } else if supplied > accepted {
        let expected = if required < accepted {
            "expected at most"
        } else {
            "expected"
        };
        span_err!(tcx.sess, span, E0244,
                  "wrong number of type arguments: {} {}, found {}",
                  expected,
                  accepted,
                  supplied);
    }
}

fn report_lifetime_number_error(tcx: &ty::ctxt, span: Span, number: usize, expected: usize) {
    span_err!(tcx.sess, span, E0107,
              "wrong number of lifetime parameters: expected {}, found {}",
              expected, number);
}