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
```