| 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 |