`bufio.Reader.ReadLine` în Go

Citire și scriere cu buffer (bufio) Go 1.0

Citește un rând fără caracterul de final, la nivel scăzut; rândurile prea lungi vin pe bucăți.

Sintaxă

func (b *Reader) ReadLine() (line []byte, isPrefix bool, err error)

Ce face `bufio.Reader.ReadLine`

ReadLine returnează un rând fără \n sau \r\n. Dacă rândul nu încape în buffer, primești o bucată și isPrefix = true; restul vine la apelurile următoare.

Documentația o descrie ca primitivă de nivel scăzut: majoritatea programelor ar trebui să folosească ReadString('\n'), ReadBytes('\n') sau bufio.Scanner. Slice-ul returnat arată în buffer-ul intern și este valabil doar până la următoarea citire.

Ce returnează

Rândul (sau o bucată din el), isPrefix și eroarea (io.EOF la final).

Exemple

Exemplul 1: Rânduri fără caracterul de final

Și \r\n (format Windows) este eliminat.

package main

import (
    "bufio"
    "fmt"
    "strings"
)

func main() {
    r := bufio.NewReader(strings.NewReader("Ana\r\nMihai\nIoana"))
    for {
        linie, _, err := r.ReadLine()
        if err != nil {
            fmt.Println("stop:", err)
            break
        }
        fmt.Printf("%q\n", linie)
    }
}

Rezultat

"Ana"
"Mihai"
"Ioana"
stop: EOF

Exemplul 2: Rând mai lung decât buffer-ul

Cu un buffer de 16 octeți (minimul permis), rândul lung vine în bucăți marcate cu isPrefix.

package main

import (
    "bufio"
    "fmt"
    "strings"
)

func main() {
    text := "Acesta este un rând foarte lung din jurnal\nscurt\n"
    r := bufio.NewReaderSize(strings.NewReader(text), 16)
    var complet []byte
    for {
        bucata, prefix, err := r.ReadLine()
        if err != nil {
            break
        }
        complet = append(complet, bucata...)
        fmt.Printf("bucată %q, continuă: %v\n", bucata, prefix)
        if !prefix {
            fmt.Printf("=> rând complet: %q\n", complet)
            complet = complet[:0]
        }
    }
}