Be much more agressive in AccessCoin docs.
While the current implementation is pretty free, there is a lot of possibility for this to blow up in our face with future changes, especially as the backing map gets tweaked.
This commit is contained in:
parent
f58349ca85
commit
9417d7a336
1 changed files with 7 additions and 2 deletions
|
@ -222,8 +222,13 @@ public:
|
|||
|
||||
/**
|
||||
* Return a reference to Coin in the cache, or a pruned one if not found. This is
|
||||
* more efficient than GetCoin. Modifications to other cache entries are
|
||||
* allowed while accessing the returned pointer.
|
||||
* more efficient than GetCoin.
|
||||
*
|
||||
* Generally, do not hold the reference returned for more than a short scope.
|
||||
* While the current implementation allows for modifications to the contents
|
||||
* of the cache while holding the reference, this behavior should not be relied
|
||||
* on! To be safe, best to not hold the returned reference through any other
|
||||
* calls to this cache.
|
||||
*/
|
||||
const Coin& AccessCoin(const COutPoint &output) const;
|
||||
|
||||
|
|
Loading…
Reference in a new issue