版本 1.72.0

2019年12月11日 18:06 GMT

文档

已知问题

这些是库作者提交的补丁，由于发现过晚而未能在此版本中修复。请注意，它们未经过正常的测试流程。

• 撤销对 range 依赖
  • 协程补丁

更新的库

• Asio:
  • 更改了 async_initiate 辅助函数，使其自动推导其返回类型，适用于 C++11 或更高版本。
  • 更改了所有异步操作，使其自动推导返回类型，适用于 C++14 或更高版本。
  • 引入了 concepts 来支持 async_initiate。
  • 向所有 I/O 对象类型添加了嵌套模板类型 rebind_executor。
  • 更改了 initiation 函数对象，使其通过嵌套类型 executor_type 和成员函数 get_executor() 来报告其关联的 I/O executor。
  • 添加了 default_completion_token trait，为 I/O executor 类型提供关联的默认 completion token 类型，用于异步操作。例如，此 trait 为 use_awaitable completion token 特化，以便异步操作可以如下使用：co_await socket.async_connect(my_endpoint)。
  • 添加了 Windows 特定的 I/O 对象异步操作中缺失的 async_initiate。
  • 确保 executor 类型被传播到新接受的 socket。
  • 更改为要求 Protocol 的复制和移动操作永远不会抛出异常。
  • 更改为要求 Endpoint 的默认构造函数和移动操作永远不会抛出异常。
  • 为协议访问器添加了 noexcept 限定符。
  • 为 socket 的移动构造函数添加了 noexcept 限定符。
  • 修复了在 Windows 上打开串口时遇到的问题
    • 使用正确的常量初始化 RTS 控制标志。
    • 指定了默认波特率（9600）。
  • 修复了在异步 accept 操作自动重启时可能发生的“待处理工作计数”丢失问题。
  • 请参阅修订历史记录以获取更多详细信息。
• Atomic:
  • 为 __float128 未被某些版本的 libstdc++ 视为浮点类型的问题添加了变通方法。
  • 提高了与 clang-win 编译器的兼容性。
• Beast:
  • 这是一个包含 bug 修复的维护更新，并更新以使用 Boost.Asio 中提供的新功能。
  • 我们很想了解您或您的公司如何使用 Beast，请考虑在使用 Beast 的公司和个人列表中添加一条记录。
  • 请参阅完整的 发布说明 以获取完整的更改列表。
• Circular Buffer:
  • 修复了 #29 问题：max_size() 现在考虑了分配器的 max_size()。（Glen Fernandes）
• Context:
  • 支持 s390x 架构
  • 移除了 execution_context
• Endian:
  • 在 GCC 和 Clang 上，将 endian_reverse、conditional_reverse 和 *_to_* 设置为 constexpr
  • 添加了便捷的加载和存储函数
  • 添加了浮点便捷 typedefs
  • 添加了非 const 重载的 data()；将其返回类型更改为 unsigned char*
  • 在可用时，为 endian_reverse 添加了 __int128 支持
  • 添加了便捷头文件 boost/endian.hpp
