Go中常用包筆記 bufio:帶緩沖的IO操作/SCANNER（二）

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  //上次掃描的結果
    
  切割器：

func ScanBytes(data []byte, atEOF bool) (advance int, token []byte, err error)
func ScanLines(data []byte, atEOF bool) (advance int, token []byte, err error)
func ScanRunes(data []byte, atEOF bool) (advance int, token []byte, err error)
func ScanWords(data []byte, atEOF bool) (advance int, token []byte, err error)

四個切割器，分割字節數組中的第一個字節/第一行/第一個Rune(UTF8字)/單詞(不包含空格),方法本身可以作為

func (s *Scanner) Split(split SplitFunc)

的參數，配合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)