range-v3是一个适用于C++14/17/20的范围库。这段代码是一项正式提案的基础,旨在为C++标准库添加范围支持。该提案经过技术规范的演变,最终形成了P0896R4"统一范围提案",并于2018年11月被合并到C++20工作草案中。
范围是标准模板库的扩展,通过使迭代器和算法可组合,从而使它们更加强大。与其他试图摒弃迭代器的类范围解决方案不同,在range-v3中,范围是在迭代器之上的抽象层。
range-v3建立在三个支柱之上:视图、动作和算法。算法与您在STL中已经熟悉的那些相同,只不过在range-v3中,所有算法除了接受迭代器的重载外,还有接受范围的重载。视图是范围的可组合适配,其中适配在视图被迭代时惰性发生。而动作是对容器进行算法的急切应用,它会原地修改容器并返回它以供进一步处理。
视图和动作使用管道语法(例如,rng | adapt1 | adapt2 | ...
),因此您的代码简洁且可从左到右阅读。
请查看(尚不完整的)文档这里。
其他资源(注意日期,库可能自那时起已发生变化):
使用:
设计 / 实现:
本项目中的大部分源代码都是我的,这些代码使用Boost软件许可证。部分内容取自Alex Stepanov的《编程原理》、Howard Hinnant的libc++以及SGI STL。请查看附带的LICENSE文件和CREDITS文件了解许可和致谢信息。
已知该代码可在以下编译器上运行:
/permissive-
和/std:c++latest
、/std:c++20
或/std:c++17
中的一个开发状态: 这段代码相当稳定,经过充分测试,适合日常使用,尽管目前缺乏文档。总的来说,不对支持或长期稳定性做出承诺。这段代码将会不考虑向后兼容性而演进。
一个值得注意的例外是在ranges::cpp20
命名空间中找到的任何内容。这些组件很少或(最好)永远不会发生变化。
构建状态
您可以使用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仓库上创建一个问题或拉取请求。
您可以使用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 .
build2
您可以使用build2
,一个依赖管理器和构建系统的结合,来使用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按钮即可。