range-v3

range-v3是一个适用于C++14/17/20的范围库。这段代码是一项正式提案的基础，旨在为C++标准库添加范围支持。该提案经过技术规范的演变，最终形成了P0896R4"统一范围提案"，并于2018年11月被合并到C++20工作草案中。

关于:

范围是标准模板库的扩展，通过使迭代器和算法可组合，从而使它们更加强大。与其他试图摒弃迭代器的类范围解决方案不同，在range-v3中，范围是在迭代器之上的抽象层。

range-v3建立在三个支柱之上：视图、动作和算法。算法与您在STL中已经熟悉的那些相同，只不过在range-v3中，所有算法除了接受迭代器的重载外，还有接受范围的重载。视图是范围的可组合适配，其中适配在视图被迭代时惰性发生。而动作是对容器进行算法的急切应用，它会原地修改容器并返回它以供进一步处理。

视图和动作使用管道语法（例如，rng | adapt1 | adapt2 | ...），因此您的代码简洁且可从左到右阅读。

文档:

请查看（尚不完整的）文档这里。

其他资源（注意日期，库可能自那时起已发生变化）：

• 使用:

  • 演讲: CppCon 2015: Eric Niebler "标准库的范围", 2015.
  • C++中的Python切片, 2014年12月7日.
  • 动作（当时称为容器算法), 2014年11月23日.
  • 范围推导式, 2014年4月27日.
  • 输入迭代器vs输入范围, 2013年11月7日.

• 设计 / 实现:

  • range-v3背后的理念: N4128: 标准库范围修订1, 2014.
  • 范围TS: N4560: C++范围扩展, 2015.
  • range-v3中自定义点的实现:
    • N4381: 自定义点的建议设计, 2015.
    • P0386: 内联变量, 2016.
    • C++11及以后的自定义点设计, 2014.
  • range-v3中的代理迭代器:
    • D0022: 范围扩展的代理迭代器.
    • To Be or Not to Be (一个迭代器), 2015.
    • 迭代器++: 第1部分, 2015.
    • 迭代器++: 第2部分, 2015.
    • 迭代器++: 第3部分, 2015.
  • 元编程工具:
    • 参见meta文档，该库自2014年的博客文章以来已经发生了重大变化。
  • 概念模拟层: C++11中的概念检查, 2013.
  • C++Now 2014: Eric Niebler "C++11库设计", 2014.

许可证:

本项目中的大部分源代码都是我的，这些代码使用Boost软件许可证。部分内容取自Alex Stepanov的《编程原理》、Howard Hinnant的libc++以及SGI STL。请查看附带的LICENSE文件和CREDITS文件了解许可和致谢信息。

支持的编译器

已知该代码可在以下编译器上运行：

• clang 5.0（或更高版本）
• GCC 6.5（或更高版本）
• Windows上的Clang/LLVM 6（或更高版本）（较旧版本可能也可以工作 - 我们没有测试。）
• Windows上的Visual Studio 2019（或更高版本），由于range-v3的严格一致性要求，有一些注意事项：
  • range-v3需要/permissive-和/std:c++latest、/std:c++20或/std:c++17中的一个

开发状态： 这段代码相当稳定，经过充分测试，适合日常使用，尽管目前缺乏文档。总的来说，不对支持或长期稳定性做出承诺。这段代码将会不考虑向后兼容性而演进。

一个值得注意的例外是在ranges::cpp20命名空间中找到的任何内容。这些组件很少或（最好）永远不会发生变化。

构建状态

• 在GitHub Actions上:

构建range-v3 - 使用vcpkg

您可以使用vcpkg依赖管理器下载并安装range-v3：

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
./vcpkg install range-v3

vcpkg中的range-v3端口由Microsoft团队成员和社区贡献者保持更新。如果版本过时，请在vcpkg仓库上创建一个问题或拉取请求。

构建range-v3 - 使用Conan

您可以使用Conan依赖管理器下载并安装range-v3。

设置您的CMakeLists.txt（请参阅Conan文档了解如何使用MSBuild、Meson和其他工具）：

project(myproject CXX)

add_executable(${PROJECT_NAME} main.cpp)

include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake) # 包含Conan生成的文件
conan_basic_setup(TARGETS) # 引入Conan生成的目标

target_link_libraries(${PROJECT_NAME} CONAN_PKG::range-v3)

在您的源目录中创建conanfile.txt：

[requires]
range-v3/0.12.0

[generators]
cmake

安装并运行conan，然后像往常一样构建您的项目：

pip install conan
mkdir build
cd build
conan install ../ --build=missing
cmake ../
cmake --build .

构建range-v3 - 使用build2

您可以使用build2，一个依赖管理器和构建系统的结合，来使用range-v3（或对其进行开发）：

目前这个包可在以下包仓库中获得：

• https://cppget.org/range-v3/ 用于已发布和公开的版本。
• range-v3的build2包源代码的git仓库 用于未发布或自定义修订的range-v3，或用于使用build2进行开发。

用法：

• build2包名称：range-v3
• 库目标名称：lib{range-v3}
• 详细用例和说明请参阅此文档。

例如，要使您的build2项目依赖于range-v3：

• 将其中一个仓库添加到您的配置中，或者如果尚未添加，则添加到您的repositories.manifest中；例如：

  :
  role: prerequisite
  location: https://pkg.cppget.org/1/alpha # v0.11.0在这里。
  

• 将此包作为依赖项添加到您的manifest文件中（以v0.11.x为例）：

  depends: range-v3 ~0.11.0
  

• 在适当的buildfile中导入目标并将其用作使用range-v3的自己目标的先决条件：

  import range_v3 = range-v3%lib{range-v3}
  
  lib{mylib} : cxx{**} ... $range_v3

然后像往常一样构建您的项目（使用b或bdep update），build2将处理剩下的事情。

对于build2新手或获取更多详细信息和用例，您可以阅读这份文档和build2工具链介绍。

说声谢谢！

我做这项工作是因为我热爱它，也因为我热爱C++并希望它能达到我所知道的最卓越的水平。如果您喜欢我的工作并想表示感谢，您可以在我的博客上留下支持性评论。或者您可以在我的Open Hub range-v3贡献页面上给我一些kudos。只需点击这里的Give Kudos按钮即可。