• Filesystem:
  • 将 filesystem_error 提取到 exception.hpp；将 file_status 及相关枚举和函数提取到 file_status.hpp；将 directory_entry、directory_iterator 和 recursive_directory_iterator 提取到 directory.hpp。
  • 已弃用：为向后兼容，operations.hpp 仍然包含新的头文件 exception.hpp、file_status.hpp 和 directory.hpp，除非定义了 BOOST_FILESYSTEM_NO_DEPRECATED 宏。这些隐式包含被视为已弃用，将在未来版本中移除。鼓励用户直接包含新的头文件或包含 filesystem.hpp。
  • filesystem_error 异常现在已在 Boost.Filesystem 的编译库中实现。用户可能需要在其项目中链接 Boost.Filesystem 库。
  • 在 POSIX.1-2008 平台上，使用 utimensat 替代 utime。utime 在 POSIX.1-2008 中被声明为过时，并且可能被禁用（例如在 uClibc-ng 中）。（PR#115）
  • 在内存分配错误时，directory_iterator 现在会保持在结束状态。
  • 在 POSIX 系统上的 directory_iterator 中，已重构 readdir/readdir_r 的支持，以避免在使用 readdir 时为 dirent 结构分配内存。这减少了内存消耗，并消除了 readdir 产生非常长的目录名时可能发生的缓冲区溢出。
  • 在 Windows 上，使用 Boost.WinAPI 来选择目标 Windows 版本。
  • 新增：添加了 directory_options 枚举，反映了 C++20 中的同名枚举。该枚举在 directory_iterator 和 recursive_directory_iterator 中受支持，用于自定义迭代行为。特别是，迭代器现在支持跳过因权限不足而无法打开的目录。symlink_option 枚举现已弃用，应替换为 directory_options。
  • 默认情况下，recursive_directory_iterator 现在会在发生错误时重置到结束状态，如 C++20 所要求。（#112）
  • 新增：添加了 directory_options::pop_on_error 选项，该选项配置 recursive_directory_iterator，使其通过反复调用 pop() 来尝试从迭代错误中恢复，直到成功或达到结束状态。（#113）
  • 新增：添加了 directory_options::skip_dangling_symlinks 选项，该选项配置 recursive_directory_iterator，使其不跟随悬空目录符号链接，而是继续迭代而不是报告错误。
  • 已弃用：recursive_directory_iterator 的以下成员现已标记为已弃用：level()、no_push_pending()、no_push_request()、no_push()。建议用户使用标准对应项替换它们：depth()、recursion_pending()、disable_recursion_pending()。请注意，recursion_pending() 的含义与 no_push_pending() 和 no_push_request() 相反。已弃用的方法将在未来版本中移除。
  • 修复了 path::lexically_relative（及其任何依赖的算法）以正确处理参数中的空、点和点点路径元素。其行为更接近 C++17 std::path::lexically_relative，即忽略空和点路径元素，并通过减少生成的相对路径中的点点路径元素数量来计入点点路径元素。（#76）
• Functional/Factory:
  • Glen Fernandes 重写了 factory 和 value_factory 的实现，以提供以下功能
    • 在可能的情况下支持右值参数
    • 在可能的情况下通过变长模板支持任意数量的参数
    • 支持 final 分配器
    • 支持使用智能指针的分配器
    • 支持禁用异常（BOOST_NO_EXCEPTIONS）
    • 提高了编译时间
  • 以下功能已被移除
    • 通过 BOOST_FUNCTIONAL_VALUE_FACTORY_MAX_ARITY 增加 C++03 编译器的限制
    • 通过 BOOST_FUNCTIONAL_FACTORY_SUPPORT_NONE_T 使用 boost::none_t 替代 void
• GIL:
  • 添加了
    • GSoC 2019：Lanczos 重采样用于图像缩小（PR#309）。
    • GSoC 2019：用于二值阈值化、反二值阈值化和截断阈值化的方法（PR#313）。
    • GSoC 2019：Otsu 阈值化方法（PR#314）。
    • GSoC 2019：使用邻域区域的平均值或高斯加权和的自适应阈值化（PR#315）。
    • GSoC 2019：Harris 响应计算（不带非最大值抑制的角点检测器）（PR#350）。
    • GSoC 2019：Hessian 角点检测器（PR#364）。
    • GSoC 2019：在 Numeric 扩展中定义 2D 内核的类型 kernel_2d 和 kernel_2d_fixed（PR#361）。
    • GSoC 2019：将 2D 卷积实现为新函数 convolve_2d（PR#367）。
    • GSoC 2019：使用平均滤波器进行盒式滤波（PR#383）。
    • GSoC 2019：基于归一化平均滤波器的模糊函数（PR#383）。
    • GSoC 2019：Sobel 和 Scharr 算子（PR#392）。
    • GSoC 2019：中值滤波器用于去除图像噪声（PR#393）。
    • 继续添加新的测试用例，并显著提高了整体测试覆盖率。
    • 记录了 cached_location_t 的目的（PR#287）。
    • Numeric 扩展中的函数 convolve_1d，用于方便地使用 convolve_rows 和 convolve_cols（PR#347）和 PR#367）。
    • Numeric 扩展中的函数 extend_boundary，用于执行图像边界扩展（PR#386）。
    • 项目发布说明维护在 Markdown 文件 RELEASES.md 中（PR#404）。
  • 更改了
    • 将所有测试、核心功能和扩展移至 test/ 目录内（PR#302）。
  • 已移除
    • 用 Boost.MP11 替换 Boost.MPL（PR#274）。
    • 移除了对 Boost.TypeTraits 的使用（PR#274）。
    • 放弃了对 GCC <= 4.8 的支持（PR#296）。
    • 移除未使用的文件 include/boost/gil/version.hpp（PR#403）。
  • 修复了
    • 默认初始化的通道和像素对象的未确定值（PR#273）。
    • 由于 std::is_trivially_default_constructible 特化导致的未定义行为（PR#284）。
    • 读取带有无效头的 PNG 文件时崩溃（PR#385）。
    • 为多种类型应用了三法则。
    • 移除了对默认复制赋值运算符或复制构造函数隐式定义的用法。
