exercism/go/paasio/interface.go

41 lines
1.5 KiB
Go
Raw Normal View History

2016-09-12 22:41:46 +00:00
package paasio
import "io"
// ReadCounter is an interface describing objects that can be read from,
// and that can count the number of times they have been read from.
//
// If multiple goroutines concurrently call Read, implementations are not
// required to provide any guarantees about interleaving of the Read calls.
// However, implementations MUST guarantee that calls to ReadCount always return
// correct results even in the presence of concurrent Read calls.
type ReadCounter interface {
io.Reader
// ReadCount returns the total number of bytes successfully read along
// with the total number of calls to Read().
ReadCount() (n int64, nops int)
}
// WriteCounter is an interface describing objects that can be written to,
// and that can count the number of times they have been written to.
//
// If multiple goroutines concurrently call Write, implementations are not
// required to provide any guarantees about interleaving of the Write calls.
// However, implementations MUST guarantee that calls to WriteCount always return
// correct results even in the presence of concurrent Write calls.
type WriteCounter interface {
io.Writer
// WriteCount returns the total number of bytes successfully written along
// with the total number of calls to Write().
WriteCount() (n int64, nops int)
}
// ReadWriteCounter is the union of ReadCounter and WriteCounter.
//
// All guarantees that apply to either of ReadCounter or WriteCounter
// also apply to ReadWriteCounter.
type ReadWriteCounter interface {
ReadCounter
WriteCounter
}