Spec-Zone.ru › Tokio

Структура ReadDir

pub struct ReadDir(/* private fields */);
Доступно только при включённой функции crate fs.

Читает записи каталога.

Эта структура возвращается функцией read_dir этого модуля и предоставляет экземпляры DirEntry. С помощью DirEntry можно получить информацию, например путь к записи и, возможно, другие метаданные.

ReadDir можно преобразовать в Stream с помощью ReadDirStream.

Ошибки

Этот поток вернёт Err, если во время итерации произойдёт временная ошибка ввода-вывода.

Реализации

impl ReadDir

pub async fn next_entry(&mut self) -> Result<Option<DirEntry>>

Возвращает следующую запись в потоке каталога.

Безопасность отмены

Этот метод безопасен при отмене.

pub fn poll_next_entry( &mut self, cx: &mut Context<'_>, ) -> Poll<Result<Option<DirEntry>>>

Проверяет наличие следующей записи каталога в потоке.

Этот метод возвращает:

  • Poll::Pending, если следующая запись каталога ещё недоступна.
  • Poll::Ready(Ok(Some(entry))), если следующая запись каталога доступна.
  • Poll::Ready(Ok(None)), если в этом потоке больше нет записей каталога.
  • Poll::Ready(Err(err)), если при чтении следующей записи каталога произошла ошибка ввода-вывода.

Когда метод возвращает Poll::Pending, Waker в переданном Context планируется разбудить, когда следующая запись каталога станет доступна в базовом ресурсе ввода-вывода.

Обратите внимание: при многократных вызовах poll_next_entry пробуждение планируется только для Waker из Context, переданного в последнем вызове.

Реализации трейтов

impl Debug for ReadDir

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

Форматирует значение с помощью заданного форматировщика. Подробнее

Автоматические реализации трейтов

impl !RefUnwindSafe for ReadDir

impl !UnwindSafe for ReadDir

impl Freeze for ReadDir

impl Send for ReadDir

impl Sync for ReadDir

impl Unpin for ReadDir

impl UnsafeUnpin for ReadDir

Обобщённые реализации

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

fn type_id(&self) -> TypeId

Получает TypeId типа self. Подробнее

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Неизменяемо заимствует значение из принадлежащего значения. Подробнее

impl<T> BorrowMut<T> for T
where T: ?Sized,

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

Изменяемо заимствует значение из принадлежащего значения. Подробнее

impl<T> From<T> for T

fn from(t: T) -> T

Возвращает аргумент без изменений.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Инструментирует этот тип с помощью предоставленного Span, возвращая обёртку Instrumented. Подробнее

fn in_current_span(self) -> Instrumented<Self> ⓘ

Инструментирует этот тип с помощью текущего Span, возвращая обёртку Instrumented. Подробнее

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Вызывает U::from(self).

То есть это преобразование выполняется так, как предписывает реализация From<T> for U.

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

Тип, возвращаемый в случае ошибки преобразования.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Выполняет преобразование.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

Тип, возвращаемый в случае ошибки преобразования.

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

Выполняет преобразование.

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Присоединяет указанный Subscriber к этому типу и возвращает обёртку WithDispatch. Подробнее

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Присоединяет текущий по умолчанию Subscriber к этому типу и возвращает обёртку WithDispatch. Подробнее

MIT License
Copyright © Tokio Contributors
https://docs.rs/tokio/1.53.1/tokio/fs/struct.ReadDir.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API