• 直方图:
  • 多项新功能和性能改进，以及一些 bug 修复
  • 有关更改的完整列表，请参阅发布说明
• Log:
  • 提高了与 clang-win 编译器的兼容性。
• MPI:
  • 文档的澄清。
  • 修复了使用显式输入缓冲区偏移量时的 scatterv bug。
  • 启用 Intel MPI >= 2019.4 的 MPI_Probe 和朋友的使用
  • Windows 上的符号可见性
• 数学:
  • 添加了超几何函数 1F0、0F1、2F0、1F1 和 pFq。
  • 添加了 Jacobi 多项式（及其导数）的求值。
  • 添加了 Gegenbauer 多项式（及其导数）的求值。
  • 添加了 Cardinal B-Splines（及其导数），将其作为多项式函数本身。
  • 添加了 Cardinal 三角插值。
  • 添加了新的统计子节。
  • 添加了一样本学生 t 检验。
  • 添加了 Anderson Darling 正态性检验。
  • 添加了 Ljung Box 自相关检验。
  • 添加了 Runs 随机序列检验。
  • 头文件 boost/math/tools/univariate_statistics.hpp 和 boost/math/tools/bivariate_statistics.hpp 已弃用，取而代之的是 boost/math/statistics/univariate_statistics.hpp 和 boost/math/statistics/bivariate_statistics.hpp。
  • 添加了经验 CDF 分布。
  • 重构了多精度伽马函数使用的斯特林近似，使其适用于在常规精度下使用 Lanczos 近似的所有函数。还将 Lanczos 近似扩展到 100 位十进制精度。
• Multiprecision:
  • 大规模 constexpr 更新允许 cpp_int 和 float128 算术在 gcc 和 clang 9 或更高版本，或任何支持 std::is_constant_evaluated() 的编译器上完全 constexpr。
  • 修复了可变精度 mpf_float 中导致其在选择正确精度时陷入死循环的 bug - 请参见 https://github.com/boostorg/multiprecision/issues/164。
