diff options
| author | Ian Lance Taylor <iant@golang.org> | 2016-11-15 17:14:13 -0800 |
|---|---|---|
| committer | Brad Fitzpatrick <bradfitz@golang.org> | 2016-11-16 16:04:18 +0000 |
| commit | b75b9e1d65989753d0ee14ccc6007729e49e2e51 (patch) | |
| tree | 033e2eebbeab718db7a478611a90daf71f794624 /src/database/sql/sql.go | |
| parent | 26069e1981ba8500baf35ff5aec79531e4882543 (diff) | |
| download | go-b75b9e1d65989753d0ee14ccc6007729e49e2e51.tar.xz | |
database/sql: clarify when statement in transaction is closed
Fixes #16346.
Change-Id: Ie75a4ae7011036dd2c1f121a7a5e38d10177721e
Reviewed-on: https://go-review.googlesource.com/33296
Reviewed-by: Daniel Theophanes <kardianos@gmail.com>
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
Diffstat (limited to 'src/database/sql/sql.go')
| -rw-r--r-- | src/database/sql/sql.go | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/src/database/sql/sql.go b/src/database/sql/sql.go index 43227e92ea..d3803e85c3 100644 --- a/src/database/sql/sql.go +++ b/src/database/sql/sql.go @@ -1436,8 +1436,8 @@ func (tx *Tx) Rollback() error { // Prepare creates a prepared statement for use within a transaction. // -// The returned statement operates within the transaction and can no longer -// be used once the transaction has been committed or rolled back. +// The returned statement operates within the transaction and will be closed +// when the transaction has been committed or rolled back. // // To use an existing prepared statement on this transaction, see Tx.Stmt. // @@ -1506,8 +1506,8 @@ func (tx *Tx) Prepare(query string) (*Stmt, error) { // ... // res, err := tx.StmtContext(ctx, updateMoney).Exec(123.45, 98293203) // -// The returned statement operates within the transaction and can no longer -// be used once the transaction has been committed or rolled back. +// The returned statement operates within the transaction and will be closed +// when the transaction has been committed or rolled back. func (tx *Tx) StmtContext(ctx context.Context, stmt *Stmt) *Stmt { // TODO(bradfitz): optimize this. Currently this re-prepares // each time. This is fine for now to illustrate the API but @@ -1551,8 +1551,8 @@ func (tx *Tx) StmtContext(ctx context.Context, stmt *Stmt) *Stmt { // ... // res, err := tx.Stmt(updateMoney).Exec(123.45, 98293203) // -// The returned statement operates within the transaction and can no longer -// be used once the transaction has been committed or rolled back. +// The returned statement operates within the transaction and will be closed +// when the transaction has been committed or rolled back. func (tx *Tx) Stmt(stmt *Stmt) *Stmt { return tx.StmtContext(context.Background(), stmt) } |