Struct std::io::Empty

#[non_exhaustive]
pub struct Empty;

始终处于 EOF 的 reader。

通常通过调用 empty() 来创建此结构体。 请参见 empty() 的文档以获取更多详细信息。

Trait Implementations

impl BufRead for Empty

fn fill_buf(&mut self) -> Result<&[u8]>

返回内部缓冲区的内容，如果内部缓冲区为空，则使用内部 reader 中的更多数据填充内部缓冲区。

fn consume(&mut self, _n: usize)

告诉此缓冲区 amt 字节已从缓冲区中消耗掉，因此在调用 read 时不再应返回它们。

fn has_data_left(&mut self) -> Result<bool>

🔬 This is a nightly-only experimental API. (buf_read_has_data_left #86423)

recently added

检查底层 Read 是否有任何数据可供读取。

fn read_until(&mut self, byte: u8, buf: &mut Vec<u8>) -> Result<usize>

将所有字节读入 buf，直到到达定界符 byte 或 EOF。

fn read_line(&mut self, buf: &mut String) -> Result<usize>

读取所有字节，直到到达换行符 (0xA 字节)，然后将它们附加到提供的缓冲区中。

fn split(self, byte: u8) -> Split<Self> where
    Self: Sized, 

返回对该字节 byte 上的 reader 拆分内容的迭代器。

fn lines(self) -> Lines<Self> where
    Self: Sized, 

返回此 reader 的各行上的迭代器。

impl Debug for Empty

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

使用给定的格式化程序格式化该值。

impl Read for Empty

fn read(&mut self, _buf: &mut [u8]) -> Result<usize>

从该源中提取一些字节到指定的缓冲区中，返回读取的字节数。

unsafe fn initializer(&self) -> Initializer

🔬 This is a nightly-only experimental API. (read_initializer #42788)

确定该 Reader 是否可以与未初始化内存的缓冲区一起使用。

fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize>

与 read 相似，不同之处在于它读入缓冲区的一部分。

fn is_read_vectored(&self) -> bool

🔬 This is a nightly-only experimental API. (can_vector #69941)

确定此 Read 是否具有有效的 read_vectored 实现。

fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize>

读取所有字节，直到此源中的 EOF 为止，然后将它们放入 buf。

fn read_to_string(&mut self, buf: &mut String) -> Result<usize>

读取所有字节，直到该源中的 EOF 为止，然后将它们附加到 buf。

fn read_exact(&mut self, buf: &mut [u8]) -> Result<()>

读取填充 buf 所需的确切字节数。

fn by_ref(&mut self) -> &mut Self where
    Self: Sized, 

为此 Read 实例创建 “by reference” 适配器。

fn bytes(self) -> Bytes<Self> where
    Self: Sized, 

将此 Read 实例的字节数转换为 Iterator。

fn chain<R: Read>(self, next: R) -> Chain<Self, R> where
    Self: Sized, 

创建一个适配器，它将将此流与另一个流链接。

fn take(self, limit: u64) -> Take<Self> where
    Self: Sized, 

创建一个适配器，该适配器最多可以从中读取 limit 字节。

impl Seek for Empty

fn seek(&mut self, _pos: SeekFrom) -> Result<u64>

在流中寻找以字节为单位的偏移量。

fn stream_len(&mut self) -> Result<u64>

🔬 This is a nightly-only experimental API. (seek_stream_len #59359)

返回此流的长度 (以字节为单位)。

fn stream_position(&mut self) -> Result<u64>

从流的开头返回当前搜索位置。

fn rewind(&mut self) -> Result<()>

返回到流的开头。