• Outcome:
  • 增强
    • 独立 Outcome 现在可以 make install，并且 cmake find_package() 可以找到它。请注意，您必须单独安装并 find_package() Outcome 的依赖项 quickcpplib，否则 Outcome 的 find_package() 将失败。
    • 独立 Outcome 使用的指定依赖库的 git 子模块机制已被 cmake 依赖项超级构建机制取代。在 cmake 配置时，将 git 克隆一个内部的 quickcpplib 副本，并在构建目录中构建和安装它，然后内部的 find_package() 将使用它。这破坏了将未配置的 Outcome 仓库用作 Outcome 实现的方式，您现在必须执行以下操作之一：1.将 Outcome 作为子目录添加到 cmake 构建中。2.使用 cmake 超级构建（即 ExternalProject_Add()）来构建和安装 Outcome 到本地安装。3.使用其中一个单头文件版本。
    • 对于独立 Outcome，现在会检查当前编译器是否能编译包含 C++ Concepts 的代码，如果能，则所有使用 Outcome 的 cmake 消费者都将启用 C++ Concepts。将 cmake 变量 CXX_CONCEPTS_FLAGS 设置为空字符串以防止自动检测和启用 C++ Concepts 支持。
    • OUTCOME_TRY 操作现在会向编译器提示操作将成功。 P1886 错误速度基准测试 表明，通过向编译器提示表达式是否预期成功，在非常小的函数中可以获得显著的收益。OUTCOME_TRY 以前根本没有向编译器提示，但现在它会了。一套新的宏 OUTCOME_TRY_FAILURE_LIKELY 会向编译器提示预期会失败。如果您希望恢复到以前未提示的行为，请将 OUTCOME_TRY_LIKELY(expr) 定义为 (!!expr)。
    • #199 添加了对 C++ Coroutines 的支持。这分为两部分，首先有一个 OUTCOME_CO_TRY() 操作，适用于在 C++ Coroutine 中执行 TRY 操作。其次，在头文件 outcome/coroutine_support.hpp 中，有 eager<OutcomeType> 和 lazy<OutcomeType> 的实现，让您可以更自然、更高效地在 C++ Coroutines 中使用 basic_result 或 basic_outcome - 特别是，如果结果或 outcome 将从异常指针构造，coroutine 中抛出的异常将返回一个带异常的错误或异常结果，而不是通过 coroutine 机制抛出异常（这在当前编译器中，很可能导致程序崩溃）。eager<T> 和 lazy<T> 都可以接受任何 T。两者都在 VS2019 和 clang 9 上进行了测试并发现工作正常。
    • #210 现在额外考虑了 make_error_code() 和 make_exception_ptr() 以实现 basic_result<> 的兼容复制和移动转换。这允许您将 basic_result<T, E> 构造为 basic_result<T, error_code>，其中 E 是一个自定义类型，该类型实现了 ADL 发现的自由函数 error_code make_error_code(E)，但与 error_code 其他方面无关。对于 exception_ptr，也存在类似的可用性，其中 make_exception_ptr() 是 ADL 发现的自由函数。为了减少构造函数数量，basic_outcome<> 对此的支持比 basic_result<> 少，但它将通过此机制接受从 basic_result<> 和 failure_type<> 的转换。
  • 错误修复
    • #184 对编译器 [[nodiscard]] 支持的检测存在轻微错误。
• PolyCollection:
  • 维护工作。
• 预处理器:
  • 添加了讨论空值的主题
  • 支持 C++20 的 __VA_OPT__ 构造
    • BOOST_PP_VARIADIC_HAS_OPT：检查 C++20 级别的 __VA_OPT__ 是否受支持
    • BOOST_PP_CHECK_EMPTY：使用 C++20 级别的 __VA_OPT__ 测试空值
    • BOOST_PP_VA_OPT：C++20 级别的 __VA_OPT__ 的更灵活替代方案
• 智能指针:
  • 为标量和数组实现了 allocate_unique。（Glen Fernandes）
• Test:
  • Boost.test v3.12，更多详细信息请参阅变更日志。
  • 新功能
    • 已添加对 C++17 std::string_view 的支持。
    • 对 boost::exception 和无 RTTI 模式的更好诊断（感谢 Mikhail Pilin / [pull_request 234]）
  • Bug 修复和拉取请求。
    • GitHub 问题：#206、#217、#223、#229
    • GitHub 拉取请求：PR#227、PR#231、PR#232、PR#234
• VMD:
  • BOOST_VMD_IS_EMPTY 更新为使用 C++20 级别的 __VA_OPT__，具有 100% 的可靠性

测试的编译器

Boost 的主要测试编译器是：

