From e9ec8e7a2693b322287a96100750c6f00cf574ef Mon Sep 17 00:00:00 2001 From: Russ Cox Date: Thu, 18 Sep 2014 19:40:31 -0400 Subject: bytes, strings: document that FieldsFunc f must not be stateful Fixes #8738. LGTM=adg R=golang-codereviews, adg CC=golang-codereviews https://golang.org/cl/143260045 --- src/strings/strings.go | 2 ++ 1 file changed, 2 insertions(+) (limited to 'src/strings') diff --git a/src/strings/strings.go b/src/strings/strings.go index 761f32a068..1b9df2e757 100644 --- a/src/strings/strings.go +++ b/src/strings/strings.go @@ -347,6 +347,8 @@ func Fields(s string) []string { // FieldsFunc splits the string s at each run of Unicode code points c satisfying f(c) // and returns an array of slices of s. If all code points in s satisfy f(c) or the // string is empty, an empty slice is returned. +// FieldsFunc makes no guarantees about the order in which it calls f(c). +// If f does not return consistent results for a given c, FieldsFunc may crash. func FieldsFunc(s string, f func(rune) bool) []string { // First count the fields. n := 0 -- cgit v1.3