` 内联拼接实战)
MongoDB 字符串操作指南str工具库与str::stream()内联拼接实战【免费下载链接】mongoThe MongoDB Database项目地址: https://gitcode.com/GitHub_Trending/mo/mongodocs/string_manipulation.md是 MongoDB 源码库本仓库为 MongoDB Server 社区版中关于字符串处理的核心规范文档它明确要求所有字符串操作统一使用util/mongoutils/str.h提供的辅助函数并特别推荐用str::stream()在断言、报错、日志等场景中内联组装字符串。本文以该文档为骨架结合仓库内 str.h 的实际实现与 str_test.cpp 测试用例系统讲解str工具库的每一个核心 API 的语义、底层实现与推荐用法帮助你写出风格统一、健壮且易于维护的 MongoDB 服务端 C 代码。1. 文档要点与头文件定位原文档的核心规范只有一条却贯穿整个 MongoDB 代码库的日常开发For string manipulation, use the util/mongoutils/str.h library.文档中提到的路径util/mongoutils/str.h是历史遗留命名早期工具函数位于mongoutils命名空间。在当前仓库中该头文件的实际位置是 src/mongo/util/str.h对应的命名空间为mongo::str即str::实现拆分为str.h内联函数与 str.cpp非内联实现。从源码结构看str.h的依赖链很轻它基于mongo/bson/util/builder.h的StringBuilder、mongo/util/ctype.h的字符分类工具并提供string_view/std::string两种现代 C 视图接口。头文件通过[[MONGO_MOD_PUBLIC]]标记对外导出str.h 第 36 行。2.str::stream()一行代码内联组装字符串文档中唯一给出的代码示例也是str库最常用、最值得推荐的工具uassert(12345, str::stream() bad ns: ns, isOk);这一行完成了三件事构造一个临时的str::stream对象通过连续运算符把字符串字面量、ns可以是任意可流式输出类型内联拼接将拼接结果隐式转换为std::string传给uassert作为错误消息。2.1 为什么要用它对比std::stringstreamstr::stream存在的根本动机在 str.h 第 41-51 行 的注释中写得很清楚——直接使用标准库时下面的写法无法编译// 下面这行无法工作(std::stringstream() 1).str(); (std::stringstream() 1).str();因为operator返回的是std::stringstream无法在临时对象上调用.str()。而str::stream通过隐式类型转换operator std::string()与operator std::string_view()让临时对象可以直接“变”成字符串从而把整个uassert/iassert/massert调用压成一行。2.2 实现剖析stream类的核心实现非常精简str.h 第 53-90 行class stream { public: StringBuilder ss; // 内部实际存储仍是 BSON 工具链的 StringBuilder template class T stream operator(const T v) { ss v; return *this; } operator std::string() const { return ss.str(); } operator std::string_view() const { return ss.stringData(); } friend std::ostream operator(std::ostream os, const stream s) { return os s.ss.stringData(); } ... };要点解读基于StringBuilder内部成员是一个StringBuilder ss来自 mongo/bson/util/builder.h所有最终都落到StringBuilder::operator因此 BSON 里可打印的各种类型如OID、BSONObj、Decimal128等都能直接拼进stream模板operator任意可被StringBuilder接受的类型都支持天然适配 MongoDB 的StringData/StringBuilder生态双隐式转换std::string与std::string_view两个转换运算符配合显式声明的std::ostream输出运算符解决了两者并存时的重载歧义str.h 第 68-73 行编译期防呆模板偏特化operator(R (*val)(Args...)) deletestr.h 第 80-81 行如果误传了一个未求值的函数名例如stream std::hex或忘了加()的someFunction会直接编译失败而不是静默退化为bool重载比较运算符提供了operatorstring_view与C20 三路比较支持stream与字符串直接比较。2.3 在断言体系中的典型用法str::stream()最常见的应用场景是配合 MongoDB 的断言宏生成错误消息。依据 docs/exception_architecture.md 的断言体系uassert用于“每次操作的用户级错误操作级致命”因此错误消息必须足够清晰// 校验命名空间是否合法 uassert(ErrorCodes::InvalidNamespace, str::stream() Invalid namespace: nss.toStringForErrorMsg(), nss.isValid()); // 多行拼接同样自然 iassert(ErrorCodes::BadValue, str::stream() Invalid value v for field fieldName, ok);类似的写法在整个仓库中被广泛采用——从 BSON 校验如 bsonelement.cpp、连接串解析如 mongo_uri.cpp到复制集心跳处理如 replica_set_monitor_manager.cpp大量模块都通过#include mongo/util/str.h引入该工具。3. 前缀与后缀判断startsWith/endsWithstartsWith(str, prefix)判断字符串是否以指定前缀开头支持const char*与std::string两种输入另有单字符重载str.h 第 92-113 行endsWith(str, suffix)判断是否以指定后缀结尾const char*版本内部使用strncmp并先比较长度防止越界str.h 第 115-132 行。if (str::startsWith(ns, admin.)) { ... } // 前缀判断 if (str::endsWith(filename, .wt)) { ... } // 后缀判断注意endsWith的单字符重载返回bool的同时会检查字符串非空len s[len - 1] p避免空串误判。4. 查找与截取after/before/contains这三组函数覆盖了“定位分隔符 取子串”的全部常见需求str.h 第 134-183 行函数语义未找到时的行为after(s, x)返回分隔符x字符或字符串之后的剩余部分返回空串before(s, x)返回分隔符x之前的部分返回整个字符串contains(s, x)判断s是否包含x字符或字符串—std::string_view host str::after(mongodb://host:27017, ://); // host:27017 std::string_view db str::before(admin.users, .); // admin if (str::contains(cmd, createIndexes)) { ... }实现细节字符版本的after用strchr字符串版本用strstrbefore的const char*重载刻意用循环代替strchrstr.h 第 167 行 注释说明这样在找不到时无需二次遍历。5. 公共前缀shareCommonPrefixint shareCommonPrefix(const char* p, const char* q);返回两个字符串共享公共前缀的长度str.h 第 185-202 行。返回值语义0表示完全没有公共前缀两串完全相同时返回其长度。这在比较 key、计算排序差异等场景中非常实用。6. 分割与拼接splitOn/rSplitOn/splitStringDelim/joinStringDelim/count6.1 只切一次的正向/反向分割splitOn与rSplitOn的设计刻意“只分割一次”str.h 第 217-246 行输出通过std::string_view出参返回返回值表示分隔符是否找到std::string_view before, after; if (str::splitOn(abc, , before, after)) { // before a, after bc只切第一处 } std::string_view l, r; str::rSplitOn(a.b.c, ., l, r); // l a.b, r c从右往左切第一处两者在分隔符缺失时行为一致before为整个输入、after为空串、返回false。6.2 全量分割与拼接需要全量分割时使用splitStringDelim反向操作用joinStringDelim声明位于 str.h 第 373-375 行实现在 str.cppstd::vectorstd::string parts; str::splitStringDelim(a,b,c, parts, ,); // parts {a, b, c} std::string joined; str::joinStringDelim({a, b, c}, joined, ,); // joined a,b,c6.3 统计出现次数count(s, c)返回字符c在字符串中出现的次数str.h 第 248-255 行unsigned dots str::count(a.b.c.d, .); // 37. 修剪与大小写ltrim/toLower/ 大小写不敏感比较ltrim(s)只去除空格不处理 tab 等空白符返回修剪后的string_viewstr.h 第 257-264 行。注意这是刻意的最小实现如需处理其他空白字符需自行扩展toLower(s)返回全小写拷贝逐个字符经ctype::toLower转换str.h 第 377-382 行caseInsensitiveCompare(s1, s2)大小写不敏感比较Windows 下用_stricmp其余平台用strcasecmpstr.h 第 357-363 行equalCaseInsensitive(a, b)编译期友好的 constexpr 比较内部逐字符ctype::toLower后比对。头文件注释明确提醒基于tolower的实现对某些语言如土耳其语处理不正确str.h 第 365-371 行使用时要考虑区域设置的影响。std::string_view clean str::ltrim( hello ); // hello std::string lower str::toLower(AbC); // abc if (str::equalCaseInsensitive(OK, ok)) { ... } if (str::caseInsensitiveCompare(a, b) 0) { ... }8. UTF-8 安全处理码点统计与安全截断这是str.h中处理国际化字符串最精细的一组工具str.h 第 266-355 行。它们基于 UTF-8 编码规律单字节码点形如0xxxxxxx多字节首字节形如11xxxxxx续字节形如10xxxxxx。函数语义isLeadingByte(char)是否为多字节码点的首字节isSingleByte(char)是否为单字节码点ASCIIgetCodePointLength(char)由首字节推断码点字节数利用前导 1 的个数isUTF8ContinuationByte(char)是否为续字节lengthInUTF8CodePoints(sv)统计 UTF-8 码点个数非字节数UTF8SafeTruncation(iter/begin, end, max)按字节上限截断并在最近的 UTF-8 码点边界对齐保证结果仍是合法 UTF-8std::string_view emoji a\xF0\x9F\x98\x80b; // ab size_t n str::lengthInUTF8CodePoints(emoji); // 3 个码点而非 5 字节 std::string_view cut str::UTF8SafeTruncation(emoji, 3); // 截到 3 字节边界 // 不会把多字节码点拦腰截断保证输出仍是合法 UTF-8UTF8SafeTruncation的实现先正向确定最大边界再从截断点反向寻找码点首字节、核对续字节数量str.h 第 318-350 行若该码点续字节缺失输入本身非法还会额外回退一步跳过坏码点。此外lengthInUTF8CodePoints对非法输入的行为是未定义的调用方需保证输入是合法 UTF-8。9. 数值转换toUnsigned/parseUnsignedBase10Integer/convertDoubleToString9.1toUnsigned宽松的非负整数解析toUnsignedstr.h 第 204-215 行逐个字符累加一旦遇到非数字字符即停止str::toUnsigned(123abc); // 123容忍尾部非数字 str::toUnsigned(abc); // 0开头非数字则整体为 0 str::toUnsigned(42); // 429.2parseUnsignedBase10Integer严格解析与toUnsigned的宽松不同parseUnsignedBase10Integerstr.h 第 409-414 行要求输入只能由十进制数字组成——不允许/-前缀、不允许首尾空白。解析成功返回boost::optionalsize_t失败返回boost::noneauto r1 str::parseUnsignedBase10Integer(123); // 123 auto r2 str::parseUnsignedBase10Integer(123); // boost::none auto r3 str::parseUnsignedBase10Integer( 12); // boost::none这一严格性在 str_test.cpp 中有完整覆盖包括PositivePrefixFailsToParse、NegativePrefixFailsToParse、TrailingLetterFailsToParse、LeadingLetterFailsToParse、LetterWithinNumberFailsToParse等用例。9.3convertDoubleToString可控精度的浮点转字符串std::string convertDoubleToString(double d, int prec 17);默认精度为 17——注释指出这是标准double能达到的最大十进制精度str.h 第 416-420 行需要更短表示时可显式传入prec。10. 排序比较器LexNumCmp——词法与数字混合排序LexNumCmpstr.h 第 384-401 行是字符串排序用的仿函数functor用于把“字典序”与“数字序”结合起来纯词法模式lexOnly true所有字符包括数字都按字典序比较混合模式默认/lexOnly false非数字字符按字典序比较数字子串按数值大小比较点号.分隔有序的可比子单元类似版本号语义约定字符 255 大于任何字符。str::LexNumCmp cmp(false); cmp(file2, file10); // 数字按数值比较2 10故 file2 在前 cmp(v1.2, v1.10); // 版本号式比较同样成立cmp静态方法LexNumCmp::cmp(s1, s2, lexOnly)可脱离实例直接使用。实现细节见 str.cpp测试覆盖见 str_test.cpp 中的 LexOnly 用例。11. 转义与编码辅助escape/_as_char_ptrescape(s, escape_slash false)转义字符串中的空白与控制字符例如制表符\t转义为字面文本\\t当escape_slash为true时/也会被转义为\\/str.h 第 403-407 行operator_as_char_ptrC20 下u8...前缀会产出新的char8_t类型而 MongoDB 大量接口以普通const char*打交道。该用户自定义字面量把char8_t*静默还原为const char*语义上是“编码已知、类型归位”str.h 第 424-445 行const auto testString u8..._as_char_ptr; // 得到 const char*12. 测试与验证str_test.cpp工具库的正确性由 src/mongo/util/str_test.cpp 全面守护测试组名均为StringUtilsTest覆盖基础组装Simple1/Simple2与stream的十六进制/零填充输出toUnsigned系列零值、双零值、整数、前导零、字母前后缀/夹心等边界parseUnsignedBase10Integer的严格解析拒绝路径LexNumCmp的词法/数字混合比较前缀/后缀判断、子串截取等基础语义。这些用例从正面与负面两个方向锁定了str库各 API 的精确语义是你在自己代码中使用这些函数时最权威的行为参照。13. 最佳实践小结字符串操作优先使用str库统一入口、语义清晰、避免各模块各自手写strchr/substr造成的行为差异。包含#include mongo/util/str.h即可使用命名空间mongo::str。构造错误消息优先str::stream()配合uassert/iassert/massert等断言宏一行内联完成“描述 拼接 传参”并自动享受StringBuilder对 BSON 类型的完整支持。注意函数语义的“宽松”与“严格”toUnsigned宽松容忍尾部字符parseUnsignedBase10Integer严格拒绝任何非十进制数字splitOn/rSplitOn只切一次需要全量分割时改用splitStringDelim。涉及多字节文本务必用 UTF-8 工具族字节数不等于码点数截断请用UTF8SafeTruncation保证合法 UTF-8 输出。大小写转换注意区域语言限制equalCaseInsensitive/toLower基于tolower对部分语言如土耳其语可能不正确国际化场景需额外评估。通过本文可以完整掌握 MongoDB 服务端 C 字符串处理的标准姿势str::stream()用于内联组装startsWith/endsWith/before/after/contains用于定位与截取splitOn/splitStringDelim/joinStringDelim用于分割拼接UTF-8 工具族与LexNumCmp、数值解析函数则覆盖了国际化与排序等进阶场景。【免费下载链接】mongoThe MongoDB Database项目地址: https://gitcode.com/GitHub_Trending/mo/mongo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MongoDB 字符串操作指南：`str` 工具库与 `str::stream()` 内联拼接实战
MongoDB 字符串操作指南str工具库与str::stream()内联拼接实战【免费下载链接】mongoThe MongoDB Database项目地址: https://gitcode.com/GitHub_Trending/mo/mongodocs/string_manipulation.md是 MongoDB 源码库本仓库为 MongoDB Server 社区版中关于字符串处理的核心规范文档它明确要求所有字符串操作统一使用util/mongoutils/str.h提供的辅助函数并特别推荐用str::stream()在断言、报错、日志等场景中内联组装字符串。本文以该文档为骨架结合仓库内 str.h 的实际实现与 str_test.cpp 测试用例系统讲解str工具库的每一个核心 API 的语义、底层实现与推荐用法帮助你写出风格统一、健壮且易于维护的 MongoDB 服务端 C 代码。1. 文档要点与头文件定位原文档的核心规范只有一条却贯穿整个 MongoDB 代码库的日常开发For string manipulation, use the util/mongoutils/str.h library.文档中提到的路径util/mongoutils/str.h是历史遗留命名早期工具函数位于mongoutils命名空间。在当前仓库中该头文件的实际位置是 src/mongo/util/str.h对应的命名空间为mongo::str即str::实现拆分为str.h内联函数与 str.cpp非内联实现。从源码结构看str.h的依赖链很轻它基于mongo/bson/util/builder.h的StringBuilder、mongo/util/ctype.h的字符分类工具并提供string_view/std::string两种现代 C 视图接口。头文件通过[[MONGO_MOD_PUBLIC]]标记对外导出str.h 第 36 行。2.str::stream()一行代码内联组装字符串文档中唯一给出的代码示例也是str库最常用、最值得推荐的工具uassert(12345, str::stream() bad ns: ns, isOk);这一行完成了三件事构造一个临时的str::stream对象通过连续运算符把字符串字面量、ns可以是任意可流式输出类型内联拼接将拼接结果隐式转换为std::string传给uassert作为错误消息。2.1 为什么要用它对比std::stringstreamstr::stream存在的根本动机在 str.h 第 41-51 行 的注释中写得很清楚——直接使用标准库时下面的写法无法编译// 下面这行无法工作(std::stringstream() 1).str(); (std::stringstream() 1).str();因为operator返回的是std::stringstream无法在临时对象上调用.str()。而str::stream通过隐式类型转换operator std::string()与operator std::string_view()让临时对象可以直接“变”成字符串从而把整个uassert/iassert/massert调用压成一行。2.2 实现剖析stream类的核心实现非常精简str.h 第 53-90 行class stream { public: StringBuilder ss; // 内部实际存储仍是 BSON 工具链的 StringBuilder template class T stream operator(const T v) { ss v; return *this; } operator std::string() const { return ss.str(); } operator std::string_view() const { return ss.stringData(); } friend std::ostream operator(std::ostream os, const stream s) { return os s.ss.stringData(); } ... };要点解读基于StringBuilder内部成员是一个StringBuilder ss来自 mongo/bson/util/builder.h所有最终都落到StringBuilder::operator因此 BSON 里可打印的各种类型如OID、BSONObj、Decimal128等都能直接拼进stream模板operator任意可被StringBuilder接受的类型都支持天然适配 MongoDB 的StringData/StringBuilder生态双隐式转换std::string与std::string_view两个转换运算符配合显式声明的std::ostream输出运算符解决了两者并存时的重载歧义str.h 第 68-73 行编译期防呆模板偏特化operator(R (*val)(Args...)) deletestr.h 第 80-81 行如果误传了一个未求值的函数名例如stream std::hex或忘了加()的someFunction会直接编译失败而不是静默退化为bool重载比较运算符提供了operatorstring_view与C20 三路比较支持stream与字符串直接比较。2.3 在断言体系中的典型用法str::stream()最常见的应用场景是配合 MongoDB 的断言宏生成错误消息。依据 docs/exception_architecture.md 的断言体系uassert用于“每次操作的用户级错误操作级致命”因此错误消息必须足够清晰// 校验命名空间是否合法 uassert(ErrorCodes::InvalidNamespace, str::stream() Invalid namespace: nss.toStringForErrorMsg(), nss.isValid()); // 多行拼接同样自然 iassert(ErrorCodes::BadValue, str::stream() Invalid value v for field fieldName, ok);类似的写法在整个仓库中被广泛采用——从 BSON 校验如 bsonelement.cpp、连接串解析如 mongo_uri.cpp到复制集心跳处理如 replica_set_monitor_manager.cpp大量模块都通过#include mongo/util/str.h引入该工具。3. 前缀与后缀判断startsWith/endsWithstartsWith(str, prefix)判断字符串是否以指定前缀开头支持const char*与std::string两种输入另有单字符重载str.h 第 92-113 行endsWith(str, suffix)判断是否以指定后缀结尾const char*版本内部使用strncmp并先比较长度防止越界str.h 第 115-132 行。if (str::startsWith(ns, admin.)) { ... } // 前缀判断 if (str::endsWith(filename, .wt)) { ... } // 后缀判断注意endsWith的单字符重载返回bool的同时会检查字符串非空len s[len - 1] p避免空串误判。4. 查找与截取after/before/contains这三组函数覆盖了“定位分隔符 取子串”的全部常见需求str.h 第 134-183 行函数语义未找到时的行为after(s, x)返回分隔符x字符或字符串之后的剩余部分返回空串before(s, x)返回分隔符x之前的部分返回整个字符串contains(s, x)判断s是否包含x字符或字符串—std::string_view host str::after(mongodb://host:27017, ://); // host:27017 std::string_view db str::before(admin.users, .); // admin if (str::contains(cmd, createIndexes)) { ... }实现细节字符版本的after用strchr字符串版本用strstrbefore的const char*重载刻意用循环代替strchrstr.h 第 167 行 注释说明这样在找不到时无需二次遍历。5. 公共前缀shareCommonPrefixint shareCommonPrefix(const char* p, const char* q);返回两个字符串共享公共前缀的长度str.h 第 185-202 行。返回值语义0表示完全没有公共前缀两串完全相同时返回其长度。这在比较 key、计算排序差异等场景中非常实用。6. 分割与拼接splitOn/rSplitOn/splitStringDelim/joinStringDelim/count6.1 只切一次的正向/反向分割splitOn与rSplitOn的设计刻意“只分割一次”str.h 第 217-246 行输出通过std::string_view出参返回返回值表示分隔符是否找到std::string_view before, after; if (str::splitOn(abc, , before, after)) { // before a, after bc只切第一处 } std::string_view l, r; str::rSplitOn(a.b.c, ., l, r); // l a.b, r c从右往左切第一处两者在分隔符缺失时行为一致before为整个输入、after为空串、返回false。6.2 全量分割与拼接需要全量分割时使用splitStringDelim反向操作用joinStringDelim声明位于 str.h 第 373-375 行实现在 str.cppstd::vectorstd::string parts; str::splitStringDelim(a,b,c, parts, ,); // parts {a, b, c} std::string joined; str::joinStringDelim({a, b, c}, joined, ,); // joined a,b,c6.3 统计出现次数count(s, c)返回字符c在字符串中出现的次数str.h 第 248-255 行unsigned dots str::count(a.b.c.d, .); // 37. 修剪与大小写ltrim/toLower/ 大小写不敏感比较ltrim(s)只去除空格不处理 tab 等空白符返回修剪后的string_viewstr.h 第 257-264 行。注意这是刻意的最小实现如需处理其他空白字符需自行扩展toLower(s)返回全小写拷贝逐个字符经ctype::toLower转换str.h 第 377-382 行caseInsensitiveCompare(s1, s2)大小写不敏感比较Windows 下用_stricmp其余平台用strcasecmpstr.h 第 357-363 行equalCaseInsensitive(a, b)编译期友好的 constexpr 比较内部逐字符ctype::toLower后比对。头文件注释明确提醒基于tolower的实现对某些语言如土耳其语处理不正确str.h 第 365-371 行使用时要考虑区域设置的影响。std::string_view clean str::ltrim( hello ); // hello std::string lower str::toLower(AbC); // abc if (str::equalCaseInsensitive(OK, ok)) { ... } if (str::caseInsensitiveCompare(a, b) 0) { ... }8. UTF-8 安全处理码点统计与安全截断这是str.h中处理国际化字符串最精细的一组工具str.h 第 266-355 行。它们基于 UTF-8 编码规律单字节码点形如0xxxxxxx多字节首字节形如11xxxxxx续字节形如10xxxxxx。函数语义isLeadingByte(char)是否为多字节码点的首字节isSingleByte(char)是否为单字节码点ASCIIgetCodePointLength(char)由首字节推断码点字节数利用前导 1 的个数isUTF8ContinuationByte(char)是否为续字节lengthInUTF8CodePoints(sv)统计 UTF-8 码点个数非字节数UTF8SafeTruncation(iter/begin, end, max)按字节上限截断并在最近的 UTF-8 码点边界对齐保证结果仍是合法 UTF-8std::string_view emoji a\xF0\x9F\x98\x80b; // ab size_t n str::lengthInUTF8CodePoints(emoji); // 3 个码点而非 5 字节 std::string_view cut str::UTF8SafeTruncation(emoji, 3); // 截到 3 字节边界 // 不会把多字节码点拦腰截断保证输出仍是合法 UTF-8UTF8SafeTruncation的实现先正向确定最大边界再从截断点反向寻找码点首字节、核对续字节数量str.h 第 318-350 行若该码点续字节缺失输入本身非法还会额外回退一步跳过坏码点。此外lengthInUTF8CodePoints对非法输入的行为是未定义的调用方需保证输入是合法 UTF-8。9. 数值转换toUnsigned/parseUnsignedBase10Integer/convertDoubleToString9.1toUnsigned宽松的非负整数解析toUnsignedstr.h 第 204-215 行逐个字符累加一旦遇到非数字字符即停止str::toUnsigned(123abc); // 123容忍尾部非数字 str::toUnsigned(abc); // 0开头非数字则整体为 0 str::toUnsigned(42); // 429.2parseUnsignedBase10Integer严格解析与toUnsigned的宽松不同parseUnsignedBase10Integerstr.h 第 409-414 行要求输入只能由十进制数字组成——不允许/-前缀、不允许首尾空白。解析成功返回boost::optionalsize_t失败返回boost::noneauto r1 str::parseUnsignedBase10Integer(123); // 123 auto r2 str::parseUnsignedBase10Integer(123); // boost::none auto r3 str::parseUnsignedBase10Integer( 12); // boost::none这一严格性在 str_test.cpp 中有完整覆盖包括PositivePrefixFailsToParse、NegativePrefixFailsToParse、TrailingLetterFailsToParse、LeadingLetterFailsToParse、LetterWithinNumberFailsToParse等用例。9.3convertDoubleToString可控精度的浮点转字符串std::string convertDoubleToString(double d, int prec 17);默认精度为 17——注释指出这是标准double能达到的最大十进制精度str.h 第 416-420 行需要更短表示时可显式传入prec。10. 排序比较器LexNumCmp——词法与数字混合排序LexNumCmpstr.h 第 384-401 行是字符串排序用的仿函数functor用于把“字典序”与“数字序”结合起来纯词法模式lexOnly true所有字符包括数字都按字典序比较混合模式默认/lexOnly false非数字字符按字典序比较数字子串按数值大小比较点号.分隔有序的可比子单元类似版本号语义约定字符 255 大于任何字符。str::LexNumCmp cmp(false); cmp(file2, file10); // 数字按数值比较2 10故 file2 在前 cmp(v1.2, v1.10); // 版本号式比较同样成立cmp静态方法LexNumCmp::cmp(s1, s2, lexOnly)可脱离实例直接使用。实现细节见 str.cpp测试覆盖见 str_test.cpp 中的 LexOnly 用例。11. 转义与编码辅助escape/_as_char_ptrescape(s, escape_slash false)转义字符串中的空白与控制字符例如制表符\t转义为字面文本\\t当escape_slash为true时/也会被转义为\\/str.h 第 403-407 行operator_as_char_ptrC20 下u8...前缀会产出新的char8_t类型而 MongoDB 大量接口以普通const char*打交道。该用户自定义字面量把char8_t*静默还原为const char*语义上是“编码已知、类型归位”str.h 第 424-445 行const auto testString u8..._as_char_ptr; // 得到 const char*12. 测试与验证str_test.cpp工具库的正确性由 src/mongo/util/str_test.cpp 全面守护测试组名均为StringUtilsTest覆盖基础组装Simple1/Simple2与stream的十六进制/零填充输出toUnsigned系列零值、双零值、整数、前导零、字母前后缀/夹心等边界parseUnsignedBase10Integer的严格解析拒绝路径LexNumCmp的词法/数字混合比较前缀/后缀判断、子串截取等基础语义。这些用例从正面与负面两个方向锁定了str库各 API 的精确语义是你在自己代码中使用这些函数时最权威的行为参照。13. 最佳实践小结字符串操作优先使用str库统一入口、语义清晰、避免各模块各自手写strchr/substr造成的行为差异。包含#include mongo/util/str.h即可使用命名空间mongo::str。构造错误消息优先str::stream()配合uassert/iassert/massert等断言宏一行内联完成“描述 拼接 传参”并自动享受StringBuilder对 BSON 类型的完整支持。注意函数语义的“宽松”与“严格”toUnsigned宽松容忍尾部字符parseUnsignedBase10Integer严格拒绝任何非十进制数字splitOn/rSplitOn只切一次需要全量分割时改用splitStringDelim。涉及多字节文本务必用 UTF-8 工具族字节数不等于码点数截断请用UTF8SafeTruncation保证合法 UTF-8 输出。大小写转换注意区域语言限制equalCaseInsensitive/toLower基于tolower对部分语言如土耳其语可能不正确国际化场景需额外评估。通过本文可以完整掌握 MongoDB 服务端 C 字符串处理的标准姿势str::stream()用于内联组装startsWith/endsWith/before/after/contains用于定位与截取splitOn/splitStringDelim/joinStringDelim用于分割拼接UTF-8 工具族与LexNumCmp、数值解析函数则覆盖了国际化与排序等进阶场景。【免费下载链接】mongoThe MongoDB Database项目地址: https://gitcode.com/GitHub_Trending/mo/mongo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考