• Linux
  • Clang：3.0、4.0.1、6.0.1
  • Clang, C++0x：3.0
  • Clang, C++11：3.0、3.1、3.2、3.3、3.4、4.0.1、6.0.1、7.0.0、8.0.0
  • Clang, C++14：3.5.0、3.6.0、3.7.1、3.8.0、3.9.1、4.0.0、4.0.1、5.0.2、6.0.1、7.0.0、8.0.0
  • Clang, C++17：5.0.2、6.0.1、7.0.0、8.0.0
  • GCC：4.4.7、4.5.3、4.6.3、5.4.0、8.0.1
  • GCC, C++0x：4.4.7
  • GCC, C++11：4.7.3、4.8.5、4.9.4、5.4.0、6.4.0、7.1.0、8.0.1
  • GCC, C++14：5.4.0、5.5.0、6.4.0、7.1.0、7.3.0、8.0.1
  • GCC, C++17：7.3.0、8.0.1
  • Intel, C++14：18.0
• OS X
  • Apple Clang：9.0.0、9.1.0、10.0.0
  • Apple Clang, C++11：9.0.0、9.1.0、10.0.0
  • Apple Clang, C++14：9.0.0、9.1.0、10.0.0
  • Apple Clang, C++17：9.1.0、10.0.0
  • Apple Clang, C++1z：9.0.0
  • Apple Clang, C++2a：10.0.0
• Windows
  • GCC：3.4.5、4.1.2、4.2.4、4.3.3、4.4.0、4.5.4
  • GCC, C++0x：4.6.4
  • GCC, C++11：4.7.3、4.8.1、4.9.3
  • GCC, C++14：5.1.0、5.2.0、5.3.0、6.1.0、6.2.0、6.3.0、6.4.0
  • GCC, C++17：7.1.0、7.2.0、7.3.0
  • Visual C++：7.1、8.0、9.0、10.0、11.0、12.0、14.0、14.1
• FreeBSD
  • Clang：4.0.0
  • Clang, C++11：4.0.0
  • Clang, C++14：4.0.0
  • Clang, C++1z：4.0.0

Boost 的其他测试编译器包括：

• Linux
  • Clang：3.0、3.8.1、3.9.1、4.0.1、5.0.2、6.0.1
  • Clang, C++0x：3.0
  • Clang, C++11：3.0、3.1、3.2、3.3、3.4、4.0.1、6.0.1、7.0.0、8.0.0
  • Clang, C++14：3.5.0、3.6.0、3.7.1、3.8.0、3.9.1、4.0.0、4.0.1、5.0.2、6.0.1、7.0.0、8.0.0
  • Clang, C++17：5.0.2、6.0.1、7.0.0、8.0.0
  • GCC：4.4.7、4.5.3、4.6.3、4.9.4、5.4.0、5.5.0、8.0.1
  • GCC, C++0x：4.4.7
  • GCC, C++11：4.7.3、4.8.5、4.9.4、5.4.0、6.4.0、7.1.0、8.0.1
  • GCC, C++14：5.4.0、5.5.0、6.3.0、6.4.0、7.1.0、7.3.0、8.0.1、8.1.0
  • GCC, C++17：7.3.0、8.0.1
  • Intel, C++14：18.0
• OS X
  • Apple Clang：9.0.0、9.1.0、10.0.0
  • Apple Clang, C++11：9.0.0、9.1.0、10.0.0
  • Apple Clang, C++14：9.0.0、9.1.0、10.0.0
  • Apple Clang, C++17：9.1.0、10.0.0
  • Apple Clang, C++1z：9.0.0
  • Apple Clang, C++2a：10.0.0
• Windows
  • GCC：3.4.5、4.1.2、4.2.4、4.3.3、4.4.0、4.5.4
  • GCC, C++0x：4.6.4
  • GCC, C++11：4.7.3、4.8.1、4.9.3
  • GCC, C++14：5.1.0、5.2.0、5.3.0、6.1.0、6.2.0、6.3.0、6.4.0
  • GCC, C++17：7.1.0、7.2.0、7.3.0
  • Visual C++：7.1、8.0、9.0、10.0、11.0、12.0、14.0、14.1
• FreeBSD
  • Clang：4.0.0
  • Clang, C++11：4.0.0
  • Clang, C++14：4.0.0
  • Clang, C++1z：4.0.0

致谢

Marshall Clow 和 Michael Caisse 管理了此次发布。