Boost C++ 库

……是世界上最受推崇、设计最精良的 C++ 库项目之一。 Herb SutterAndrei Alexandrescu, C++ Coding Standards

Boost.StaticString - Boost C++ 函数库
Next

Boost.StaticString

Krystian Stasiowski

Vinnie Falco

根据 Boost 软件许可证版本 1.0 发布。(参见随附文件 LICENSE_1_0.txt 或在 https://boost.ac.cn/LICENSE_1_0.txt 复制)

简介

该库提供了一种动态可调整大小的字符串,它具有编译时固定的容量和连续的嵌入式存储,其中的字符直接放置在字符串对象本身中。其 API 非常类似于 std::string

动机

固定容量的字符串在以下情况下很有用:

  • 无法进行内存分配,例如,在没有自由存储的嵌入式环境中,只有堆栈和静态内存段可用。
  • 内存分配会带来不可接受的性能损失,例如,在延迟方面。
  • 需要在静态内存段中分配具有复杂生命周期的对象。
  • constexpr 函数中需要动态可调整大小的字符串。
  • 要求 static_vector 元素的存储位置位于字符串对象本身内部(例如,为了支持用于序列化的 memcpy)。

要求

该库可以在两种不同的模式下使用:独立模式和依赖 Boost 模式。该库默认使用依赖 Boost 模式;独立模式通过使用配置宏来选择加入。

在依赖 Boost 模式下,除了 Boost.Core、Boost.Utility 和 Boost.ContainerHash 之外,该库还需要使用至少 C++11。在独立模式下,需要 C++17,但除了标准库之外,不需要任何其他库。

设计

首要的设计目标是尽可能地模仿 std::string 的接口和行为。当任何操作超过字符串允许的最大大小时,如果启用了异常,则会抛出 std::length_error。所有抛出异常的算法都提供强大的异常安全保证。这旨在成为 std::string 的即插即用替代品。

static_string 的 API 在少数几个地方与 std::string 不同,其中之一是添加了 subview 函数,此实现为此函数返回一个 string view 而不是 static_string,并且某些永远不会抛出异常的函数被标记为 noexcept,这与 std::string 的函数不同。static_string 的可用重载与 std::string 的相同。

迭代器

迭代器失效规则与 std::string 的不同。

  • 移动 static_string 会使所有迭代器失效。
  • 交换两个 static_string 会使所有迭代器失效。

优化

根据用于 static_string 特化的字符类型和大小,会使用某些优化来减小类类型的大小。给定一个形式为 basic_static_string<N, CharT, Traits> 的特化的名称。

  • 如果 N 为 0,则该类没有非静态数据成员。给定两个类型分别为 basic_static_string<0, T, Traits>static_string<0, U, Traits> 的对象 ab,如果 TU 相同,则 data() 返回的指针值将相同。
  • 否则,用于存储 static_string 大小的成员的类型将是能够表示值 N 的最小标准无符号整数类型。

配置

可以通过定义配置宏来启用和禁用某些功能。宏及其控制的关联功能是:

  • BOOST_STATIC_STRING_STANDALONE:定义时,库将置于独立模式。

致谢

感谢 Agustín BergéPeter DimovGlen FernandesChristian Mazakas 在开发此库期间提供的持续反馈和指导。

此库的开发由 The C++ Alliance 赞助。

参考

定义于命名空间 boost::static_strings

basic_static_string


Next