版本 1.70.0

2019 年 4 月 12 日 06:04 GMT

文档

已知问题

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

• 修复了空闲 ping 超时中的 move-from executor（#1599）
  • Beast 补丁

新库

• Outcome:
  • 一套用于在直接使用 C++ 异常处理不适用的场景下报告和处理函数失败的工具，来自 Niall Douglas。
• 直方图:
  • 为 C++14 设计的快速、可扩展的多维直方图，具有方便的接口，来自 Hans Dembinski。

更新的库

• Asio:
  • 此版本包含一系列新功能、错误修复、性能增强和文档改进。值得注意的更改包括：
    • 添加了使用自定义 I/O 执行器处理 I/O 对象（如套接字）的功能。
    • 添加了具有 `initiate` 静态成员函数的新 `async_result` 形式。
    • 更新了 Coroutines TS 支持，并将其提升到 `asio` 命名空间。
    • 添加了新的 `DynamicBuffer_v2` 概念，它是 CopyConstructible 的。
    • 添加了新的 `async_compose` 函数，简化了用户定义异步操作的实现。
    • 添加了 `make_strand` 辅助函数。
    • 放宽了完成条件类型要求，仅要求可移动构造，而非可复制构造。
    • 为 `local::basic_endpoint` 添加了一个接受 `string_view` 的构造函数。
    • 为各种函数添加了 `noexcept` 限定符。
    • 添加了一个新的 `BOOST_ASIO_DISABLE_VISIBILITY` 配置 `#define`。
    • 启用了内存回收，这些内存用于多态执行器的函数对象的类型擦除。
    • 更改了接收操作，以便在数据报式套接字上发生截断（`error::message_size`）时返回正确传输的字节数。
    • 修复了当后端使用 `pthread_cond_timedwait` 时绝对超时时间的计算。
    • 更改了基于范围的异步连接操作，以推断 `EndpointSequence` 迭代器类型。
    • 修复了 `buffer_sequence_begin` 和 `buffer_sequence_end` 以防止隐式转换。
    • 确保 SSL 握手错误在本地操作完成前传播给对端。
    • 抑制了 SSL 关闭时的 `eof` 错误，因为该错误实际上表示成功。
    • 当 OpenSSL 返回 `SSL_ERROR_SYSCALL` 但没有关联的错误时，添加了一个回退错误码。
    • 更改了复合异步读写操作以移动缓冲区序列对象。
    • 修复了 macOS 特定的关于 `OSMemoryBarrier` 弃用的警告。
    • 修复了在使用 MSVC 11.0 进行复合读写操作时出现的编译错误。
    • 改进了 `dispatch`、`post` 和 `defer` 的文档。
    • 修复了在使用 `system_executor` 时可能发生的 Windows 特定的内存泄漏。
  • 有关更多详细信息，请参阅 修订历史记录。
• Beast：重大更新！！！
  • 某些 API 已更改。
  • 参考 参考 中的每个新项目旁边都有一个星号 ★。
  • Beast 需要您的帮助！
    • 告诉我们您或您的公司如何使用 Beast。
    • 请 报告任何 bug、功能请求或一般性反馈。
    • 加入 C++ Slack 工作区，免费与我们在 #beast 和 #boost 频道聊天。
    • 别忘了 给仓库点赞 ⭐！
  • 更多教程，像专业人士一样写代码！
    • 网络复习 从基础到进阶。
    • 更新了 异步回声 示例。
    • 更新了 检测 SSL 复合操作教程。
    • websocket-chat-multi 多线程聊天服务器，带有一个 JavaScript 浏览器客户端。
  • basic_stream 和 tcp_stream 提供：
    • 超时：`async_read_some`、`async_write_some` 在过期时以 error::timeout 完成！
    • 流量整形策略 simple 和 unlimited，或者用户自定义的 RatePolicy！
    • 通过 P1322R0 将 strand 直接放在套接字上，无需在调用点使用 `bind_executor`！
  • 基类 async_base 和 stable_async_base 为您处理所有复合操作的样板代码。
  • ssl_stream 提供了一个可移动、可赋值的 SSL 流，并具有扁平化写入优化。
  • 所有异步操作都使用 Asio 的 `async_initiate` 以实现与 Coroutines TS 的高效集成。
  • ⚡ 编译速度更快，定义 `BOOST_BEAST_SEPARATE_COMPILATION` 并将 `#include <boost/beast/src.hpp>` 放在您的一个 .cpp 文件中！
  • 请参阅完整的 发布说明 以获取完整的更改列表。
