From fd4b3541cb950eb642ea6439debadfb479afd532 Mon Sep 17 00:00:00 2001 From: Angel Davila Date: Sat, 8 Mar 2025 15:44:14 -0600 Subject: [PATCH] Small addition to GetMulti docs --- datastore/datastore.go | 4 ++++ v2/datastore/datastore.go | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/datastore/datastore.go b/datastore/datastore.go index 790fca77..603807e4 100644 --- a/datastore/datastore.go +++ b/datastore/datastore.go @@ -252,6 +252,10 @@ func Get(c context.Context, key *Key, dst interface{}) error { // As a special case, PropertyList is an invalid type for dst, even though a // PropertyList is a slice of structs. It is treated as invalid to avoid being // mistakenly passed when []PropertyList was intended. +// +// If any entity cannot be retrieved, GetMulti returns a MultiError. However, +// successfully retrieved entities are still loaded into the corresponding dst elements, +// even if a MultiError is returned. func GetMulti(c context.Context, key []*Key, dst interface{}) error { v := reflect.ValueOf(dst) multiArgType, _ := checkMultiArg(v) diff --git a/v2/datastore/datastore.go b/v2/datastore/datastore.go index 47c95f12..17123d4a 100644 --- a/v2/datastore/datastore.go +++ b/v2/datastore/datastore.go @@ -252,6 +252,10 @@ func Get(c context.Context, key *Key, dst interface{}) error { // As a special case, PropertyList is an invalid type for dst, even though a // PropertyList is a slice of structs. It is treated as invalid to avoid being // mistakenly passed when []PropertyList was intended. +// +// If any entity cannot be retrieved, GetMulti returns a MultiError. However, +// successfully retrieved entities are still loaded into the corresponding dst elements, +// even if a MultiError is returned. func GetMulti(c context.Context, key []*Key, dst interface{}) error { v := reflect.ValueOf(dst) multiArgType, _ := checkMultiArg(v)