vechonk/README.md
2021-12-20 15:24:42 +01:00

28 lines
No EOL
1.1 KiB
Markdown

A `Vec<T: ?Sized>`
It's implemented by laying out the elements in memory contiguously like `alloc::vec::Vec`
# Layout
A `Vechonk` is 3 `usize` long. It owns a single allocation, containing the elements and the metadata.
The elements are laid out contiguously from the front, while the metadata is laid out contiguously from the back.
Both grow towards the center until they meet and get realloced to separate them again.
```txt
Vechonk<str>
------------------------
| ptr | len | cap |
---|---------------------
|
|___
|
Heap v
------------------------------------------------------------------------
| "hello" | "uwu" | <uninit> | 0 - 5 | 5 - 3 |
|-----------|----------|-----------------|--------------|--------------|
| dynamic | dynamic | rest of alloc | usize + meta | usize + meta |
--------------------------------------------|--------------|------------
^ ^ | |
|___________ | _________________________| |
|_________________________________________|
```