Struct Buffer

pub struct Buffer { /* private fields */ }

A Buffer is a variable-sized buffer of bytes with Read and Write methods. The zero value for Buffer is an empty buffer ready to use.

zh-cn

Buffer是一个实现了读写方法的可变大小的字节缓冲。本类型的零值是一个空的可用于读写的缓冲。

Example

 use gostd_io::*;
 use gostd_bytes::Buffer;

 let mut buf = Buffer::new();
 buf.WriteString("hello");
 buf.WriteByte(b' ');
 buf.WriteString("world");
 buf.WriteByte(b'!');

 assert_eq!("hello world!", buf.String());

 buf.Reset(); // clear 清空数据
 for i in 'a'..='z' {
  buf.WriteByte(i as u8);
 }
 assert_eq!("abcdefghijklmnopqrstuvwxyz", buf.String());

Implementations

impl Buffer

pub fn new() -> Buffer

new initialization a Buffer

zh-cn

初始化生成器

pub fn with_bytes(buf: Vec<byte>) -> Buffer

with_bytes creates and initializes a new Buffer using buf as its initial contents. The new Buffer takes ownership of buf, and the caller should not use buf after this call. with_bytes is intended to prepare a Buffer to read existing data. It can also be used to set the initial size of the internal buffer for writing. To do that, buf should have the desired capacity but a length of zero.

In most cases, new() is sufficient to initialize a Buffer.

zh-cn

使用buf作为初始内容创建并初始化一个Buffer。本函数用于创建一个用于读取已存在数据的buffer；也用于指定用于写入的内部缓冲的大小，此时，buf应为一个具有指定容量但长度为0的切片。buf会被作为返回值的底层缓冲切片。

pub fn with_str(s: &str) -> Buffer

with_str creates and initializes a new Buffer using string s as its initial contents. It is intended to prepare a buffer to read an existing string.

In most cases, new() is sufficient to initialize a Buffer.

zh-cn

使用s作为初始内容创建并初始化一个Buffer。本函数用于创建一个用于读取已存在数据的buffer。

pub fn Cap(&self) -> int

Cap returns the capacity of the builder’s underlying byte slice. It is the total space allocated for the string being built and includes any bytes already written.

zh-cn

Cap返回构建器底层字节切片的容量。它是为正在生成的字符串分配的总空间，包括已写入的所有字节。

pub fn Grow(&mut self, n: int)

Grow grows b’s capacity, if necessary, to guarantee space for another n bytes. After Grow(n), at least n bytes can be written to b without another allocation. If n is negative, Grow panics.

zh-cn

如果需要的话，Grow会增加b的容量，以保证另一个n字节的空间。在Grow（n）之后，至少可以将n个字节写入b而无需另一次分配。如果n为负，则增加恐慌。

pub fn Len(&self) -> int

Len returns the number of accumulated bytes; b.Len() == len!(b.String()).

zh-cn

Len返回累计字节数；b.Len() == len!(b.String()).

pub fn Reset(&mut self)

Reset resets the Builder to be empty.

zh-cn

重置将生成器重置为空。

pub fn Bytes(&self) -> Vec<byte>

String returns the accumulated string.

zh-cn

返回累积的字节序列

pub fn String(&self) -> String

String returns the accumulated string.

zh-cn

返回累积的字符串。

pub fn WriteRune<'a>(&mut self, r: rune) -> Result<int, &'a str>

WriteRune appends the UTF-8 encoding of Unicode code point r to b’s buffer. It returns the length of r.

zh-cn

将Unicode代码点r的UTF-8编码附加到b的缓冲区。它返回r的长度。

Trait Implementations

impl ByteWriter for Buffer

fn WriteByte(&mut self, c: byte) -> Result<(), Error>

WriteByte appends the byte c to b’s buffer.

zh-cn

WriteByte将字节c追加到b的缓冲区。

impl Clone for Buffer

fn clone(&self) -> Buffer

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Buffer

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

Formats the value using the given formatter.

impl Default for Buffer

fn default() -> Buffer

Returns the “default value” for a type.

impl Display for Buffer

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

Formats the value using the given formatter.

impl PartialEq for Buffer

fn eq(&self, other: &Buffer) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Buffer

fn partial_cmp(&self, other: &Buffer) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StringWriter for Buffer

fn WriteString(&mut self, s: &str) -> Result<int, Error>

WriteString appends the contents of s to b’s buffer. It returns the length of s.

zh-cn

WriteString将s的内容附加到b的缓冲区。它返回s的长度。

impl Writer for Buffer

fn Write<'a>(&mut self, p: Vec<byte>) -> Result<int, Error>

Write appends the contents of p to b’s buffer. Write always returns len!(p).

zh-cn

Write将p的内容附加到b的缓冲区, 写总是返回len!(p).

impl StructuralPartialEq for Buffer