From: Russ Cox <rsc@golang.org>
Date: Tue, 18 Oct 2016 15:00:00 +0000 (-0400)
Subject: reflect: correct Type.FieldByNameFunc docs
X-Git-Tag: go1.8beta1~779
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=e05d0140483e78c36cd03b3f6173e9f23e975645;p=gostls13.git

reflect: correct Type.FieldByNameFunc docs

Fixes #16573.

Change-Id: I5a26eaa8b258cb1861190f9690086725532b8a0d
Reviewed-on: https://go-review.googlesource.com/31354
Reviewed-by: Ian Lance Taylor <iant@golang.org>
---

diff --git a/src/reflect/type.go b/src/reflect/type.go
index 49da4ef34b..a9793978f7 100644
--- a/src/reflect/type.go
+++ b/src/reflect/type.go
@@ -156,9 +156,14 @@ type Type interface {
 	// and a boolean indicating if the field was found.
 	FieldByName(name string) (StructField, bool)
 
-	// FieldByNameFunc returns the first struct field with a name
+	// FieldByNameFunc returns the struct field with a name
 	// that satisfies the match function and a boolean indicating if
 	// the field was found.
+	//
+	// If multiple fields match the func, they cancel each other
+	// and FieldByNameFunc returns no match.
+	// This behavior mirrors Go's handling of name lookup in
+	// structs containing anonymous fields.
 	FieldByNameFunc(match func(string) bool) (StructField, bool)
 
 	// In returns the type of a function type's i'th input parameter.