• Context:
  • #91：创建 ucontext 失败时清理堆栈。
  • #97：在 stack_context 中添加缺失的 BOOST_CONTEXT_DECL。
  • #98：修复 jump_i386_sysv_macho 向 x87 控制字写入垃圾数据。
• Coroutine2:
  • #28：`pthread_cancel` 时不崩溃。
• DLL:
  • 新的宏 BOOST_DLL_USE_STD_FS。定义它为 `1` 以使 Boost.DLL 使用 C++17 的 `std::filesystem::path`、`std::system_error` 和 `std::error_code`（#21）。请注意，异常类型从 `boost::system::system_error` 更改为 `std::system_error`，因此请务必更新 `catch` 块。
  • 对动态加载的检测和装饰逻辑进行了大量重写。现在加载失败时会报告更精确的错误。添加了 `shared_library::decorate()` 函数，该函数返回库的装饰路径，而无需进行任何平台相关的查询和检测。建议使用 `shared_library::load` 和 `shared_library` 构造函数以获得更好的结果（非常感谢 Loïc Touraine 的工作 PR#23）。
  • CI 加固，文档更新，拼写错误修复，清理和许多可移植性修复。
• Dynamic Bitset:
  • 在 MSVC 上禁用了硬件加速的 popcount（在 1.69.0 中添加），因为在旧 CPU 上存在未定义行为。（#33 PR#35）
• Fiber:
  • #191：忽略未使用的参数警告。
  • #196：修复 remote_ready_splk_ 的高争用。
• Filesystem:
  • 修复了 `path` 实现中少数解引用 `std::string::end()` 的情况。
  • 修复了在目录迭代器构造函数和接受 `error_code` 引用的操作中发生内存不足时程序终止的问题。（#58）
  • 修复了由于 `path` 的静态成员定义丢失可能导致的链接错误。（#12759）
  • 修复了在 Linux 上目录迭代器递增操作中可能使用未初始化数据的可能性。
  • 为目录迭代器添加了对可移动的支持。
  • 为 `directory_entry` 添加了文件状态查询重载。这避免了在对目录迭代器解引用结果请求文件状态时进行相对昂贵的操作系统查询。（PR#55）
  • 重构了 `current_path` 和 `read_symlink` 的实现，以避免在文件系统损坏或被篡改时可能发生的内存耗尽。这些函数现在对操作系统提供的大小限制有一个内部限制，目前为 16 MiB。
  • 增加了 `copy_file` 使用的内部缓冲区大小。
• Integer:
  • 添加了扩展欧几里得算法和模逆元函数。（Nick Thompson，PR#11）
• Log:
  • 新功能
    • 添加了在文本文件接收器后端收集文件之前生成另一个日志文件的支持。这允许将追加到现有日志文件与时间戳和日志文件名中的文件计数器结合起来，从而支持通用文件收集。
  • 有关更多详细信息，请参阅 更改日志。
• 数学:
  • 新功能
    • 添加 Lanczos 平滑导数
    • 将 `numerical_differentiation.hpp` 从 `boost/math/tools/` 移动到 `boost/math/differentiation/finite_difference.hpp`。
    • 将均值、方差、偏度、峰度、中位数、基尼系数和中位数绝对偏差添加到 `tools/univariate_statistics.hpp`。
    • 将相关系数和协方差添加到 `tools/bivariate_statistics.hpp`。
    • 将绝对基尼系数、Hoyer 稀疏度、Oracle SNR 和 `M`[sub 2] `M`[sub 4] SNR 估计器添加到 `tools/signal_statistics.hpp`。
    • 将全变差、l0、l1、l2 和 sup 范数以及相应的距离函数添加到 `tools/norms.hpp`。
    • 为多项式添加移动构造函数，支持复系数，添加 `.prime()` 和 `.integrate()` 方法。
    • 将 `quadratic_roots` 添加到 `tools/roots.hpp`。
    • 为牛顿法在 `roots.hpp` 中添加对复值函数的支持。
    • 添加 Catmull-Rom 插值器。
