src/libcore/iter_private.rs

   1 // Copyright 2016 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
  12 use iter::ExactSizeIterator;
  13
  14 /// An iterator whose items are random accessible efficiently
  15 ///
  16 /// # Safety
  17 ///
  18 /// The iterator's .len() and size_hint() must be exact.
  19 ///
  20 /// .get_unchecked() must return distinct mutable references for distinct
  21 /// indices (if applicable), and must return a valid reference if index is in
  22 /// 0..self.len().
  23 #[doc(hidden)]
  24 pub unsafe trait TrustedRandomAccess : ExactSizeIterator {
  25     unsafe fn get_unchecked(&mut self, i: usize) -> Self::Item;
  26 }
  27