0
1
mirror of https://github.com/golang/go synced 2024-11-24 14:36:17 +00:00
go/doc/next/6-stdlib/99-minor/runtime/67535.md
Carlos Amedee 0531768b30 runtime: implement AddCleanup
This change introduces AddCleanup to the runtime package. AddCleanup attaches
a cleanup function to an pointer to an object.

The Stop method on Cleanups will be implemented in a followup CL.

AddCleanup is intended to be an incremental improvement over
SetFinalizer and will result in SetFinalizer being deprecated.

For #67535

Change-Id: I99645152e3fdcee85fcf42a4f312c6917e8aecb1
Reviewed-on: https://go-review.googlesource.com/c/go/+/627695
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Michael Knyszek <mknyszek@google.com>
2024-11-16 03:26:04 +00:00

7 lines
417 B
Markdown

The [AddCleanup] function attaches a function to a pointer. Once the object that
the pointer points to is no longer reachable, the runtime will call the function.
[AddCleanup] is a finalization mechanism similar to [SetFinalizer]. Unlike
[SetFinalizer], it does not resurrect objects while running the cleanup. Multiple
cleanups can be attached to a single object. [AddCleanup] is an improvement over
[SetFinalizer].