rrgen使用教程

rrgen使用教程

rrgen A Header Only C++ Library for Storing Safe, Randomly Generated Data Into Modern Containers 项目地址: https://gitcode.com/gh_mirrors/rr/rrgen

1. 项目介绍

rrgen 是一个头文件仅为的 C++ 库，旨在为现代 C++ 容器提供安全存储伪随机数据的方法。该库对抗使用不安全的方法存储随机数据到容器中，例如老旧且笨重的伪随机数生成器（PRNGs）。rrgen 使用标准模板库（STL）的分布引擎，以高效和安全的方式将随机数分布存储到指定的 C++ 容器中。

2. 项目快速启动

首先，您需要克隆项目仓库到本地：

git clone https://github.com/josh0xA/rrgen.git
cd rrgen
make

然后，将 include/rrgen.hpp 添加到您的项目树中以访问库的类和函数。

以下是一个快速启动示例，展示如何使用 rrgen 库：

#include "../include/rrgen.hpp"
#include <iostream>

int main() {
    // 使用 rrgen 向量
    rrgen::rrand<float, std::vector, 10> rrvec;
    rrvec.gen_rrvector(false, true, 0, 10);
    for (auto& i : rrvec.contents()) {
        std::cout << i << " ";
    }
    std::cout << std::endl;

    // 使用 rrgen 列表（前侧插入）
    rrgen::rrand<int, std::list, 10> rrlist;
    rrlist.gen_rrlist(false, true, "fside", 5, 25);
    rrlist.show_contents();
    std::cout << "Size: " << rrlist.contents().size() << std::endl;

    // 使用 rrgen 数组
    rrgen::rrand_array<int, 5> rrarr;
    rrarr.gen_rrarray(false, true, 5, 35);
    for (auto& i : rrarr.contents()) {
        std::cout << i << " ";
    }
    std::cout << std::endl;

    // 使用 rrgen 栈
    rrgen::rrand_stack<float, 10> rrstack;
    rrstack.gen_rrstack(false, true, 200, 1000);
    for (int m = rrstack.xsize(); m > 0; m--) {
        std::cout << rrstack.grab_top() << " ";
        rrstack.pop_off();
        if (m == 1) {
            std::cout << std::endl;
        }
    }

    return 0;
}

编译并运行上述代码，您将看到容器中填充了伪随机数。

3. 应用案例和最佳实践

• 向量填充：使用 rrgen::rrand 模板类为 std::vector 容器生成随机数填充。
• 列表操作：对于 std::list 容器，可以指定在前侧或后侧插入随机数。
• 数组初始化：使用 rrgen::rrand_array 为固定大小的数组生成随机数。
• 栈操作：通过 rrgen::rrand_stack 生成一个随机数栈，并支持弹出操作。

4. 典型生态项目

目前，rrgen 项目作为一个独立的库，没有列出明确的生态项目。但是，它可以在需要随机数生成和存储的任何 C++ 项目中作为依赖库使用。例如，在游戏开发、模拟器和科学计算项目中，rrgen 提供的安全随机数存储机制将是非常有用的。

rrgen A Header Only C++ Library for Storing Safe, Randomly Generated Data Into Modern Containers 项目地址: https://gitcode.com/gh_mirrors/rr/rrgen