Opened 10 years ago

#7393 new Tasks

documentation suggests to store handle in node, why?

Reported by: Alex Hagen-Zanker <ahh34@…> 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.

Change History (0)

Note: See TracTickets for help on using tickets.