Opened 10 years ago
#7393 new Tasks
documentation suggests to store handle in node, why?
Reported by: | Owned by: | timblechmann | |
---|---|---|---|
Milestone: | To Be Determined | Component: | heap |
Version: | Boost 1.52.0 | Severity: | Not Applicable |
Keywords: | documentation, mutability | Cc: |
Description
The documentation of the mutability concept includes a section that describes how to store handles into values in the heap.
"Note that handles can be stored inside the value_type (nodes): "
http://www.boost.org/doc/libs/1_51_0/doc/html/heap/concepts.html#heap.concepts.mutability
I don't understand the point of this note. Handles are used to access nodes. If you store your handles inside nodes and not somewhere else, how can you possibly access nodes. If you do store your handles somewhere else, why would you also store them in the nodes?
I got confused trying to make use of this tip in my own code. Perhaps it is possible to add some motivation for this note, or just remove it.