Структура OpenOptions

Создаёт новый пустой набор параметров, готовый к настройке.

Изначально для всех параметров установлено значение false.

Задаёт параметр доступа на чтение и запись.

Если этот параметр имеет значение true, файл FIFO будет открыт в режиме доступа на чтение и запись. Эта операция не определена стандартом POSIX, и её работа гарантируется только в Linux.

Примеры

Открытие Sender, даже если нет открытых концов для чтения:

use tokio::net::unix::pipe;

let tx = pipe::OpenOptions::new()
    .read_write(true)
    .open_sender("path/to/a/fifo");

Открытие устойчивого Receiver, то есть конца канала для чтения, который не завершится ошибкой UnexpectedEof во время чтения, если все концы канала для записи закроют файл FIFO.

use tokio::net::unix::pipe;

let tx = pipe::OpenOptions::new()
    .read_write(true)
    .open_receiver("path/to/a/fifo");

Задаёт параметр, отключающий проверку типа файла FIFO.

По умолчанию функции open_receiver и open_sender проверяют, является ли открываемый файл файлом FIFO. Установите для этого параметра значение true, если вы уверены, что файл является файлом FIFO.

Примеры

use tokio::net::unix::pipe;
use nix::{unistd::mkfifo, sys::stat::Mode};

// Our program has exclusive access to this path.
const FIFO_NAME: &str = "path/to/a/new/fifo";

mkfifo(FIFO_NAME, Mode::S_IRWXU)?;
let rx = pipe::OpenOptions::new()
    .unchecked(true)
    .open_receiver(FIFO_NAME)?;

Создаёт Receiver из файла FIFO с параметрами, заданными в self.

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

Ошибки

Если проверка типа файла завершится неудачно, эта функция вернёт ошибку io::ErrorKind::InvalidInput. Также эта функция может завершиться с другими стандартными ошибками ОС.

Паника

Эта функция вызывает панику, если её вызвать вне среды выполнения с включённым вводом-выводом.

Среда выполнения обычно устанавливается неявно, когда эта функция вызывается из future, выполняемого средой выполнения tokio. В противном случае среду выполнения можно установить явно с помощью функции Runtime::enter.

Создаёт Sender из файла FIFO с параметрами, заданными в self.

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

Ошибки

Если проверка типа файла завершится неудачно, эта функция вернёт ошибку io::ErrorKind::InvalidInput. Если файл открыт не в режиме доступа на чтение и запись и в данный момент не открыт для чтения, эта функция вернёт ошибку ENXIO. Также эта функция может завершиться с другими стандартными ошибками ОС.

Паника

Эта функция вызывает панику, если её вызвать вне среды выполнения с включённым вводом-выводом.

Среда выполнения обычно устанавливается неявно, когда эта функция вызывается из future, выполняемого средой выполнения tokio. В противном случае среду выполнения можно установить явно с помощью функции Runtime::enter.

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

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

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