strings

Documentation

Overview

A package of simple functions to manipulate strings.

Index

• func Count(s, sep string) int
• func Fields(s string) []string
• func HasPrefix(s, prefix string) bool
• func HasSuffix(s, suffix string) bool
• func Index(s, sep string) int
• func Join(a []string, sep string) string
• func LastIndex(s, sep string) int
• func Map(mapping func(rune int) int, s string) string
• func Repeat(s string, count int) string
• func Split(s, sep string, n int) []string
• func SplitAfter(s, sep string, n int) []string
• func ToLower(s string) string
• func ToTitle(s string) string
• func ToUpper(s string) string
• func TrimSpace(s string) string
• type Reader
  • func NewReader(s string) *Reader
  • func (r *Reader) Read(b []byte) (n int, err os.Error)
  • func (r *Reader) ReadByte() (b byte, err os.Error)

Functions

func Count

func Count(s, sep string) int

Count counts the number of non-overlapping instances of sep in s.

func Fields

func Fields(s string) []string

Fields splits the string s around each instance of one or more consecutive white space characters, returning an array of substrings of s or an empty list if s contains only white space.

func HasPrefix

func HasPrefix(s, prefix string) bool

HasPrefix tests whether the string s begins with prefix.

func HasSuffix

func HasSuffix(s, suffix string) bool

HasSuffix tests whether the string s ends with suffix.

func Index

func Index(s, sep string) int

Index returns the index of the first instance of sep in s, or -1 if sep is not present in s.

func Join

func Join(a []string, sep string) string

Join concatenates the elements of a to create a single string. The separator string sep is placed between elements in the resulting string.

func LastIndex

func LastIndex(s, sep string) int

LastIndex returns the index of the last instance of sep in s, or -1 if sep is not present in s.

func Map

func Map(mapping func(rune int) int, s string) string

Map returns a copy of the string 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 Repeat

func Repeat(s string, count int) string

Repeat returns a new string consisting of count copies of the string s.

func Split

func Split(s, sep string, n int) []string

Split splits the string s around each instance of sep, returning an array of substrings of s. If sep is empty, Split splits s after each UTF-8 sequence. If n > 0, Split splits s into at most n substrings; the last substring will be the unsplit remainder.

func SplitAfter

func SplitAfter(s, sep string, n int) []string

SplitAfter splits the string s after each instance of sep, returning an array of substrings of s. If sep is empty, SplitAfter splits s after each UTF-8 sequence. If n > 0, SplitAfter splits s into at most n substrings; the last substring will be the unsplit remainder.

func ToLower

func ToLower(s string) string

ToLower returns a copy of the string s with all Unicode letters mapped to their lower case.

func ToTitle

func ToTitle(s string) string

ToTitle returns a copy of the string s with all Unicode letters mapped to their title case.

func ToUpper

func ToUpper(s string) string

ToUpper returns a copy of the string s with all Unicode letters mapped to their upper case.

func TrimSpace

func TrimSpace(s string) string

Trim returns a slice of the string s, with all leading and trailing white space removed, as defined by Unicode.

Types

type Reader

type Reader string

A Reader satisfies calls to Read and ReadByte by reading from a string.

func NewReader

func NewReader(s string) *Reader

NewReader returns a new Reader reading from s. It is similar to bytes.NewBufferString but more efficient and read-only.

func (*Reader) Read

func (r *Reader) Read(b []byte) (n int, err os.Error)

func (*Reader) ReadByte

func (r *Reader) ReadByte() (b byte, err os.Error)