1 // Copyright 2012 The Go Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style
3 // license that can be found in the LICENSE file.
13 // A Reader implements the io.Reader, io.ReaderAt, io.WriterTo, io.Seeker,
14 // io.ByteScanner, and io.RuneScanner interfaces by reading from
16 // Unlike a Buffer, a Reader is read-only and supports seeking.
19 i
int64 // current reading index
20 prevRune
int // index of previous rune; or < 0
23 // Len returns the number of bytes of the unread portion of the
25 func (r
*Reader
) Len() int {
26 if r
.i
>= int64(len(r
.s
)) {
29 return int(int64(len(r
.s
)) - r
.i
)
32 // Size returns the original length of the underlying byte slice.
33 // Size is the number of bytes available for reading via ReadAt.
34 // The returned value is always the same and is not affected by calls
35 // to any other method.
36 func (r
*Reader
) Size() int64 { return int64(len(r
.s
)) }
38 // Read implements the io.Reader interface.
39 func (r
*Reader
) Read(b
[]byte) (n
int, err error
) {
40 if r
.i
>= int64(len(r
.s
)) {
44 n
= copy(b
, r
.s
[r
.i
:])
49 // ReadAt implements the io.ReaderAt interface.
50 func (r
*Reader
) ReadAt(b
[]byte, off
int64) (n
int, err error
) {
51 // cannot modify state - see io.ReaderAt
53 return 0, errors
.New("bytes.Reader.ReadAt: negative offset")
55 if off
>= int64(len(r
.s
)) {
58 n
= copy(b
, r
.s
[off
:])
65 // ReadByte implements the io.ByteReader interface.
66 func (r
*Reader
) ReadByte() (byte, error
) {
68 if r
.i
>= int64(len(r
.s
)) {
76 // UnreadByte complements ReadByte in implementing the io.ByteScanner interface.
77 func (r
*Reader
) UnreadByte() error
{
80 return errors
.New("bytes.Reader.UnreadByte: at beginning of slice")
86 // ReadRune implements the io.RuneReader interface.
87 func (r
*Reader
) ReadRune() (ch rune
, size
int, err error
) {
88 if r
.i
>= int64(len(r
.s
)) {
93 if c
:= r
.s
[r
.i
]; c
< utf8
.RuneSelf
{
95 return rune(c
), 1, nil
97 ch
, size
= utf8
.DecodeRune(r
.s
[r
.i
:])
102 // UnreadRune complements ReadRune in implementing the io.RuneScanner interface.
103 func (r
*Reader
) UnreadRune() error
{
105 return errors
.New("bytes.Reader.UnreadRune: previous operation was not ReadRune")
107 r
.i
= int64(r
.prevRune
)
112 // Seek implements the io.Seeker interface.
113 func (r
*Reader
) Seek(offset
int64, whence
int) (int64, error
) {
122 abs
= int64(len(r
.s
)) + offset
124 return 0, errors
.New("bytes.Reader.Seek: invalid whence")
127 return 0, errors
.New("bytes.Reader.Seek: negative position")
133 // WriteTo implements the io.WriterTo interface.
134 func (r
*Reader
) WriteTo(w io
.Writer
) (n
int64, err error
) {
136 if r
.i
>= int64(len(r
.s
)) {
142 panic("bytes.Reader.WriteTo: invalid Write count")
146 if m
!= len(b
) && err
== nil {
147 err
= io
.ErrShortWrite
152 // Reset resets the Reader to be reading from b.
153 func (r
*Reader
) Reset(b
[]byte) { *r
= Reader
{b
, 0, -1} }
155 // NewReader returns a new Reader reading from b.
156 func NewReader(b
[]byte) *Reader
{ return &Reader
{b
, 0, -1} }