Struct Iter

#[must_use = "iterators are lazy and do nothing unless consumed"]
pub struct Iter<'a> { pub(in ::path) inner: Components<'a> }

An iterator over the Components of a Path, as OsStr slices.

This struct is created by the iter method on Path. See its documentation for more.

Fields

inner: Components<'a>

Implementations

impl<'a> Iter<'a>

fn as_path(&self) -> &'a Path

Extracts a slice corresponding to the portion of the path remaining for iteration.

Examples

use std::path::Path;

let mut iter = Path::new("/tmp/foo/bar.txt").iter();
iter.next();
iter.next();

assert_eq!(Path::new("foo/bar.txt"), iter.as_path());

Trait Implementations

impl AsRef<OsStr> for Iter<'_>

fn as_ref(&self) -> &OsStr

impl AsRef<Path> for Iter<'_>

fn as_ref(&self) -> &Path

impl Debug for Iter<'_>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl FusedIterator for Iter<'_>

impl<'a> Clone for Iter<'a>

fn clone(&self) -> Self

impl<'a> DoubleEndedIterator for Iter<'a>

fn next_back(&mut self) -> Option<&'a OsStr>

impl<'a> Iterator for Iter<'a>

type Item = &'a OsStr;
fn next(&mut self) -> Option<&'a OsStr>

Auto Trait Implementations

impl<'a> Freeze for Iter<'a>

impl<'a> RefUnwindSafe for Iter<'a>

impl<'a> Send for Iter<'a>

impl<'a> Sync for Iter<'a>

impl<'a> Unpin for Iter<'a>

impl<'a> UnsafeUnpin for Iter<'a>

impl<'a> UnwindSafe for Iter<'a>

Blanket Implementations

impl<I> IntoIterator for Iter<'a> where I: Iterator,

type Item = <I as Iterator>::Item;
type IntoIter = I;
fn into_iter(self) -> I

impl<T> Any for Iter<'a> where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for Iter<'a> where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for Iter<'a> where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> CloneToUninit for Iter<'a> where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

impl<T> From<T> for Iter<'a>

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> SizeHint for Iter<'a> where T: ?Sized,

fn lower_bound(&self) -> usize
fn upper_bound(&self) -> Option<usize>

impl<T> SizedTypeProperties for Iter<'a>

impl<T> ToOwned for Iter<'a> where T: Clone,

type Owned = T;
fn to_owned(&self) -> T
fn clone_into(&self, target: &mut T)

impl<T, U> Into<U> for Iter<'a> where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of [From]<T> for U chooses to do.

impl<T, U> TryFrom<U> for Iter<'a> where U: Into<T>,

type Error = never;
fn try_from(value: U) -> Result<T, never>

impl<T, U> TryInto<U> for Iter<'a> where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error;
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>