Структура WriteHalf

pub struct WriteHalf<'a>(/* private fields */);

Доступно только в Unix и при включённой функции crate net.

Заимствованная пишущая половина UnixStream, созданная с помощью split.

Обратите внимание: в реализации AsyncWrite для этого типа вызов poll_shutdown завершит работу потока UnixStream в направлении записи.

Запись в WriteHalf обычно выполняется с помощью удобных методов, предоставляемых трейтом AsyncWriteExt.

Реализации

impl WriteHalf<'_>

pub async fn ready(&self, interest: Interest) -> Result<Ready>

Ожидает наступления любого из запрошенных состояний готовности.

Эта функция обычно используется в паре с try_write(). Её можно использовать вместо writable(), чтобы проверить, содержит ли возвращённый набор готовности события Ready::WRITABLE и Ready::WRITE_CLOSED.

Функция может завершиться, даже если сокет не готов. Это ложное срабатывание, и попытка выполнить операцию завершится ошибкой io::ErrorKind::WouldBlock. Функция также может вернуть пустой набор Ready, поэтому всегда проверяйте возвращённое значение и при необходимости ожидайте снова, если запрошенные состояния не установлены.

Эта функция эквивалентна UnixStream::ready.

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

Этот метод безопасен при отмене. После возникновения события готовности метод будет немедленно возвращать управление, пока событие готовности не будет обработано попыткой чтения или записи, завершившейся с ошибкой WouldBlock или Poll::Pending.

pub async fn writable(&self) -> Result<()>

Ожидает, пока сокет не станет доступен для записи.

Эта функция эквивалентна ready(Interest::WRITABLE) и обычно используется в паре с try_write().

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

Этот метод безопасен при отмене. После возникновения события готовности метод будет немедленно возвращать управление, пока событие готовности не будет обработано попыткой записи, завершившейся с ошибкой WouldBlock или Poll::Pending.

pub fn try_write(&self, buf: &[u8]) -> Result<usize>

Пытается записать буфер в поток и возвращает количество записанных байтов.

Функция попытается записать всё содержимое buf, однако может быть записана только часть буфера.

Эта функция обычно используется в паре с writable().

Возвращаемое значение

Если данные успешно записаны, возвращается Ok(n), где n — количество записанных байтов. Если поток не готов к записи данных, возвращается Err(io::ErrorKind::WouldBlock).

pub fn try_write_vectored(&self, buf: &[IoSlice<'_>]) -> Result<usize>

Пытается записать в поток несколько буферов и возвращает количество записанных байтов.

Данные записываются последовательно из каждого буфера; последний буфер может быть прочитан лишь частично. Этот метод эквивалентен одному вызову try_write() с объединёнными буферами.

Эта функция обычно используется в паре с writable().

Возвращаемое значение

pub fn peer_addr(&self) -> Result<SocketAddr>

Возвращает адрес сокета удалённой стороны этого соединения.

pub fn local_addr(&self) -> Result<SocketAddr>

Возвращает адрес сокета локальной стороны этого соединения.

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

impl AsRef<UnixStream> for WriteHalf<'_>

fn as_ref(&self) -> &UnixStream

Преобразует этот тип в общую ссылку на тип входного значения (обычно выводимый).

impl AsyncWrite for WriteHalf<'_>

fn poll_write( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &[u8], ) -> Poll<Result<usize>>

Попытка записать байты из buf в объект. Подробнее

fn poll_write_vectored( self: Pin<&mut Self>, cx: &mut Context<'_>, bufs: &[IoSlice<'_>], ) -> Poll<Result<usize>>

Как и poll_write, но данные записываются из среза буферов. Подробнее

fn is_write_vectored(&self) -> bool

Определяет, есть ли у этого средства записи эффективная реализация poll_write_vectored. Подробнее

fn poll_flush(self: Pin<&mut Self>, _: &mut Context<'_>) -> Poll<Result<()>>

Пытается сбросить данные объекта, гарантируя, что все буферизованные данные достигнут места назначения. Подробнее

fn poll_shutdown(self: Pin<&mut Self>, _: &mut Context<'_>) -> Poll<Result<()>>

Инициирует или пытается завершить работу этого средства записи; возвращает успех, когда соединение ввода-вывода полностью закрыто. Подробнее

impl<'a> Debug for WriteHalf<'a>

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

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

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

impl<'a> Freeze for WriteHalf<'a>

impl<'a> RefUnwindSafe for WriteHalf<'a>

impl<'a> Send for WriteHalf<'a>

impl<'a> Sync for WriteHalf<'a>

impl<'a> Unpin for WriteHalf<'a>

impl<'a> UnsafeUnpin for WriteHalf<'a>

impl<'a> UnwindSafe for WriteHalf<'a>

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

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