Ladivic is a C++ library designed to provide system-level thread- and fail-safe functions. It offers various functionalities related to asynchronous operations, atomic operations, input/output operations, inter-process communication (IPC), memory management, and system information retrieval. The library aims to simplify system-level programming tasks by providing robust and reliable functions that ensure thread safety and error handling. Hence, Ladivic stands as a versatile and indispensable asset for tackling complex system-level challenges with confidence and efficiency.
#include <ldvc_mem.hpp>
#include <ldvc_type.hpp>
#include <iostream>
using namespace std;
i32 main() {
i32* i32_array = ldvc_malloc<i32>(5);
for(usize i = 0; i < 5; ++i)
i32_array[i] = static_cast<i32>(i * 10);
cout << "Original Array: ";
for(usize i = 0; i < 5; ++i)
std::cout << i32_array[i] << " ";
cout << endl;
}Ladivic facilitates seamless execution of asynchronous tasks with its suite of functions designed to handle concurrency elegantly. Developers can leverage ldvc_async_execute to execute functions asynchronously, providing a future object for result retrieval. Additionally, tasks can be scheduled with specified delays or timeouts using ldvc_async_execute_with_delay and ldvc_async_execute_with_timeout, enabling precise control over task execution in multithreaded environments.
Thread safety is paramount in system-level programming, and Ladivic delivers robust atomic operations to ensure data integrity in concurrent scenarios. With functions for atomic increment, decrement, exchange, load, store, and bitwise operations (AND, OR, XOR), developers can manipulate variables atomically with ease, safeguarding against race conditions and data corruption.
Efficient handling of input/output operations is critical for system-level applications, and Ladivic streamlines this process with its input/output module. Developers can effortlessly read and write data to files using ldvc_io.hpp, with additional support for checking file existence and creating folders seamlessly, enhancing file management capabilities in system-level applications.
Facilitating communication between processes is essential for building robust system-level applications, and Ladivic simplifies this process with its IPC module. By providing functions for creating, attaching, detaching, and destroying shared memory segments, Ladivic empowers developers to implement efficient inter-process communication mechanisms, enabling seamless data exchange and synchronization between processes.
Effective memory management is fundamental for optimizing system-level applications, and Ladivic offers powerful memory management functionalities to address this need. Developers can safely allocate and deallocate memory using thread-safe functions in the ldvc_mem.hpp module, ensuring efficient utilization of system resources and minimizing memory-related issues.
Accessing essential system information is vital for system-level applications, and Ladivic simplifies this process with its system information retrieval module. Developers can retrieve critical system information such as CPU details, total memory, and disk space using functions in the ldvc_sysinfo.hpp module, enabling comprehensive system monitoring and analysis capabilities.
On GNU/Linux systems, you can simply change the working directory to ladivic, type the following to your terminal:
sudo chmod +x install.sh
sudo ./install.shThis will install the ladivic header files to the header path.
To incorporate Ladivic into your C++ project, follow these simple steps:
- Clone the Ladivic repository to your local machine:
git clone https://github.com/nthnn/ladivic.git- Include the necessary header files in your C++ code:
#include "ldvc_async.hpp"
#include "ldvc_atomic.hpp"
#include "ldvc_io.hpp"
#include "ldvc_ipc.hpp"
#include "ldvc_mem.hpp"
#include "ldvc_sysinfo.hpp"
#include "ldvc_type.hpp"- During compilation, ensure the Ladivic library is linked to your project.
Or, you can compile the examples by:
qrepo run buildJust make sure you have Qrepo and CMake installed on your system.
Contributions to Ladivic are highly encouraged and appreciated! To contribute new features, bug fixes, or enhancements, please adhere to the following guidelines:
- Fork the Ladivic repository.
- Create a new branch for your changes:
git checkout -b feature-name. - Implement your changes and commit them:
git commit -m "Added new feature". - Push your changes to the branch:
git push origin feature-name. - Submit a pull request for review and inclusion.
Ladivic is distributed under the GNU General Public License v3.0. For further details, refer to the LICENSE file.