src/librustc_metadata/decoder.rs

   1 // Copyright 2012-2014 The Rust Project Developers. See the COPYRIGHT
   2 // file at the top-level directory of this distribution and at
   3 // http://rust-lang.org/COPYRIGHT.
   4 //
   5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
   6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
   7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
   8 // option. This file may not be copied, modified, or distributed
   9 // except according to those terms.
  10
  11 // Decoding metadata from a single crate's metadata
  12
  13 use cstore::{self, CrateMetadata, MetadataBlob, NativeLibrary};
  14 use schema::*;
  15
  16 use rustc::hir::map::{DefKey, DefPath, DefPathData};
  17 use rustc::hir;
  18
  19 use rustc::middle::cstore::LinkagePreference;
  20 use rustc::hir::def::{self, Def, CtorKind};
  21 use rustc::hir::def_id::{CrateNum, DefId, DefIndex, CRATE_DEF_INDEX, LOCAL_CRATE};
  22 use rustc::middle::lang_items;
  23 use rustc::session::Session;
  24 use rustc::ty::{self, Ty, TyCtxt};
  25 use rustc::ty::subst::Substs;
  26
  27 use rustc::mir::Mir;
  28
  29 use std::borrow::Cow;
  30 use std::cell::Ref;
  31 use std::collections::BTreeMap;
  32 use std::io;
  33 use std::mem;
  34 use std::str;
  35 use std::u32;
  36
  37 use rustc_serialize::{Decodable, Decoder, SpecializedDecoder, opaque};
  38 use syntax::attr;
  39 use syntax::ast;
  40 use syntax::codemap;
  41 use syntax::ext::base::MacroKind;
  42 use syntax_pos::{self, Span, BytePos, Pos, DUMMY_SP, NO_EXPANSION};
  43
  44 pub struct DecodeContext<'a, 'tcx: 'a> {
  45     opaque: opaque::Decoder<'a>,
  46     cdata: Option<&'a CrateMetadata>,
  47     sess: Option<&'a Session>,
  48     tcx: Option<TyCtxt<'a, 'tcx, 'tcx>>,
  49
  50     // Cache the last used filemap for translating spans as an optimization.
  51     last_filemap_index: usize,
  52
  53     lazy_state: LazyState,
  54 }
  55
  56 /// Abstract over the various ways one can create metadata decoders.
  57 pub trait Metadata<'a, 'tcx>: Copy {
  58     fn raw_bytes(self) -> &'a [u8];
  59     fn cdata(self) -> Option<&'a CrateMetadata> { None }
  60     fn sess(self) -> Option<&'a Session> { None }
  61     fn tcx(self) -> Option<TyCtxt<'a, 'tcx, 'tcx>> { None }
  62
  63     fn decoder(self, pos: usize) -> DecodeContext<'a, 'tcx> {
  64         let tcx = self.tcx();
  65         DecodeContext {
  66             opaque: opaque::Decoder::new(self.raw_bytes(), pos),
  67             cdata: self.cdata(),
  68             sess: self.sess().or(tcx.map(|tcx| tcx.sess)),
  69             tcx: tcx,
  70             last_filemap_index: 0,
  71             lazy_state: LazyState::NoNode,
  72         }
  73     }
  74 }
  75
  76 impl<'a, 'tcx> Metadata<'a, 'tcx> for &'a MetadataBlob {
  77     fn raw_bytes(self) -> &'a [u8] {
  78         match *self {
  79             MetadataBlob::Inflated(ref vec) => vec,
  80             MetadataBlob::Archive(ref ar) => ar.as_slice(),
  81             MetadataBlob::Raw(ref vec) => vec,
  82         }
  83     }
  84 }
  85
  86 impl<'a, 'tcx> Metadata<'a, 'tcx> for &'a CrateMetadata {
  87     fn raw_bytes(self) -> &'a [u8] {
  88         self.blob.raw_bytes()
  89     }
  90     fn cdata(self) -> Option<&'a CrateMetadata> {
  91         Some(self)
  92     }
  93 }
  94
  95 impl<'a, 'tcx> Metadata<'a, 'tcx> for (&'a CrateMetadata, &'a Session) {
  96     fn raw_bytes(self) -> &'a [u8] {
  97         self.0.raw_bytes()
  98     }
  99     fn cdata(self) -> Option<&'a CrateMetadata> {
 100         Some(self.0)
 101     }
 102     fn sess(self) -> Option<&'a Session> {
 103         Some(&self.1)
 104     }
 105 }
 106
 107 impl<'a, 'tcx> Metadata<'a, 'tcx> for (&'a CrateMetadata, TyCtxt<'a, 'tcx, 'tcx>) {
 108     fn raw_bytes(self) -> &'a [u8] {
 109         self.0.raw_bytes()
 110     }
 111     fn cdata(self) -> Option<&'a CrateMetadata> {
 112         Some(self.0)
 113     }
 114     fn tcx(self) -> Option<TyCtxt<'a, 'tcx, 'tcx>> {
 115         Some(self.1)
 116     }
 117 }
 118
 119 impl<'a, 'tcx: 'a, T: Decodable> Lazy<T> {
 120     pub fn decode<M: Metadata<'a, 'tcx>>(self, meta: M) -> T {
 121         let mut dcx = meta.decoder(self.position);
 122         dcx.lazy_state = LazyState::NodeStart(self.position);
 123         T::decode(&mut dcx).unwrap()
 124     }
 125 }
 126
 127 impl<'a, 'tcx: 'a, T: Decodable> LazySeq<T> {
 128     pub fn decode<M: Metadata<'a, 'tcx>>(self, meta: M) -> impl Iterator<Item = T> + 'a {
 129         let mut dcx = meta.decoder(self.position);
 130         dcx.lazy_state = LazyState::NodeStart(self.position);
 131         (0..self.len).map(move |_| T::decode(&mut dcx).unwrap())
 132     }
 133 }
 134
 135 impl<'a, 'tcx> DecodeContext<'a, 'tcx> {
 136     pub fn tcx(&self) -> TyCtxt<'a, 'tcx, 'tcx> {
 137         self.tcx.expect("missing TyCtxt in DecodeContext")
 138     }
 139
 140     pub fn cdata(&self) -> &'a CrateMetadata {
 141         self.cdata.expect("missing CrateMetadata in DecodeContext")
 142     }
 143
 144     fn with_position<F: FnOnce(&mut Self) -> R, R>(&mut self, pos: usize, f: F) -> R {
 145         let new_opaque = opaque::Decoder::new(self.opaque.data, pos);
 146         let old_opaque = mem::replace(&mut self.opaque, new_opaque);
 147         let old_state = mem::replace(&mut self.lazy_state, LazyState::NoNode);
 148         let r = f(self);
 149         self.opaque = old_opaque;
 150         self.lazy_state = old_state;
 151         r
 152     }
 153
 154     fn read_lazy_distance(&mut self, min_size: usize) -> Result<usize, <Self as Decoder>::Error> {
 155         let distance = self.read_usize()?;
 156         let position = match self.lazy_state {
 157             LazyState::NoNode => bug!("read_lazy_distance: outside of a metadata node"),
 158             LazyState::NodeStart(start) => {
 159                 assert!(distance + min_size <= start);
 160                 start - distance - min_size
 161             }
 162             LazyState::Previous(last_min_end) => last_min_end + distance,
 163         };
 164         self.lazy_state = LazyState::Previous(position + min_size);
 165         Ok(position)
 166     }
 167 }
 168
 169 macro_rules! decoder_methods {
 170     ($($name:ident -> $ty:ty;)*) => {
 171         $(fn $name(&mut self) -> Result<$ty, Self::Error> {
 172             self.opaque.$name()
 173         })*
 174     }
 175 }
 176
 177 impl<'doc, 'tcx> Decoder for DecodeContext<'doc, 'tcx> {
 178     type Error = <opaque::Decoder<'doc> as Decoder>::Error;
 179
 180     decoder_methods! {
 181         read_nil -> ();
 182
 183         read_u128 -> u128;
 184         read_u64 -> u64;
 185         read_u32 -> u32;
 186         read_u16 -> u16;
 187         read_u8 -> u8;
 188         read_usize -> usize;
 189
 190         read_i128 -> i128;
 191         read_i64 -> i64;
 192         read_i32 -> i32;
 193         read_i16 -> i16;
 194         read_i8 -> i8;
 195         read_isize -> isize;
 196
 197         read_bool -> bool;
 198         read_f64 -> f64;
 199         read_f32 -> f32;
 200         read_char -> char;
 201         read_str -> Cow<str>;
 202     }
 203
 204     fn error(&mut self, err: &str) -> Self::Error {
 205         self.opaque.error(err)
 206     }
 207 }
 208
 209 impl<'a, 'tcx, T> SpecializedDecoder<Lazy<T>> for DecodeContext<'a, 'tcx> {
 210     fn specialized_decode(&mut self) -> Result<Lazy<T>, Self::Error> {
 211         Ok(Lazy::with_position(self.read_lazy_distance(Lazy::<T>::min_size())?))
 212     }
 213 }
 214
 215 impl<'a, 'tcx, T> SpecializedDecoder<LazySeq<T>> for DecodeContext<'a, 'tcx> {
 216     fn specialized_decode(&mut self) -> Result<LazySeq<T>, Self::Error> {
 217         let len = self.read_usize()?;
 218         let position = if len == 0 {
 219             0
 220         } else {
 221             self.read_lazy_distance(LazySeq::<T>::min_size(len))?
 222         };
 223         Ok(LazySeq::with_position_and_length(position, len))
 224     }
 225 }
 226
 227 impl<'a, 'tcx> SpecializedDecoder<CrateNum> for DecodeContext<'a, 'tcx> {
 228     fn specialized_decode(&mut self) -> Result<CrateNum, Self::Error> {
 229         let cnum = CrateNum::from_u32(u32::decode(self)?);
 230         if cnum == LOCAL_CRATE {
 231             Ok(self.cdata().cnum)
 232         } else {
 233             Ok(self.cdata().cnum_map.borrow()[cnum])
 234         }
 235     }
 236 }
 237
 238 impl<'a, 'tcx> SpecializedDecoder<Span> for DecodeContext<'a, 'tcx> {
 239     fn specialized_decode(&mut self) -> Result<Span, Self::Error> {
 240         let lo = BytePos::decode(self)?;
 241         let hi = BytePos::decode(self)?;
 242
 243         let sess = if let Some(sess) = self.sess {
 244             sess
 245         } else {
 246             return Ok(Span { lo: lo, hi: hi, ctxt: NO_EXPANSION });
 247         };
 248
 249         let (lo, hi) = if lo > hi {
 250             // Currently macro expansion sometimes produces invalid Span values
 251             // where lo > hi. In order not to crash the compiler when trying to
 252             // translate these values, let's transform them into something we
 253             // can handle (and which will produce useful debug locations at
 254             // least some of the time).
 255             // This workaround is only necessary as long as macro expansion is
 256             // not fixed. FIXME(#23480)
 257             (lo, lo)
 258         } else {
 259             (lo, hi)
 260         };
 261
 262         let imported_filemaps = self.cdata().imported_filemaps(&sess.codemap());
 263         let filemap = {
 264             // Optimize for the case that most spans within a translated item
 265             // originate from the same filemap.
 266             let last_filemap = &imported_filemaps[self.last_filemap_index];
 267
 268             if lo >= last_filemap.original_start_pos && lo <= last_filemap.original_end_pos &&
 269                hi >= last_filemap.original_start_pos &&
 270                hi <= last_filemap.original_end_pos {
 271                 last_filemap
 272             } else {
 273                 let mut a = 0;
 274                 let mut b = imported_filemaps.len();
 275
 276                 while b - a > 1 {
 277                     let m = (a + b) / 2;
 278                     if imported_filemaps[m].original_start_pos > lo {
 279                         b = m;
 280                     } else {
 281                         a = m;
 282                     }
 283                 }
 284
 285                 self.last_filemap_index = a;
 286                 &imported_filemaps[a]
 287             }
 288         };
 289
 290         let lo = (lo - filemap.original_start_pos) + filemap.translated_filemap.start_pos;
 291         let hi = (hi - filemap.original_start_pos) + filemap.translated_filemap.start_pos;
 292
 293         Ok(Span { lo: lo, hi: hi, ctxt: NO_EXPANSION })
 294     }
 295 }
 296
 297 // FIXME(#36588) These impls are horribly unsound as they allow
 298 // the caller to pick any lifetime for 'tcx, including 'static,
 299 // by using the unspecialized proxies to them.
 300
 301 impl<'a, 'tcx> SpecializedDecoder<Ty<'tcx>> for DecodeContext<'a, 'tcx> {
 302     fn specialized_decode(&mut self) -> Result<Ty<'tcx>, Self::Error> {
 303         let tcx = self.tcx();
 304
 305         // Handle shorthands first, if we have an usize > 0x80.
 306         if self.opaque.data[self.opaque.position()] & 0x80 != 0 {
 307             let pos = self.read_usize()?;
 308             assert!(pos >= SHORTHAND_OFFSET);
 309             let key = ty::CReaderCacheKey {
 310                 cnum: self.cdata().cnum,
 311                 pos: pos - SHORTHAND_OFFSET,
 312             };
 313             if let Some(ty) = tcx.rcache.borrow().get(&key).cloned() {
 314                 return Ok(ty);
 315             }
 316
 317             let ty = self.with_position(key.pos, Ty::decode)?;
 318             tcx.rcache.borrow_mut().insert(key, ty);
 319             Ok(ty)
 320         } else {
 321             Ok(tcx.mk_ty(ty::TypeVariants::decode(self)?))
 322         }
 323     }
 324 }
 325
 326
 327 impl<'a, 'tcx> SpecializedDecoder<ty::GenericPredicates<'tcx>> for DecodeContext<'a, 'tcx> {
 328     fn specialized_decode(&mut self) -> Result<ty::GenericPredicates<'tcx>, Self::Error> {
 329         Ok(ty::GenericPredicates {
 330             parent: Decodable::decode(self)?,
 331             predicates: (0..self.read_usize()?).map(|_| {
 332                     // Handle shorthands first, if we have an usize > 0x80.
 333                     if self.opaque.data[self.opaque.position()] & 0x80 != 0 {
 334                         let pos = self.read_usize()?;
 335                         assert!(pos >= SHORTHAND_OFFSET);
 336                         let pos = pos - SHORTHAND_OFFSET;
 337
 338                         self.with_position(pos, ty::Predicate::decode)
 339                     } else {
 340                         ty::Predicate::decode(self)
 341                     }
 342                 })
 343                 .collect::<Result<Vec<_>, _>>()?,
 344         })
 345     }
 346 }
 347
 348 impl<'a, 'tcx> SpecializedDecoder<&'tcx Substs<'tcx>> for DecodeContext<'a, 'tcx> {
 349     fn specialized_decode(&mut self) -> Result<&'tcx Substs<'tcx>, Self::Error> {
 350         Ok(self.tcx().mk_substs((0..self.read_usize()?).map(|_| Decodable::decode(self)))?)
 351     }
 352 }
 353
 354 impl<'a, 'tcx> SpecializedDecoder<&'tcx ty::Region> for DecodeContext<'a, 'tcx> {
 355     fn specialized_decode(&mut self) -> Result<&'tcx ty::Region, Self::Error> {
 356         Ok(self.tcx().mk_region(Decodable::decode(self)?))
 357     }
 358 }
 359
 360 impl<'a, 'tcx> SpecializedDecoder<&'tcx ty::Slice<Ty<'tcx>>> for DecodeContext<'a, 'tcx> {
 361     fn specialized_decode(&mut self) -> Result<&'tcx ty::Slice<Ty<'tcx>>, Self::Error> {
 362         Ok(self.tcx().mk_type_list((0..self.read_usize()?).map(|_| Decodable::decode(self)))?)
 363     }
 364 }
 365
 366 impl<'a, 'tcx> SpecializedDecoder<&'tcx ty::AdtDef> for DecodeContext<'a, 'tcx> {
 367     fn specialized_decode(&mut self) -> Result<&'tcx ty::AdtDef, Self::Error> {
 368         let def_id = DefId::decode(self)?;
 369         Ok(self.tcx().lookup_adt_def(def_id))
 370     }
 371 }
 372
 373 impl<'a, 'tcx> SpecializedDecoder<&'tcx ty::Slice<ty::ExistentialPredicate<'tcx>>>
 374     for DecodeContext<'a, 'tcx> {
 375     fn specialized_decode(&mut self)
 376         -> Result<&'tcx ty::Slice<ty::ExistentialPredicate<'tcx>>, Self::Error> {
 377         Ok(self.tcx().mk_existential_predicates((0..self.read_usize()?)
 378                                                 .map(|_| Decodable::decode(self)))?)
 379     }
 380 }
 381
 382 impl<'a, 'tcx> MetadataBlob {
 383     pub fn is_compatible(&self) -> bool {
 384         self.raw_bytes().starts_with(METADATA_HEADER)
 385     }
 386
 387     pub fn get_rustc_version(&self) -> String {
 388         Lazy::with_position(METADATA_HEADER.len() + 4).decode(self)
 389     }
 390
 391     pub fn get_root(&self) -> CrateRoot {
 392         let slice = self.raw_bytes();
 393         let offset = METADATA_HEADER.len();
 394         let pos = (((slice[offset + 0] as u32) << 24) | ((slice[offset + 1] as u32) << 16) |
 395                    ((slice[offset + 2] as u32) << 8) |
 396                    ((slice[offset + 3] as u32) << 0)) as usize;
 397         Lazy::with_position(pos).decode(self)
 398     }
 399
 400     pub fn list_crate_metadata(&self, out: &mut io::Write) -> io::Result<()> {
 401         write!(out, "=External Dependencies=\n")?;
 402         let root = self.get_root();
 403         for (i, dep) in root.crate_deps.decode(self).enumerate() {
 404             write!(out, "{} {}-{}\n", i + 1, dep.name, dep.hash)?;
 405         }
 406         write!(out, "\n")?;
 407         Ok(())
 408     }
 409 }
 410
 411 impl<'tcx> EntryKind<'tcx> {
 412     fn to_def(&self, did: DefId) -> Option<Def> {
 413         Some(match *self {
 414             EntryKind::Const(_) => Def::Const(did),
 415             EntryKind::AssociatedConst(..) => Def::AssociatedConst(did),
 416             EntryKind::ImmStatic |
 417             EntryKind::ForeignImmStatic => Def::Static(did, false),
 418             EntryKind::MutStatic |
 419             EntryKind::ForeignMutStatic => Def::Static(did, true),
 420             EntryKind::Struct(_, _) => Def::Struct(did),
 421             EntryKind::Union(_, _) => Def::Union(did),
 422             EntryKind::Fn(_) |
 423             EntryKind::ForeignFn(_) => Def::Fn(did),
 424             EntryKind::Method(_) => Def::Method(did),
 425             EntryKind::Type => Def::TyAlias(did),
 426             EntryKind::AssociatedType(_) => Def::AssociatedTy(did),
 427             EntryKind::Mod(_) => Def::Mod(did),
 428             EntryKind::Variant(_) => Def::Variant(did),
 429             EntryKind::Trait(_) => Def::Trait(did),
 430             EntryKind::Enum(..) => Def::Enum(did),
 431             EntryKind::MacroDef(_) => Def::Macro(did, MacroKind::Bang),
 432
 433             EntryKind::ForeignMod |
 434             EntryKind::Impl(_) |
 435             EntryKind::DefaultImpl(_) |
 436             EntryKind::Field |
 437             EntryKind::Closure(_) => return None,
 438         })
 439     }
 440 }
 441
 442 impl<'a, 'tcx> CrateMetadata {
 443     fn is_proc_macro(&self, id: DefIndex) -> bool {
 444         self.proc_macros.is_some() && id != CRATE_DEF_INDEX
 445     }
 446
 447     fn maybe_entry(&self, item_id: DefIndex) -> Option<Lazy<Entry<'tcx>>> {
 448         assert!(!self.is_proc_macro(item_id));
 449         self.root.index.lookup(self.blob.raw_bytes(), item_id)
 450     }
 451
 452     fn entry(&self, item_id: DefIndex) -> Entry<'tcx> {
 453         match self.maybe_entry(item_id) {
 454             None => {
 455                 bug!("entry: id not found: {:?} in crate {:?} with number {}",
 456                      item_id,
 457                      self.name,
 458                      self.cnum)
 459             }
 460             Some(d) => d.decode(self),
 461         }
 462     }
 463
 464     fn local_def_id(&self, index: DefIndex) -> DefId {
 465         DefId {
 466             krate: self.cnum,
 467             index: index,
 468         }
 469     }
 470
 471     fn item_name(&self, item_index: DefIndex) -> ast::Name {
 472         self.def_key(item_index)
 473             .disambiguated_data
 474             .data
 475             .get_opt_name()
 476             .expect("no name in item_name")
 477     }
 478
 479     pub fn get_def(&self, index: DefIndex) -> Option<Def> {
 480         if !self.is_proc_macro(index) {
 481             self.entry(index).kind.to_def(self.local_def_id(index))
 482         } else {
 483             let kind = self.proc_macros.as_ref().unwrap()[index.as_usize() - 1].1.kind();
 484             Some(Def::Macro(self.local_def_id(index), kind))
 485         }
 486     }
 487
 488     pub fn get_span(&self, index: DefIndex, sess: &Session) -> Span {
 489         match self.is_proc_macro(index) {
 490             true => DUMMY_SP,
 491             false => self.entry(index).span.decode((self, sess)),
 492         }
 493     }
 494
 495     pub fn get_trait_def(&self,
 496                          item_id: DefIndex,
 497                          tcx: TyCtxt<'a, 'tcx, 'tcx>)
 498                          -> ty::TraitDef {
 499         let data = match self.entry(item_id).kind {
 500             EntryKind::Trait(data) => data.decode(self),
 501             _ => bug!(),
 502         };
 503
 504         let def = ty::TraitDef::new(self.local_def_id(item_id),
 505                                     data.unsafety,
 506                                     data.paren_sugar,
 507                                     self.def_path(item_id).deterministic_hash(tcx));
 508
 509         if data.has_default_impl {
 510             def.record_has_default_impl();
 511         }
 512
 513         def
 514     }
 515
 516     fn get_variant(&self,
 517                    item: &Entry<'tcx>,
 518                    index: DefIndex,
 519                    tcx: TyCtxt<'a, 'tcx, 'tcx>)
 520                    -> (ty::VariantDef, Option<DefIndex>) {
 521         let data = match item.kind {
 522             EntryKind::Variant(data) |
 523             EntryKind::Struct(data, _) |
 524             EntryKind::Union(data, _) => data.decode(self),
 525             _ => bug!(),
 526         };
 527
 528         if let ty::VariantDiscr::Explicit(def_id) = data.discr {
 529             let result = data.evaluated_discr.map_or(Err(()), Ok);
 530             tcx.maps.monomorphic_const_eval.borrow_mut().insert(def_id, result);
 531         }
 532
 533         (ty::VariantDef {
 534             did: self.local_def_id(data.struct_ctor.unwrap_or(index)),
 535             name: self.item_name(index),
 536             fields: item.children.decode(self).map(|index| {
 537                 let f = self.entry(index);
 538                 ty::FieldDef {
 539                     did: self.local_def_id(index),
 540                     name: self.item_name(index),
 541                     vis: f.visibility.decode(self)
 542                 }
 543             }).collect(),
 544             discr: data.discr,
 545             ctor_kind: data.ctor_kind,
 546         }, data.struct_ctor)
 547     }
 548
 549     pub fn get_adt_def(&self,
 550                        item_id: DefIndex,
 551                        tcx: TyCtxt<'a, 'tcx, 'tcx>)
 552                        -> &'tcx ty::AdtDef {
 553         let item = self.entry(item_id);
 554         let did = self.local_def_id(item_id);
 555         let kind = match item.kind {
 556             EntryKind::Enum(_) => ty::AdtKind::Enum,
 557             EntryKind::Struct(_, _) => ty::AdtKind::Struct,
 558             EntryKind::Union(_, _) => ty::AdtKind::Union,
 559             _ => bug!("get_adt_def called on a non-ADT {:?}", did),
 560         };
 561         let variants = if let ty::AdtKind::Enum = kind {
 562             item.children
 563                 .decode(self)
 564                 .map(|index| {
 565                     let (variant, struct_ctor) =
 566                         self.get_variant(&self.entry(index), index, tcx);
 567                     assert_eq!(struct_ctor, None);
 568                     variant
 569                 })
 570                 .collect()
 571         } else {
 572             let (variant, _struct_ctor) = self.get_variant(&item, item_id, tcx);
 573             vec![variant]
 574         };
 575         let (kind, repr) = match item.kind {
 576             EntryKind::Enum(repr) => (ty::AdtKind::Enum, repr),
 577             EntryKind::Struct(_, repr) => (ty::AdtKind::Struct, repr),
 578             EntryKind::Union(_, repr) => (ty::AdtKind::Union, repr),
 579             _ => bug!("get_adt_def called on a non-ADT {:?}", did),
 580         };
 581
 582         tcx.alloc_adt_def(did, kind, variants, repr)
 583     }
 584
 585     pub fn get_predicates(&self,
 586                           item_id: DefIndex,
 587                           tcx: TyCtxt<'a, 'tcx, 'tcx>)
 588                           -> ty::GenericPredicates<'tcx> {
 589         self.entry(item_id).predicates.unwrap().decode((self, tcx))
 590     }
 591
 592     pub fn get_super_predicates(&self,
 593                                 item_id: DefIndex,
 594                                 tcx: TyCtxt<'a, 'tcx, 'tcx>)
 595                                 -> ty::GenericPredicates<'tcx> {
 596         match self.entry(item_id).kind {
 597             EntryKind::Trait(data) => data.decode(self).super_predicates.decode((self, tcx)),
 598             _ => bug!(),
 599         }
 600     }
 601
 602     pub fn get_generics(&self, item_id: DefIndex) -> ty::Generics {
 603         self.entry(item_id).generics.unwrap().decode(self)
 604     }
 605
 606     pub fn get_type(&self, id: DefIndex, tcx: TyCtxt<'a, 'tcx, 'tcx>) -> Ty<'tcx> {
 607         self.entry(id).ty.unwrap().decode((self, tcx))
 608     }
 609
 610     pub fn get_stability(&self, id: DefIndex) -> Option<attr::Stability> {
 611         match self.is_proc_macro(id) {
 612             true => None,
 613             false => self.entry(id).stability.map(|stab| stab.decode(self)),
 614         }
 615     }
 616
 617     pub fn get_deprecation(&self, id: DefIndex) -> Option<attr::Deprecation> {
 618         match self.is_proc_macro(id) {
 619             true => None,
 620             false => self.entry(id).deprecation.map(|depr| depr.decode(self)),
 621         }
 622     }
 623
 624     pub fn get_visibility(&self, id: DefIndex) -> ty::Visibility {
 625         match self.is_proc_macro(id) {
 626             true => ty::Visibility::Public,
 627             false => self.entry(id).visibility.decode(self),
 628         }
 629     }
 630
 631     fn get_impl_data(&self, id: DefIndex) -> ImplData<'tcx> {
 632         match self.entry(id).kind {
 633             EntryKind::Impl(data) => data.decode(self),
 634             _ => bug!(),
 635         }
 636     }
 637
 638     pub fn get_parent_impl(&self, id: DefIndex) -> Option<DefId> {
 639         self.get_impl_data(id).parent_impl
 640     }
 641
 642     pub fn get_impl_polarity(&self, id: DefIndex) -> hir::ImplPolarity {
 643         self.get_impl_data(id).polarity
 644     }
 645
 646     pub fn get_coerce_unsized_info(&self,
 647                                    id: DefIndex)
 648                                    -> Option<ty::adjustment::CoerceUnsizedInfo> {
 649         self.get_impl_data(id).coerce_unsized_info
 650     }
 651
 652     pub fn get_impl_trait(&self,
 653                           id: DefIndex,
 654                           tcx: TyCtxt<'a, 'tcx, 'tcx>)
 655                           -> Option<ty::TraitRef<'tcx>> {
 656         self.get_impl_data(id).trait_ref.map(|tr| tr.decode((self, tcx)))
 657     }
 658
 659     /// Iterates over the language items in the given crate.
 660     pub fn get_lang_items(&self) -> Vec<(DefIndex, usize)> {
 661         self.root.lang_items.decode(self).collect()
 662     }
 663
 664     /// Iterates over each child of the given item.
 665     pub fn each_child_of_item<F>(&self, id: DefIndex, mut callback: F)
 666         where F: FnMut(def::Export)
 667     {
 668         if let Some(ref proc_macros) = self.proc_macros {
 669             if id == CRATE_DEF_INDEX {
 670                 for (id, &(name, ref ext)) in proc_macros.iter().enumerate() {
 671                     let def = Def::Macro(
 672                         DefId {
 673                             krate: self.cnum,
 674                             index: DefIndex::new(id + 1)
 675                         },
 676                         ext.kind()
 677                     );
 678                     callback(def::Export { name: name, def: def, span: DUMMY_SP });
 679                 }
 680             }
 681             return
 682         }
 683
 684         // Find the item.
 685         let item = match self.maybe_entry(id) {
 686             None => return,
 687             Some(item) => item.decode(self),
 688         };
 689
 690         // Iterate over all children.
 691         let macros_only = self.dep_kind.get().macros_only();
 692         for child_index in item.children.decode(self) {
 693             if macros_only {
 694                 continue
 695             }
 696
 697             // Get the item.
 698             if let Some(child) = self.maybe_entry(child_index) {
 699                 let child = child.decode(self);
 700                 match child.kind {
 701                     EntryKind::MacroDef(..) => {}
 702                     _ if macros_only => continue,
 703                     _ => {}
 704                 }
 705
 706                 // Hand off the item to the callback.
 707                 match child.kind {
 708                     // FIXME(eddyb) Don't encode these in children.
 709                     EntryKind::ForeignMod => {
 710                         for child_index in child.children.decode(self) {
 711                             if let Some(def) = self.get_def(child_index) {
 712                                 callback(def::Export {
 713                                     def: def,
 714                                     name: self.item_name(child_index),
 715                                     span: self.entry(child_index).span.decode(self),
 716                                 });
 717                             }
 718                         }
 719                         continue;
 720                     }
 721                     EntryKind::Impl(_) |
 722                     EntryKind::DefaultImpl(_) => continue,
 723
 724                     _ => {}
 725                 }
 726
 727                 let def_key = self.def_key(child_index);
 728                 let span = child.span.decode(self);
 729                 if let (Some(def), Some(name)) =
 730                     (self.get_def(child_index), def_key.disambiguated_data.data.get_opt_name()) {
 731                     callback(def::Export { def: def, name: name, span: span });
 732                     // For non-reexport structs and variants add their constructors to children.
 733                     // Reexport lists automatically contain constructors when necessary.
 734                     match def {
 735                         Def::Struct(..) => {
 736                             if let Some(ctor_def_id) = self.get_struct_ctor_def_id(child_index) {
 737                                 let ctor_kind = self.get_ctor_kind(child_index);
 738                                 let ctor_def = Def::StructCtor(ctor_def_id, ctor_kind);
 739                                 callback(def::Export { def: ctor_def, name: name, span: span });
 740                             }
 741                         }
 742                         Def::Variant(def_id) => {
 743                             // Braced variants, unlike structs, generate unusable names in
 744                             // value namespace, they are reserved for possible future use.
 745                             let ctor_kind = self.get_ctor_kind(child_index);
 746                             let ctor_def = Def::VariantCtor(def_id, ctor_kind);
 747                             callback(def::Export { def: ctor_def, name: name, span: span });
 748                         }
 749                         _ => {}
 750                     }
 751                 }
 752             }
 753         }
 754
 755         if let EntryKind::Mod(data) = item.kind {
 756             for exp in data.decode(self).reexports.decode(self) {
 757                 match exp.def {
 758                     Def::Macro(..) => {}
 759                     _ if macros_only => continue,
 760                     _ => {}
 761                 }
 762                 callback(exp);
 763             }
 764         }
 765     }
 766
 767     pub fn maybe_get_item_body(&self,
 768                                tcx: TyCtxt<'a, 'tcx, 'tcx>,
 769                                id: DefIndex)
 770                                -> Option<&'tcx hir::Body> {
 771         if self.is_proc_macro(id) { return None; }
 772         self.entry(id).ast.map(|ast| {
 773             let def_id = self.local_def_id(id);
 774             let body = ast.decode(self).body.decode(self);
 775             tcx.hir.intern_inlined_body(def_id, body)
 776         })
 777     }
 778
 779     pub fn item_body_tables(&self,
 780                             id: DefIndex,
 781                             tcx: TyCtxt<'a, 'tcx, 'tcx>)
 782                             -> &'tcx ty::TypeckTables<'tcx> {
 783         let ast = self.entry(id).ast.unwrap().decode(self);
 784         tcx.alloc_tables(ast.tables.decode((self, tcx)))
 785     }
 786
 787     pub fn item_body_nested_bodies(&self, id: DefIndex) -> BTreeMap<hir::BodyId, hir::Body> {
 788         self.entry(id).ast.into_iter().flat_map(|ast| {
 789             ast.decode(self).nested_bodies.decode(self).map(|body| (body.id(), body))
 790         }).collect()
 791     }
 792
 793     pub fn const_is_rvalue_promotable_to_static(&self, id: DefIndex) -> bool {
 794         self.entry(id).ast.expect("const item missing `ast`")
 795             .decode(self).rvalue_promotable_to_static
 796     }
 797
 798     pub fn is_item_mir_available(&self, id: DefIndex) -> bool {
 799         !self.is_proc_macro(id) &&
 800         self.maybe_entry(id).and_then(|item| item.decode(self).mir).is_some()
 801     }
 802
 803     pub fn maybe_get_item_mir(&self,
 804                               tcx: TyCtxt<'a, 'tcx, 'tcx>,
 805                               id: DefIndex)
 806                               -> Option<Mir<'tcx>> {
 807         match self.is_proc_macro(id) {
 808             true => None,
 809             false => self.entry(id).mir.map(|mir| mir.decode((self, tcx))),
 810         }
 811     }
 812
 813     pub fn mir_const_qualif(&self, id: DefIndex) -> u8 {
 814         match self.entry(id).kind {
 815             EntryKind::Const(qualif) |
 816             EntryKind::AssociatedConst(AssociatedContainer::ImplDefault, qualif) |
 817             EntryKind::AssociatedConst(AssociatedContainer::ImplFinal, qualif) => {
 818                 qualif
 819             }
 820             _ => bug!(),
 821         }
 822     }
 823
 824     pub fn get_associated_item(&self, id: DefIndex) -> ty::AssociatedItem {
 825         let item = self.entry(id);
 826         let def_key = self.def_key(id);
 827         let parent = self.local_def_id(def_key.parent.unwrap());
 828         let name = def_key.disambiguated_data.data.get_opt_name().unwrap();
 829
 830         let (kind, container, has_self) = match item.kind {
 831             EntryKind::AssociatedConst(container, _) => {
 832                 (ty::AssociatedKind::Const, container, false)
 833             }
 834             EntryKind::Method(data) => {
 835                 let data = data.decode(self);
 836                 (ty::AssociatedKind::Method, data.container, data.has_self)
 837             }
 838             EntryKind::AssociatedType(container) => {
 839                 (ty::AssociatedKind::Type, container, false)
 840             }
 841             _ => bug!()
 842         };
 843
 844         ty::AssociatedItem {
 845             name: name,
 846             kind: kind,
 847             vis: item.visibility.decode(self),
 848             defaultness: container.defaultness(),
 849             def_id: self.local_def_id(id),
 850             container: container.with_def_id(parent),
 851             method_has_self_argument: has_self
 852         }
 853     }
 854
 855     pub fn get_item_variances(&self, id: DefIndex) -> Vec<ty::Variance> {
 856         self.entry(id).variances.decode(self).collect()
 857     }
 858
 859     pub fn get_ctor_kind(&self, node_id: DefIndex) -> CtorKind {
 860         match self.entry(node_id).kind {
 861             EntryKind::Struct(data, _) |
 862             EntryKind::Union(data, _) |
 863             EntryKind::Variant(data) => data.decode(self).ctor_kind,
 864             _ => CtorKind::Fictive,
 865         }
 866     }
 867
 868     pub fn get_struct_ctor_def_id(&self, node_id: DefIndex) -> Option<DefId> {
 869         match self.entry(node_id).kind {
 870             EntryKind::Struct(data, _) => {
 871                 data.decode(self).struct_ctor.map(|index| self.local_def_id(index))
 872             }
 873             _ => None,
 874         }
 875     }
 876
 877     pub fn get_item_attrs(&self, node_id: DefIndex) -> Vec<ast::Attribute> {
 878         if self.is_proc_macro(node_id) {
 879             return Vec::new();
 880         }
 881         // The attributes for a tuple struct are attached to the definition, not the ctor;
 882         // we assume that someone passing in a tuple struct ctor is actually wanting to
 883         // look at the definition
 884         let mut item = self.entry(node_id);
 885         let def_key = self.def_key(node_id);
 886         if def_key.disambiguated_data.data == DefPathData::StructCtor {
 887             item = self.entry(def_key.parent.unwrap());
 888         }
 889         self.get_attributes(&item)
 890     }
 891
 892     pub fn get_struct_field_names(&self, id: DefIndex) -> Vec<ast::Name> {
 893         self.entry(id)
 894             .children
 895             .decode(self)
 896             .map(|index| self.item_name(index))
 897             .collect()
 898     }
 899
 900     fn get_attributes(&self, item: &Entry<'tcx>) -> Vec<ast::Attribute> {
 901         item.attributes
 902             .decode(self)
 903             .map(|mut attr| {
 904                 // Need new unique IDs: old thread-local IDs won't map to new threads.
 905                 attr.id = attr::mk_attr_id();
 906                 attr
 907             })
 908             .collect()
 909     }
 910
 911     // Translate a DefId from the current compilation environment to a DefId
 912     // for an external crate.
 913     fn reverse_translate_def_id(&self, did: DefId) -> Option<DefId> {
 914         for (local, &global) in self.cnum_map.borrow().iter_enumerated() {
 915             if global == did.krate {
 916                 return Some(DefId {
 917                     krate: local,
 918                     index: did.index,
 919                 });
 920             }
 921         }
 922
 923         None
 924     }
 925
 926     pub fn get_inherent_implementations_for_type(&self, id: DefIndex) -> Vec<DefId> {
 927         self.entry(id)
 928             .inherent_impls
 929             .decode(self)
 930             .map(|index| self.local_def_id(index))
 931             .collect()
 932     }
 933
 934     pub fn get_implementations_for_trait(&self, filter: Option<DefId>, result: &mut Vec<DefId>) {
 935         // Do a reverse lookup beforehand to avoid touching the crate_num
 936         // hash map in the loop below.
 937         let filter = match filter.map(|def_id| self.reverse_translate_def_id(def_id)) {
 938             Some(Some(def_id)) => Some((def_id.krate.as_u32(), def_id.index)),
 939             Some(None) => return,
 940             None if self.proc_macros.is_some() => return,
 941             None => None,
 942         };
 943
 944         // FIXME(eddyb) Make this O(1) instead of O(n).
 945         for trait_impls in self.root.impls.decode(self) {
 946             if filter.is_some() && filter != Some(trait_impls.trait_id) {
 947                 continue;
 948             }
 949
 950             result.extend(trait_impls.impls.decode(self).map(|index| self.local_def_id(index)));
 951
 952             if filter.is_some() {
 953                 break;
 954             }
 955         }
 956     }
 957
 958     pub fn get_trait_of_item(&self, id: DefIndex) -> Option<DefId> {
 959         self.def_key(id).parent.and_then(|parent_index| {
 960             match self.entry(parent_index).kind {
 961                 EntryKind::Trait(_) => Some(self.local_def_id(parent_index)),
 962                 _ => None,
 963             }
 964         })
 965     }
 966
 967
 968     pub fn get_native_libraries(&self) -> Vec<NativeLibrary> {
 969         self.root.native_libraries.decode(self).collect()
 970     }
 971
 972     pub fn get_dylib_dependency_formats(&self) -> Vec<(CrateNum, LinkagePreference)> {
 973         self.root
 974             .dylib_dependency_formats
 975             .decode(self)
 976             .enumerate()
 977             .flat_map(|(i, link)| {
 978                 let cnum = CrateNum::new(i + 1);
 979                 link.map(|link| (self.cnum_map.borrow()[cnum], link))
 980             })
 981             .collect()
 982     }
 983
 984     pub fn get_missing_lang_items(&self) -> Vec<lang_items::LangItem> {
 985         self.root.lang_items_missing.decode(self).collect()
 986     }
 987
 988     pub fn get_fn_arg_names(&self, id: DefIndex) -> Vec<ast::Name> {
 989         let arg_names = match self.entry(id).kind {
 990             EntryKind::Fn(data) |
 991             EntryKind::ForeignFn(data) => data.decode(self).arg_names,
 992             EntryKind::Method(data) => data.decode(self).fn_data.arg_names,
 993             _ => LazySeq::empty(),
 994         };
 995         arg_names.decode(self).collect()
 996     }
 997
 998     pub fn get_exported_symbols(&self) -> Vec<DefId> {
 999         self.exported_symbols.iter().map(|&index| self.local_def_id(index)).collect()
1000     }
1001
1002     pub fn get_macro(&self, id: DefIndex) -> (ast::Name, MacroDef) {
1003         let entry = self.entry(id);
1004         match entry.kind {
1005             EntryKind::MacroDef(macro_def) => (self.item_name(id), macro_def.decode(self)),
1006             _ => bug!(),
1007         }
1008     }
1009
1010     pub fn is_const_fn(&self, id: DefIndex) -> bool {
1011         let constness = match self.entry(id).kind {
1012             EntryKind::Method(data) => data.decode(self).fn_data.constness,
1013             EntryKind::Fn(data) => data.decode(self).constness,
1014             _ => hir::Constness::NotConst,
1015         };
1016         constness == hir::Constness::Const
1017     }
1018
1019     pub fn is_foreign_item(&self, id: DefIndex) -> bool {
1020         match self.entry(id).kind {
1021             EntryKind::ForeignImmStatic |
1022             EntryKind::ForeignMutStatic |
1023             EntryKind::ForeignFn(_) => true,
1024             _ => false,
1025         }
1026     }
1027
1028     pub fn is_dllimport_foreign_item(&self, id: DefIndex) -> bool {
1029         self.dllimport_foreign_items.contains(&id)
1030     }
1031
1032     pub fn is_default_impl(&self, impl_id: DefIndex) -> bool {
1033         match self.entry(impl_id).kind {
1034             EntryKind::DefaultImpl(_) => true,
1035             _ => false,
1036         }
1037     }
1038
1039     pub fn closure_kind(&self, closure_id: DefIndex) -> ty::ClosureKind {
1040         match self.entry(closure_id).kind {
1041             EntryKind::Closure(data) => data.decode(self).kind,
1042             _ => bug!(),
1043         }
1044     }
1045
1046     pub fn closure_ty(&self,
1047                       closure_id: DefIndex,
1048                       tcx: TyCtxt<'a, 'tcx, 'tcx>)
1049                       -> ty::PolyFnSig<'tcx> {
1050         match self.entry(closure_id).kind {
1051             EntryKind::Closure(data) => data.decode(self).ty.decode((self, tcx)),
1052             _ => bug!(),
1053         }
1054     }
1055
1056     pub fn def_key(&self, index: DefIndex) -> DefKey {
1057         self.def_path_table.def_key(index)
1058     }
1059
1060     // Returns the path leading to the thing with this `id`.
1061     pub fn def_path(&self, id: DefIndex) -> DefPath {
1062         debug!("def_path(id={:?})", id);
1063         DefPath::make(self.cnum, id, |parent| self.def_path_table.def_key(parent))
1064     }
1065
1066     /// Imports the codemap from an external crate into the codemap of the crate
1067     /// currently being compiled (the "local crate").
1068     ///
1069     /// The import algorithm works analogous to how AST items are inlined from an
1070     /// external crate's metadata:
1071     /// For every FileMap in the external codemap an 'inline' copy is created in the
1072     /// local codemap. The correspondence relation between external and local
1073     /// FileMaps is recorded in the `ImportedFileMap` objects returned from this
1074     /// function. When an item from an external crate is later inlined into this
1075     /// crate, this correspondence information is used to translate the span
1076     /// information of the inlined item so that it refers the correct positions in
1077     /// the local codemap (see `<decoder::DecodeContext as SpecializedDecoder<Span>>`).
1078     ///
1079     /// The import algorithm in the function below will reuse FileMaps already
1080     /// existing in the local codemap. For example, even if the FileMap of some
1081     /// source file of libstd gets imported many times, there will only ever be
1082     /// one FileMap object for the corresponding file in the local codemap.
1083     ///
1084     /// Note that imported FileMaps do not actually contain the source code of the
1085     /// file they represent, just information about length, line breaks, and
1086     /// multibyte characters. This information is enough to generate valid debuginfo
1087     /// for items inlined from other crates.
1088     pub fn imported_filemaps(&'a self,
1089                              local_codemap: &codemap::CodeMap)
1090                              -> Ref<'a, Vec<cstore::ImportedFileMap>> {
1091         {
1092             let filemaps = self.codemap_import_info.borrow();
1093             if !filemaps.is_empty() {
1094                 return filemaps;
1095             }
1096         }
1097
1098         let external_codemap = self.root.codemap.decode(self);
1099
1100         let imported_filemaps = external_codemap.map(|filemap_to_import| {
1101                 // Try to find an existing FileMap that can be reused for the filemap to
1102                 // be imported. A FileMap is reusable if it is exactly the same, just
1103                 // positioned at a different offset within the codemap.
1104                 let reusable_filemap = {
1105                     local_codemap.files
1106                         .borrow()
1107                         .iter()
1108                         .find(|fm| are_equal_modulo_startpos(&fm, &filemap_to_import))
1109                         .map(|rc| rc.clone())
1110                 };
1111
1112                 match reusable_filemap {
1113                     Some(fm) => {
1114
1115                         debug!("CrateMetaData::imported_filemaps reuse \
1116                                 filemap {:?} original (start_pos {:?} end_pos {:?}) \
1117                                 translated (start_pos {:?} end_pos {:?})",
1118                                filemap_to_import.name,
1119                                filemap_to_import.start_pos, filemap_to_import.end_pos,
1120                                fm.start_pos, fm.end_pos);
1121
1122                         cstore::ImportedFileMap {
1123                             original_start_pos: filemap_to_import.start_pos,
1124                             original_end_pos: filemap_to_import.end_pos,
1125                             translated_filemap: fm,
1126                         }
1127                     }
1128                     None => {
1129                         // We can't reuse an existing FileMap, so allocate a new one
1130                         // containing the information we need.
1131                         let syntax_pos::FileMap { name,
1132                                                   abs_path,
1133                                                   start_pos,
1134                                                   end_pos,
1135                                                   lines,
1136                                                   multibyte_chars,
1137                                                   .. } = filemap_to_import;
1138
1139                         let source_length = (end_pos - start_pos).to_usize();
1140
1141                         // Translate line-start positions and multibyte character
1142                         // position into frame of reference local to file.
1143                         // `CodeMap::new_imported_filemap()` will then translate those
1144                         // coordinates to their new global frame of reference when the
1145                         // offset of the FileMap is known.
1146                         let mut lines = lines.into_inner();
1147                         for pos in &mut lines {
1148                             *pos = *pos - start_pos;
1149                         }
1150                         let mut multibyte_chars = multibyte_chars.into_inner();
1151                         for mbc in &mut multibyte_chars {
1152                             mbc.pos = mbc.pos - start_pos;
1153                         }
1154
1155                         let local_version = local_codemap.new_imported_filemap(name,
1156                                                                                abs_path,
1157                                                                                source_length,
1158                                                                                lines,
1159                                                                                multibyte_chars);
1160                         debug!("CrateMetaData::imported_filemaps alloc \
1161                                 filemap {:?} original (start_pos {:?} end_pos {:?}) \
1162                                 translated (start_pos {:?} end_pos {:?})",
1163                                local_version.name, start_pos, end_pos,
1164                                local_version.start_pos, local_version.end_pos);
1165
1166                         cstore::ImportedFileMap {
1167                             original_start_pos: start_pos,
1168                             original_end_pos: end_pos,
1169                             translated_filemap: local_version,
1170                         }
1171                     }
1172                 }
1173             })
1174             .collect();
1175
1176         // This shouldn't borrow twice, but there is no way to downgrade RefMut to Ref.
1177         *self.codemap_import_info.borrow_mut() = imported_filemaps;
1178         self.codemap_import_info.borrow()
1179     }
1180 }
1181
1182 fn are_equal_modulo_startpos(fm1: &syntax_pos::FileMap, fm2: &syntax_pos::FileMap) -> bool {
1183     if fm1.byte_length() != fm2.byte_length() {
1184         return false;
1185     }
1186
1187     if fm1.name != fm2.name {
1188         return false;
1189     }
1190
1191     let lines1 = fm1.lines.borrow();
1192     let lines2 = fm2.lines.borrow();
1193
1194     if lines1.len() != lines2.len() {
1195         return false;
1196     }
1197
1198     for (&line1, &line2) in lines1.iter().zip(lines2.iter()) {
1199         if (line1 - fm1.start_pos) != (line2 - fm2.start_pos) {
1200             return false;
1201         }
1202     }
1203
1204     let multibytes1 = fm1.multibyte_chars.borrow();
1205     let multibytes2 = fm2.multibyte_chars.borrow();
1206
1207     if multibytes1.len() != multibytes2.len() {
1208         return false;
1209     }
1210
1211     for (mb1, mb2) in multibytes1.iter().zip(multibytes2.iter()) {
1212         if (mb1.bytes != mb2.bytes) || ((mb1.pos - fm1.start_pos) != (mb2.pos - fm2.start_pos)) {
1213             return false;
1214         }
1215     }
1216
1217     true
1218 }