Spec-Zone.ru › Tokio

Структура DirBuilder

pub struct DirBuilder { /* private fields */ }
Доступно только при включённой возможности crate fs.

Построитель для создания каталогов различными способами.

Это специализированная версия std::fs::DirBuilder для использования в среде выполнения Tokio.

Реализации

impl DirBuilder

pub fn new() -> Self

Создаёт новый набор параметров с настройками режима и безопасности по умолчанию для всех платформ, а также без рекурсии.

Это асинхронная версия std::fs::DirBuilder::new.

Примеры
use tokio::fs::DirBuilder;

let builder = DirBuilder::new();

pub fn recursive(&mut self, recursive: bool) -> &mut Self

Указывает, следует ли создавать каталоги рекурсивно (включая все родительские каталоги). Несуществующие родительские каталоги создаются с теми же настройками безопасности и разрешений.

По умолчанию этот параметр равен false.

Это асинхронная версия std::fs::DirBuilder::recursive.

Примеры
use tokio::fs::DirBuilder;

let mut builder = DirBuilder::new();
builder.recursive(true);

pub async fn create(&self, path: impl AsRef<Path>) -> Result<()>

Создаёт указанный каталог с заданными параметрами.

Если каталог уже существует, это считается ошибкой, если не включён рекурсивный режим.

Это асинхронная версия std::fs::DirBuilder::create.

Ошибки

В следующих случаях будет возвращена ошибка:

  • Путь уже указывает на существующий файл.
  • Путь уже указывает на существующий каталог, а режим не является рекурсивным.
  • У вызывающего процесса нет разрешений на создание каталога или отсутствующих родительских каталогов.
  • Произошла другая ошибка ввода-вывода.
Примеры
use tokio::fs::DirBuilder;
use std::io;

#[tokio::main]
async fn main() -> io::Result<()> {
    DirBuilder::new()
        .recursive(true)
        .create("/tmp/foo/bar/baz")
        .await?;

    Ok(())
}

impl DirBuilder

pub fn mode(&mut self, mode: u32) -> &mut Self

Доступно только в Unix.

Задаёт режим, с которым будут создаваться новые каталоги.

По умолчанию этот параметр равен 0o777.

Примеры
use tokio::fs::DirBuilder;

let mut builder = DirBuilder::new();
builder.mode(0o775);

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

impl Debug for DirBuilder

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

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

impl Default for DirBuilder

fn default() -> DirBuilder

Возвращает «значение по умолчанию» для типа. Подробнее

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

impl Freeze for DirBuilder

impl RefUnwindSafe for DirBuilder

impl Send for DirBuilder

impl Sync for DirBuilder

impl Unpin for DirBuilder

impl UnsafeUnpin for DirBuilder

impl UnwindSafe for DirBuilder

Общие реализации

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.DirBuilder.html

Spec-Zone.ru

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