From 9eccdd6a810ba1728f509a6a3905ced1aa96dee6 Mon Sep 17 00:00:00 2001 From: djsavvy Date: Sat, 29 Jan 2022 17:28:05 -0500 Subject: [PATCH] Clarify that Values() and Scan() require Next() to have been called on the rows object --- rows.go | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/rows.go b/rows.go index d57d5cbf..271c6e52 100644 --- a/rows.go +++ b/rows.go @@ -41,10 +41,13 @@ type Rows interface { // Scan reads the values from the current row into dest values positionally. // dest can include pointers to core types, values implementing the Scanner - // interface, and nil. nil will skip the value entirely. + // interface, and nil. nil will skip the value entirely. It is an error to + // call Scan without first calling Next() and checking that it returned true. Scan(dest ...interface{}) error - // Values returns the decoded row values. + // Values returns the decoded row values. As with Scan(), it is an error to + // call Values without first calling Next() and checking that it returned + // true. Values() ([]interface{}, error) // RawValues returns the unparsed bytes of the row values. The returned [][]byte is only valid until the next Next