• Mp11:
  • 将 `mp_invoke` 重命名为 `mp_invoke_q`。
  • 添加了 `mp_similar`。
  • 添加了 `mp_set_union`、`mp_set_intersection`、`mp_set_difference`。
  • 添加了 `mp_not_fn`。
  • 添加了 `mp_transform_first`、`mp_transform_second`、`mp_transform_third`。
  • 添加了 `mp_filter`。
  • 添加了 `mp_eval_if_not`、`mp_eval_or`、`mp_valid_q`。
  • 添加了 `mp_back`、`mp_pop_back`。
• 多索引容器:
  • `size_type` 和 `difference_type` 现在被定义为分配器的同名类型。这在绝大多数情况下不会产生任何差异，但允许通过用户定义的分配器类型对生成的内部结构进行一定程度的控制（有关动机，请参阅问题 #17）。目前，此更改并未在参考部分中记录（即，它具有半官方状态）。
  • 维护工作。
• Multiprecision:
  • 修复了 trait 类中的各种转换问题，并检查与 Boost.Optional 的兼容性。
  • 在检查可转换性时，防止在任何旧类型上实例化 `std::numeric_limits`。请参阅 #98。
  • 更新了可变精度代码，以适应任意精度整数。请参阅 #103。
  • 添加了对 XML 序列化存档的支持。
  • 修复了 `mpf_float` 和 `mpfr_float` 中固定精度 iostream 格式化的错误。请参阅 #113。
  • 为 MPFR 原生处理的特殊函数添加了更多重载。
  • 修复了通用 `exp` 实现中可能导致不变量失败的错误。
  • 修复了浮点数到整数的通用转换，以避免未定义行为。请参阅 #110。
• PolyCollection:
  • 在 Billy O'Neal 报告的错误后，改进了对有状态分配器和分配器传播特性的处理（PR#9）。
  • 修复了内部缓存结构中一个潜在的严重 bug。
• Spirit:
  • 删除了对已弃用的 `boost/detail/iterator.hpp` 头文件的使用。PR#432
  • X3
    • 整数解析器现在应该可以处理用户定义的类型。PR#429
    • 注意： `check_overflow` trait 的默认实现现在依赖于 `std::numeric_limits<T>::is_bounded` 而不是 `boost::integer_traits<T>::is_integral`。
    • 移除了顺序纯解析。现在它会触发编译时错误，而不是静默地解析序列并将最后一个值作为结果。PR#439
    • 修复了 `parse_rule` 使用 `BOOST_SPIRIT_INSTANTIATE` 进行实例化时的问题：
      • 规则没有属性。PR#455
      • 实际属性的类型与声明规则的类型不匹配。PR#456 #457
    • 非常感谢 Xeverous 报告了 #453 中的回归问题。
    • 修复了规则中不必要的属性合成和无转换属性引用传递。#444 PR#449 PR#452
    • 移除了损坏的 1.0#INF 解析器。它文档不完善且从未工作过。#415 PR#458 #8699
    • 未文档化的 `make_attribute` trait 被移除，因为它存在 bug PR#449，并且是为了简化属性转换。PR#460
    • 如果您曾使用它来规避属性转换中的 bug，那么从本次发布开始，这些 bug 应该不再存在。
    • 整数值解析器现在尊重 `std::numeric_limits<T>::digits10` 的值。PR#469
    • 修复了 `(Min % Base) == 0` 边界情况下的下溢检查。PR#469
    • 修复了 `IgnoreOverflowDigits=true` 整数解析器的溢出输出值。PR#470
    • 容器属性元素被复制，但未移动。PR#472
    • 移除了对 `transform_attribute` 中引用的特殊处理。PR#480
  • V2
    • 修复了 Boost.Endian 的宏名称冲突和命名空间冲突。PR#349 PR#482
    • utree
      • 修复了 tag getter 中由于左移负值导致的 UB。PR#423
      • 修复了双重转换（`spirit::string` -> `std::string` -> `spirit::string`）。PR#462
    • Qi
      • 为规则跳过器类型问题添加了静态断言。PR#427
      • `check_overflow` trait 的默认实现现在依赖于 `std::numeric_limits<T>::is_bounded` 而不是 `boost::integer_traits<T>::is_integral` PR#429
      • 整数解析器现在应该可以处理用户定义的类型。PR#429
      • 注意： `check_overflow` trait 的默认实现现在依赖于 `std::numeric_limits<T>::is_bounded` 而不是 `boost::integer_traits<T>::is_integral`。
      • 移除了损坏的 1.0#INF 解析器。它文档不完善且从未工作过。#415 PR#458 #8699
      • 未文档化的 `make_attribute` trait 已合并到 `transform_attribute` trait。PR#471
      • `pre_transform`、`post_transform` 和 `fail_transform` 实用函数已移除，取而代之的是直接使用 transform trait 的 `pre`/`post`/`fail`。PR#467
      • 整数值解析器现在尊重 `std::numeric_limits<T>::digits10` 的值。PR#469
      • 修复了 `(Min % Base) == 0` 边界情况下的下溢检查。PR#469
      • 修复了 `IgnoreOverflowDigits=true` 整数解析器的溢出输出值。PR#470
      • 移除了对 `transform_attribute` 中引用的特殊处理。PR#480
    • Lex
      • 修复了 lexer 在使用用户指定的 token 类型时的默认构造函数中的 UB。PR#420
  • Classic
    • 修复了 `position_iterator` 当底层迭代器解引用运算符返回非引用类型时，形成局部引用。PR#422 #9737
