https://github.com/w1redch4d/pcclist
PCCList is a dynamic, Python-style list implementation in C++ capable of storing heterogeneous types
https://github.com/w1redch4d/pcclist
cpp17 data-structures dynamic-array python-list
Last synced: 11 months ago
JSON representation
PCCList is a dynamic, Python-style list implementation in C++ capable of storing heterogeneous types
- Host: GitHub
- URL: https://github.com/w1redch4d/pcclist
- Owner: w1redch4d
- Created: 2025-05-06T07:21:07.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-05-06T07:23:11.000Z (11 months ago)
- Last Synced: 2025-05-06T08:35:22.839Z (11 months ago)
- Topics: cpp17, data-structures, dynamic-array, python-list
- Language: C++
- Homepage:
- Size: 12.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PCCList
PCCList is a dynamic, Python-style list implementation in C++ capable of storing multiple types using `std::any`, including support for C-style strings, `std::string`, and various fundamental types. It also supports intuitive indexing, mutation, iteration, and formatted output.
## What it supports?
The list supports:
- [x] Indexed access: `L[0]`
- [x] Mutation: `L[1] = 99`
- [x] Iteration: `for (auto v : L)`
- [x] Type-safe retrieval via `.get(index)` and `.try_get(index)`
## How to use it?
Examples are in the `example` directory feel free to read around
## Compilation
For building (Modify the CMakeLists to point to your main.cc for custom usage):
```bash
cmake -B build -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
cmake --build build
```
To run tests:
```bash
./build/tests/test_pcclist
```
## How it works?
PCCList internally stores elements in a `std::vector`, allowing heterogeneous types. It supports construction from any mix of copyable/movable types, including C-style strings, which are converted to `std::string` internally. Access through `operator[]` returns a proxy ValueRef, which supports implicit casting, assignment, and printing via operator<<. Type safety is ensured through `.get()` or `.try_get()` APIs, which safely cast the value at a given index.
## TODOS for future
- [] Support for nested lists (e.g., lists of lists)
- [] JSON-style output or serialization
- [] Optional typed mode with compile-time enforcement
- [] Lots of Optimizations
- [] Fuzz Testing using LibFuzzer
## Contributing
Feel free to contribute if you wanna add any interesting features or help speeding up the TODOs, if you implement something make sure to add the respective gtest for the feature on `tests/test_pcclist.cc`