https://github.com/giovanni-iannaccone/mix
C++ class storing data of unknown different types 🌀
https://github.com/giovanni-iannaccone/mix
c-plus-plus data-structures data-type library mix
Last synced: 10 months ago
JSON representation
C++ class storing data of unknown different types 🌀
- Host: GitHub
- URL: https://github.com/giovanni-iannaccone/mix
- Owner: giovanni-iannaccone
- License: gpl-3.0
- Created: 2025-04-28T16:17:57.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-04-29T16:49:16.000Z (10 months ago)
- Last Synced: 2025-04-30T14:28:39.696Z (10 months ago)
- Topics: c-plus-plus, data-structures, data-type, library, mix
- Language: C++
- Homepage:
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌀 Class `mix`
Unlike standard C++ containers like std::vector, which require specifying the type of the stored elements at the time of declaration, the mix class provides a groundbreaking approach. It allows storing objects of unknown or heterogeneous types within a single container, determined dynamically during runtime. This flexibility eliminates the constraints of type homogeneity and opens up new possibilities for dynamic applications, making it highly adaptable for scenarios where types cannot be predetermined.
With mix, developers can insert elements of any type into the same container without wrapping them into a polymorphic base or using complex type-erasing mechanisms like std::variant or std::any. The class leverages pointers and dynamic type casting to achieve this, while maintaining ease of use and high performance. 🌟
## 🧪 Class Overview
The class uses a vector of pointers (`std::vector`) as its base structure, allowing for the storage of heterogeneous data without type constraints.
## 🚀 Key Features
- **Operators**:
- `[]`: Accesses the pointer to an element (equivalent to `&container.at()`)
- `+=`: Adds elements from another mix container to the current one
- `==`: Compares two `mix` objects
- `!=`: Checks inequality between two `mix` objects
- `+`: Returns a new `mix` object combining two instances
- **Element Access**:
- `at(int index)`: Retrieves the element at the given index, cast to the specified type
- **Insertion and Removal**:
- `erase(int index)`: Erases the element at the given position
- `find(T const element)`: Finds the index of a specific element
- `insert(T element, int index = -1)`: Inserts an element of a generic type at the specified position
- `pop_back()`: Removes the last element in the container
- `push_back(T element)`: Appends an element to the container
- `remove(T const element)`: Removes a specific element
- **Container Management**:
- `size()`: Returns the total number of elements
- `back() `: Returns a reference to the vector's last element
- `capacity()`: Provides the internal vector's capacity
- `clear()`: Removes all elements from the container
- Iterators: `begin()` and `end()` for seamless iteration
## 💡 How to Use `mix`
### Install using CMake
```cmake
cmake_minimum_required(VERSION 3.14)
PROJECT(myproject)
# fetch latest mix
include(FetchContent)
FetchContent_Declare(
mix
GIT_REPOSITORY https://github.com/giovanni-iannaccone/mix.git
)
FetchContent_MakeAvailable(mix)
add_executable(myproject main.cpp)
target_link_libraries(myproject mix)
```
### Include `mix` in your project
```cpp
#include
```
### Usage Example
```cpp
#include
#include
#include
int main() {
mix container;
// Insert elements of different types
container.insert(42); // Integer
container.insert("Hello World"); // String
// Retrieve elements
int intValue = container.at(0);
std::string strValue = container.at(1);
std::cout << "Integer: " << intValue << "\\n";
std::cout << "String: " << strValue << "\\n";
return 0;
}
```
# 🧩 Contributing
We welcome contributions! Please follow these steps:
1. Fork the repository.
2. Create a new branch ( using this convention).
3. Make your changes and commit them with descriptive messages.
4. Push your changes to your fork.
5. Create a pull request to the main repository.
### 🍃 Contributors
## ⚖ License
This project is licensed under the GPL-3.0 License. See the LICENSE file for details.
## ⚔ Contact
- For any inquiries or support, please contact iannacconegiovanni444@gmail.com .
- Visit my site for more informations about me and my work https://giovanni-iannaccone.github.io