版本 1.70.0

2019 年 4 月 12 日 06:04 GMT

文档

已知问题

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

• 修复了空闲 ping 超时中的 moved-from 执行器 (#1599)
  • Beast 补丁

新库

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

更新的库

• Asio:
  • 此版本包含许多新功能、错误修复、性能增强和文档改进。值得注意的更改包括：
    • 添加了使用自定义 I/O 执行器与 I/O 对象（如套接字）的能力。
    • 添加了一个新的 `async_result` 形式，其中包含一个 `initiate` 静态成员函数。
    • 更新了 Coroutines TS 支持，并将其提升到 `asio` 命名空间。
    • 添加了一个新的 `DynamicBuffer_v2` 概念，它是 CopyConstructible 的。
    • 添加了一个新的 `async_compose` 函数，它简化了用户定义异步操作的实现。
    • 添加了一个 `make_strand` 辅助函数。
    • 放宽了完成条件类型要求，使其只需要 move-constructible 而不是 copy-constructible。
    • 为 `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
    • 请 报告任何错误、功能请求或一般反馈。
    • 加入 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 ` 在您的一个 .cpp 文件中！
  • 请参阅完整的 发布说明 以获取完整的更改列表。
• Context:
  • #91：如果创建 ucontext 失败，则清理堆栈。
  • #97：在 stack_context 中添加缺失的 BOST_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` 添加了文件状态查询重载。这避免了当文件状态请求是目录迭代器解引用的结果时，进行相对昂贵的 OS 查询。（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` 中添加了相关系数和协方差。
    • 在 `tools/signal_statistics.hpp` 中添加了绝对基尼系数、Hoyer 稀疏度、Oracle SNR 和 M[sub 2]M[sub 4] SNR 估计器。
    • 在 `tools/norms.hpp` 中添加了全变差、l0、l1、l2 和 sup 范数，以及相应的距离函数。
    • 为多项式添加了移动构造函数，支持复数系数，添加了 `.prime()` 和 `.integrate()` 方法。
    • 在 `tools/roots.hpp` 中添加了 `quadratic_roots`。
    • 在 `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:
  • 修复了 traits 类中的各种转换问题，并检查了与 Boost.Optional 的兼容性。
  • 在检查可转换性时，防止对任何旧类型实例化 `std::numeric_limits`。参见 #98。
  • 更新了可变精度代码以考虑任意精度整数。参见 #103。
  • 添加了对 XML 序列化归档的支持。
  • 修复了 `mpf_float` 和 `mpfr_float` 中固定精度 iostream 格式的错误。参见 #113。
  • 为 MPFR 原生处理效果更好的特殊函数添加了更多重载。
  • 修复了通用 `exp` 实现中的一个错误，该错误可能导致不变量失败。
  • 修复了从浮点数到整数的通用转换，以避免未定义行为。参见 #110。
• PolyCollection:
  • 在 Billy O'Neal 报告的错误后，改进了对状态分配器和分配器传播 traits 的处理（PR#9）。
  • 修复了一个内部缓存结构中可能存在的严重错误。
• Spirit:
  • 删除了对已弃用的 `boost/detail/iterator.hpp` 头文件的使用。 PR#432
  • X3
    • 整数解析器现在应该能够处理用户定义的类型。 PR#429
    • 注意： `check_overflow` traits 的默认实现现在依赖于 `std::numeric_limits::is_bounded` 而不是 `boost::integer_traits::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
    • 由于错误 PR#449，并且为了简化属性转换，移除了未文档化的 `make_attribute` trait。 PR#460
    • 如果您曾用它来规避属性转换中的错误，那么从这个版本开始，这些错误应该不再存在了。
    • 整数值解析器现在遵守 `std::numeric_limits::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` traits 的默认实现现在依赖于 `std::numeric_limits::is_bounded` 而不是 `boost::integer_traits::is_integral` PR#429
      • 整数解析器现在应该能够处理用户定义的类型。 PR#429
      • 注意： `check_overflow` traits 的默认实现现在依赖于 `std::numeric_limits::is_bounded` 而不是 `boost::integer_traits::is_integral`。
      • 删除了损坏的 1.0#INF 解析器。它文档不全且从未工作过。 #415 PR#458 #8699
      • 未文档化的 `make_attribute` traits 已合并到 `transform_attribute` traits 中。 PR#471
      • 已删除 `pre_transform`、`post_transform` 和 `fail_transform` 实用函数，转而直接使用 `transform` traits 的 `pre`/`post`/`fail`。 PR#467
      • 整数值解析器现在遵守 `std::numeric_limits::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 Issues：#133、#138、#141、#157、#160、#174、#176、#177、#180、#181、#194、#196、#198、#199、#202、#203、#204
    • GitHub Pull Requests：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 管理了此次发布。