Структура Lines
pub struct Lines<R> { /* private fields */ }
io-util.Читает строки из AsyncBufRead.
Значение типа Lines можно преобразовать в Stream с помощью LinesStream.
Обычно этот тип создаётся с помощью метода lines.
Реализации
impl<R> Lines<R>where R: AsyncBufRead + Unpin,
pub async fn next_line(&mut self) -> Result<Option<String>>
Возвращает следующую строку в потоке.
Безопасность отмены
Этот метод безопасен при отмене.
Примеры
use tokio::io::AsyncBufReadExt;
let mut lines = my_buf_read.lines();
while let Some(line) = lines.next_line().await? {
println!("length = {}", line.len())
}pub fn into_inner(self) -> R
Извлекает нижележащий объект чтения из этого значения Lines<R>.
Обратите внимание, что все оставшиеся данные во внутреннем буфере будут потеряны. Поэтому последующее чтение из нижележащего объекта чтения может привести к потере данных.
impl<R> Lines<R>where R: AsyncBufRead,
pub fn poll_next_line( self: Pin<&mut Self>, cx: &mut Context<'_>, ) -> Poll<Result<Option<String>>>
Проверяет готовность следующей строки в потоке.
Этот метод возвращает:
-
Poll::Pending, если следующая строка ещё недоступна. -
Poll::Ready(Ok(Some(line))), если следующая строка доступна. -
Poll::Ready(Ok(None)), если в этом потоке больше нет строк. -
Poll::Ready(Err(err)), если при чтении следующей строки произошла ошибка ввода-вывода.
Если метод возвращает Poll::Pending, для Waker в переданном Context запланировано уведомление о пробуждении, когда во внешнем ресурсе ввода-вывода станут доступны новые байты. Обратите внимание: при нескольких вызовах poll_next_line уведомление о пробуждении запланировано только для Waker из Context, переданного в последнем вызове.
Реализации трейтов
impl<'__pin, R> Unpin for Lines<R>where PinnedFieldsOf<__Origin<'__pin, R>>: Unpin,
Автоматические реализации трейтов
impl<R> Freeze for Lines<R>where R: Freeze,
impl<R> RefUnwindSafe for Lines<R>where R: RefUnwindSafe,
impl<R> Send for Lines<R>where R: Send,
impl<R> Sync for Lines<R>where R: Sync,
impl<R> UnsafeUnpin for Lines<R>where R: UnsafeUnpin,
impl<R> UnwindSafe for Lines<R>where R: UnwindSafe,
Общие реализации
impl<T> BorrowMut<T> for Twhere T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
impl<T> Instrument for T
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
impl<T> WithSubscriber for T
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ
Subscriber к этому типу и возвращает обёртку WithDispatch. Подробнее
MIT License
Copyright © Tokio Contributors
https://docs.rs/tokio/1.53.1/tokio/io/struct.Lines.html