• Stacktrace:
  • iOS 32 位 ARM 的构建修复（非常感谢 Ivan Ponomarev 提供修复 PR#70）。
  • 修复了多个拼写错误、警告，并更新了文档。
• Test:
  • Boost.test v3.10，有关更多详细信息，请参阅 更改日志。
  • 破坏性更改
    • Boost.Test 的 `minimal.hpp` 现在会显示弃用警告。
    • 浮点数比较的更改可能会导致一些测试失败，这些测试在此版本之前是默默地不使用浮点数比较逻辑的。
    • `unit_test_log_formatter` 的内部 API 更改，请参阅详细的更改日志。
  • 新功能
    • 浮点数比较已扩展到包含非浮点数和算术操作数：像 `BOOST_TEST(3.0001 == 3)` 这样的表达式现在使用 Boost.Test 的浮点数支持。
    • 自定义数据集不再需要声明 `sample` 类型字段。
    • 将模板测试用例从 `std::tuple` 扩展到任何可变参数定义。
    • Windows 对计时测试的支持。
    • 测试套件上的计时测试。
    • 移除了对 Boost.Timer 的依赖。
    • 新的宏 `BOOST_TEST_INFO_SCOPE` 用于作用域上下文声明。
    • 改进了 `BOOST_TEST_CONTEXT` 语法。
  • Bug 修复和拉取请求。
    • Trac 票证：#7397、#9434、#13106、#13418
    • GitHub 问题：#133、#138、#141、#157、#160、#174、#176、#177、#180、#181、#194、#196、#198、#199、#202、#203、#204
    • GitHub 拉取请求：PR#171、PR#172、PR#182、PR#183、PR#184、PR#190、PR#195、PR#195、PR#197、PR#205
• TypeIndex:
  • 添加了对 GHS C++ 编译器的支持（非常感谢 Brandon Castellano 提供补丁 PR#28）。
  • 优化了字符串和类型比较（非常感谢 Andrey Semashev 提供补丁 PR#23）。
  • 修复了 clang-win 编译问题（非常感谢 Peter Dimov 提供补丁 PR#25）。
  • CI 加固。
• TypeTraits:
  • 添加了 is_bounded_array 和 is_unbounded_array（Glen Fernandes）。
  • 添加了 copy_reference 和 copy_cv_ref（Glen Fernandes）。
  • 改进了对 msvc /clr 选项的支持。
  • 杂项编译器兼容性修复。
• Variant:
  • 许多清理和内部改进，非常感谢 Nikita Kniazev（PR#55、PR#56、PR#57）和 Louis Dionne（PR#51）。
  • CI 加固。
• uBlas:
  • 添加了张量框架（非常感谢 Cem Bassoy PR#65）。
  • 添加了基本的 OpenCL 支持（非常感谢 Fady Essam PR#59）。
  • 集成了基本的基准测试套件（非常感谢 Stefan Seefeld PR#57）。
  • CI 集成和加固。

测试的编译器

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

致谢

Daniel James、Vladimir Prus、Marshall Clow 和 Michael Caisse 管理了本次发布。