repeat

Documentation

Overview

Package repeat implements the repeat-reader. A repeat-reader outputs a given constant byte sequence repeatedly.

This package was originally written for testing and profiling parsers. A typical use may look something like this:

input := "some line to be parsed\n"
r := NewReader([]byte(input), 1000)
parser := myparse.NewParser(r)

(start profiling)
// Parse 1000 lines until non-nil error.
for parser.ParseNext() == nil {}
(stop profiling)

Index

• type Reader
  • func NewReader(data []byte, n int) *Reader
  • func (r *Reader) Close() error
  • func (r *Reader) Read(p []byte) (int, error)

Types

type Reader

type Reader struct {
	// contains filtered or unexported fields
}

Reader outputs a given constant byte sequence repeatedly.

func NewReader

func NewReader(data []byte, n int) *Reader

NewReader returns a reader that outputs data n times. If n is negative, repeats infinitely. Copies the contents of data.

func (*Reader) Close

func (r *Reader) Close() error

Close is a no-op. Implements io.ReadCloser.

func (*Reader) Read

func (r *Reader) Read(p []byte) (int, error)

Read fills p with repetitions of the reader's data. Writes until p is full or until the last repetition was written. Subsequent calls to Read resume from where the last repetition stopped. When no more bytes are available, returns 0, EOF. Otherwise the error is nil.