OLD | NEW |
1 # Blink GC API reference | 1 # Blink GC API reference |
2 | 2 |
3 This is a through document for Oilpan API usage. | 3 This is a through document for Oilpan API usage. |
4 If you want to learn the API usage quickly, look at | 4 If you want to learn the API usage quickly, look at |
5 [this tutorial](https://docs.google.com/presentation/d/1XPu03ymz8W295mCftEC9KshH
9Icxfq81YwIJQzQrvxo/edit#slide=id.p). | 5 [this tutorial](https://docs.google.com/presentation/d/1XPu03ymz8W295mCftEC9KshH
9Icxfq81YwIJQzQrvxo/edit#slide=id.p). |
6 If you're just interested in wrapper tracing, | 6 If you're just interested in wrapper tracing, |
7 see [Wrapper Tracing Reference](../../bindings/core/v8/TraceWrapperReference.md)
. | 7 see [Wrapper Tracing Reference](../bindings/TraceWrapperReference.md). |
8 | 8 |
9 [TOC] | 9 [TOC] |
10 | 10 |
11 ## Header file | 11 ## Header file |
12 | 12 |
13 Unless otherwise noted, any of the primitives explained in this page requires th
e following `#include` statement: | 13 Unless otherwise noted, any of the primitives explained in this page requires th
e following `#include` statement: |
14 | 14 |
15 ```c++ | 15 ```c++ |
16 #include "platform/heap/Handle.h" | 16 #include "platform/heap/Handle.h" |
17 ``` | 17 ``` |
(...skipping 466 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
484 }; | 484 }; |
485 ``` | 485 ``` |
486 | 486 |
487 Please be very cautious if you want to use a heap collection from multiple threa
ds. Reference to heap collections may be passed to another thread using CrossThr
eadPersistents, but *you may not modify the collection from the non-owner thread
*. This is because modifications to collections may trigger backing store reallo
cations, and Oilpan's per thread heap requires that modifications to a heap happ
en on its owner thread. | 487 Please be very cautious if you want to use a heap collection from multiple threa
ds. Reference to heap collections may be passed to another thread using CrossThr
eadPersistents, but *you may not modify the collection from the non-owner thread
*. This is because modifications to collections may trigger backing store reallo
cations, and Oilpan's per thread heap requires that modifications to a heap happ
en on its owner thread. |
488 | 488 |
489 ### Weak collections | 489 ### Weak collections |
490 | 490 |
491 You can put `WeakMember<T>` in heap collections except for `HeapVector` and `Hea
pDeque` which we do not support. | 491 You can put `WeakMember<T>` in heap collections except for `HeapVector` and `Hea
pDeque` which we do not support. |
492 | 492 |
493 During an Oilpan GC, the weak members that refernce a collected object will be r
emoved from its heap collection, meaning the size of the collection will shrink
and you do not have to check for null weak members when iterating through the co
llection. | 493 During an Oilpan GC, the weak members that refernce a collected object will be r
emoved from its heap collection, meaning the size of the collection will shrink
and you do not have to check for null weak members when iterating through the co
llection. |
OLD | NEW |