Documentation
¶
Overview ¶
The bytes package implements functions for the manipulation of byte slices. Analagous to the facilities of the strings package.
Index ¶
- Constants
- func Add(s, t []byte) []byte
- func AddByte(s []byte, t byte) []byte
- func Compare(a, b []byte) int
- func Count(s, sep []byte) int
- func Equal(a, b []byte) bool
- func Fields(s []byte) [][]byte
- func HasPrefix(s, prefix []byte) bool
- func HasSuffix(s, suffix []byte) bool
- func Index(s, sep []byte) int
- func IndexByte(s []byte, c byte) int
- func Join(a [][]byte, sep []byte) []byte
- func LastIndex(s, sep []byte) int
- func Map(mapping func(rune int) int, s []byte) []byte
- func Repeat(b []byte, count int) []byte
- func Runes(s []byte) []int
- func Split(s, sep []byte, n int) [][]byte
- func SplitAfter(s, sep []byte, n int) [][]byte
- func ToLower(s []byte) []byte
- func ToTitle(s []byte) []byte
- func ToUpper(s []byte) []byte
- func TrimSpace(s []byte) []byte
- type Buffer
- func (b *Buffer) Bytes() []byte
- func (b *Buffer) Len() int
- func (b *Buffer) Read(p []byte) (n int, err os.Error)
- func (b *Buffer) ReadByte() (c byte, err os.Error)
- func (b *Buffer) ReadFrom(r io.Reader) (n int64, err os.Error)
- func (b *Buffer) ReadRune() (r int, size int, err os.Error)
- func (b *Buffer) Reset()
- func (b *Buffer) String() string
- func (b *Buffer) Truncate(n int)
- func (b *Buffer) Write(p []byte) (n int, err os.Error)
- func (b *Buffer) WriteByte(c byte) os.Error
- func (b *Buffer) WriteRune(r int) (n int, err os.Error)
- func (b *Buffer) WriteString(s string) (n int, err os.Error)
- func (b *Buffer) WriteTo(w io.Writer) (n int64, err os.Error)
Constants ¶
const MinRead = 512
MinRead is the minimum slice size passed to a Read call by Buffer.ReadFrom. As long as the Buffer has at least MinRead bytes beyond what is required to hold the contents of r, ReadFrom will not grow the underlying buffer.
Variables ¶
This section is empty.
Functions ¶
func Add ¶
Add appends the contents of t to the end of s and returns the result. If s has enough capacity, it is extended in place; otherwise a new array is allocated and returned.
func AddByte ¶
AddByte appends byte b to the end of s and returns the result. If s has enough capacity, it is extended in place; otherwise a new array is allocated and returned.
func Compare ¶
Compare returns an integer comparing the two byte arrays lexicographically. The result will be 0 if a==b, -1 if a < b, and +1 if a > b
func Fields ¶
Fields splits the array s around each instance of one or more consecutive white space characters, returning a slice of subarrays of s or an empty list if s contains only white space.
func Index ¶
Index returns the index of the first instance of sep in s, or -1 if sep is not present in s.
func IndexByte ¶
IndexByte returns the index of the first instance of c in s, or -1 if c is not present in s.
func Join ¶
Join concatenates the elements of a to create a single byte array. The separator sep is placed between elements in the resulting array.
func LastIndex ¶
LastIndex returns the index of the last instance of sep in s, or -1 if sep is not present in s.
func Map ¶
Map returns a copy of the byte array s with all its characters modified according to the mapping function. If mapping returns a negative value, the character is dropped from the string with no replacement.
func Split ¶
Split splits the array s around each instance of sep, returning an array of subarrays of s. If sep is empty, Split splits s after each UTF-8 sequence. If n > 0, Split splits s into at most n subarrays; the last subarray will contain an unsplit remainder.
func SplitAfter ¶
SplitAfter splits the array s after each instance of sep, returning an array of subarrays of s. If sep is empty, SplitAfter splits s after each UTF-8 sequence. If n > 0, SplitAfter splits s into at most n subarrays; the last subarray will contain an unsplit remainder.
func ToLower ¶
ToUpper returns a copy of the byte array s with all Unicode letters mapped to their lower case.
func ToTitle ¶
ToTitle returns a copy of the byte array s with all Unicode letters mapped to their title case.
Types ¶
type Buffer ¶
type Buffer struct {
// contains filtered or unexported fields
}
A Buffer is a variable-sized buffer of bytes with Read and Write methods. The zero value for Buffer is an empty buffer ready to use.
func NewBuffer ¶
NewBuffer creates and initializes a new Buffer using buf as its initial contents. It is intended to prepare a Buffer to read existing data. It can also be used to to size the internal buffer for writing. To do that, buf should have the desired capacity but a length of zero.
func NewBufferString ¶
NewBufferString creates and initializes a new Buffer using string s as its initial contents. It is intended to prepare a buffer to read an existing string.
func (*Buffer) Bytes ¶
Bytes returns a slice of the contents of the unread portion of the buffer; len(b.Bytes()) == b.Len(). If the caller changes the contents of the returned slice, the contents of the buffer will change provided there are no intervening method calls on the Buffer.
func (*Buffer) Len ¶
Len returns the number of bytes of the unread portion of the buffer; b.Len() == len(b.Bytes()).
func (*Buffer) Read ¶
Read reads the next len(p) bytes from the buffer or until the buffer is drained. The return value n is the number of bytes read. If the buffer has no data to return, err is os.EOF even if len(p) is zero; otherwise it is nil.
func (*Buffer) ReadByte ¶
ReadByte reads and returns the next byte from the buffer. If no byte is available, it returns error os.EOF.
func (*Buffer) ReadFrom ¶
ReadFrom reads data from r until EOF and appends it to the buffer. The return value n is the number of bytes read. Any error except os.EOF encountered during the read is also returned.
func (*Buffer) ReadRune ¶
ReadRune reads and returns the next UTF-8-encoded Unicode code point from the buffer. If no bytes are available, the error returned is os.EOF. If the bytes are an erroneous UTF-8 encoding, it consumes one byte and returns U+FFFD, 1.
func (*Buffer) Reset ¶
func (b *Buffer) Reset()
Reset resets the buffer so it has no content. b.Reset() is the same as b.Truncate(0).
func (*Buffer) String ¶
String returns the contents of the unread portion of the buffer as a string. If the Buffer is a nil pointer, it returns "<nil>".
func (*Buffer) Truncate ¶
Truncate discards all but the first n unread bytes from the buffer. It is an error to call b.Truncate(n) with n > b.Len().
func (*Buffer) Write ¶
Write appends the contents of p to the buffer. The return value n is the length of p; err is always nil.
func (*Buffer) WriteByte ¶
WriteByte appends the byte c to the buffer. The returned error is always nil, but is included to match bufio.Writer's WriteByte.
func (*Buffer) WriteRune ¶
WriteRune appends the UTF-8 encoding of Unicode code point r to the buffer, returning its length and an error, which is always nil but is included to match bufio.Writer's WriteRune.
func (*Buffer) WriteString ¶
WriteString appends the contents of s to the buffer. The return value n is the length of s; err is always nil.
Source Files