Package bufio

提供可缓存的IO访问




Scanner:
func NewScanner(r io.Reader) *Scanner //构造函数
func (s *Scanner) Buffer(buf []byte, max int) //指定使用的缓冲区
func (s *Scanner) Split(split SplitFunc) //设定切割函数 使用四个切割器
func (s *Scanner) Scan() bool //扫描
func (s *Scanner) Err() error //扫描发生的错误
func (s *Scanner) Bytes() []byte //上次扫描的结果
func (s *Scanner) Text() string //上次扫描的结果

切割器:

funcScanBytes(data[]byte,atEOFbool)(advanceint,token[]byte,errerror)funcScanLines(data[]byte,atEOFbool)(advanceint,token[]byte,errerror)funcScanRunes(data[]byte,atEOFbool)(advanceint,token[]byte,errerror)funcScanWords(data[]byte,atEOFbool)(advanceint,token[]byte,errerror)

四个切割器,分割字节数组中的第一个字节/第一行/第一个Rune(UTF8字)/单词(不包含空格),方法本身可以作为

func(s*Scanner)Split(splitSplitFunc)

的参数,配合Scanner按照字节/Rune/单词/行进行扫描,例如:

s:=strings.NewReader()bs:=bufio.NewScanner(s)bs.Split(bufio.ScanWords)bs.Scan(){fmt.Printf(,bs.Text())}func(s*Scanner)Bytes()[]byte


Reader

func NewReader(rd io.Reader) *Reader //构造函数

func NewReaderSize(rd io.Reader, size int) *Reader//构造函数,指定缓冲区大小

func (b *Reader) Buffered() int //获取缓冲区中数据大小

func (b *Reader) Discard(n int) (discarded int, err error) //跳过若干字节不读,实际跳过的字节不会比缓冲区剩余的多(若缓冲区为空则填充一次缓冲区)

func (b *Reader) Peek(n int) ([]byte, error) //返回缓冲区的一个切片(缓冲区的引用,不会将数据读出)

func (b *Reader) Read(p []byte) (n int, err error) //读取若干字节

func (b *Reader) ReadByte() (byte, error) //读取一个字节

func (b *Reader) ReadBytes(delim byte) ([]byte, error) //寻找一个字节并返回字节之前的全部内容

func (b *Reader) ReadLine() (line []byte, isPrefix bool, err error)//读取一行,推荐使用ReadBytes('\n') 或 ReadString('\n')的方式以替代

func (b *Reader) ReadRune() (r rune, size int, err error) //读取一个Rune

func (b *Reader) ReadSlice(delim byte) (line []byte, err error) //读出数据 返回其切片

func (b *Reader) ReadString(delim byte) (string, error) //读出字符串

func (b *Reader) Reset(r io.Reader) //丢弃缓存重置状态

func (b *Reader) UnreadByte() error //撤销最近一次readByte操作

func (b *Reader) UnreadRune() error //类似上

func (b *Reader) WriteTo(w io.Writer) (n int64, err error) //reader直接写入一个Writer


Writer

func NewWriter(w io.Writer) *Writer

func NewWriterSize(w io.Writer, size int) *Writer

func (b *Writer) Available() int //缓冲区中可用大小

func (b *Writer) Buffered() int //缓冲区中未提交的数据的大小

func (b *Writer) Flush() error //提交缓冲区中数据

func (b *Writer) ReadFrom(r io.Reader) (n int64, err error) //从一个reader中读取并写入

func (b *Writer) Reset(w io.Writer)//丢弃缓存重置状态

func (b *Writer) Write(p []byte) (nn int, err error)

func (b *Writer) WriteByte(c byte) error

func (b *Writer) WriteRune(r rune) (size int, err error)

func (b *Writer) WriteString(s string) (int, error)