rust trait 熟识系列：一日一trait之Seek trait

Posted 2022-01-03 lyh225

Seek 顾名思义就是用来方便查找的trait，其内部提供了一个在字节流(stream of bytes)移动的游标(cursor)，移动游标
可以改变操作字节流的位置。

Seek trait 定义

pub trait Seek 
    fn seek(&mut self, pos: SeekFrom) -> Result<u64>;
    fn rewind(&mut self) -> Result<()>  ... 
	fn stream_len(&mut self) -> Result<u64>  ... 
	fn stream_position(&mut self) -> Result<u64>  ... 

seek所需方法参数SeekFrom定义了IO对象查找的可能方法

pub enum SeekFrom 
    Start(u64),
    End(i64),
    Current(i64),

例子

标准库的File实现了Seek trait

use std::io;
use std::io::prelude::*;
use std::fs::File;
use std::io::SeekFrom;

fn main() -> io::Result<()> 
    let mut f = File::open("foo.txt")?;

    // move the cursor 42 bytes from the start of the file
    f.seek(SeekFrom::Start(42))?;
    Ok(())

Cursor

cursor 实现了Seek trait，用来包装 内存缓存(in-memory buffer)。
说白了，任意实现了AsRef<[u8]>的类型，用Cursor包装后，就实现了Read trait 和Write trait。
比如标准库里就有Cursor<Vec<u8>>和Cursor<&[u8]>这样的使用例子。

use std::io::Cursor;
use std::io::SeekFrom;
use std::io::prelude::*;

fn main() 

    let mut buff = Cursor::new(vec![0;15]);
    buff.seek(SeekFrom::End(-10)).unwrap();
    for i in 0..10 
    	buff.write(&[i]).unwrap();
    
    println!(":?", buff);

上面用Cursor包装了Vec, 并且将cursor移动到了倒数第10个的位置写入，结果为：

Cursor  inner: [0, 0, 0, 0, 0, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9], pos: 15 

在rust中怎么创建一个可读写的内存对象 里提到了用Cursor来实现类似python StringIO库的方法，值得一看