MongoDB聚合运算符：$replaceOne

MongoDB聚合运算符：$replaceOne

$replaceOne聚合运算在输入的字符串中搜索目标字符串，并使用指定的字符串替换第一次找到的目标字符串。如果没有找到目标字符串，则返回输入字符串。 $replaceOne既区分大小写又区分变音符号，并且忽略集合中存在的任何排序规则。

语法

{
   
    $replaceOne: {
   
    input: <expression>, find: <expression>, replacement: <expression> } }

参数字段说明

• input：输入的字符串，可以是任何可被解析为字符串的表达式，如果表达式解析为null或引用的字段不存在，$replaceOne返回null。
• find：要搜索的字符串，可以是任何可被解析为字符串的表达式，如果表达式解析为null或引用的字段不存在，$replaceOne返回null。
• replacement：要替换的的字符串，可以是任何可被解析为字符串或null的表达式。

使用

如果在input中未找到 find，则 $replaceOne 计算结果为input字符串。

输入、查找和替换表达式的计算结果必须为字符串或 null，否则 $replaceOne 会失败并出现错误。

$replaceOne 与 Null

如果 input 或 find 引用的字段字段不存在，则返回 null。

如果 input、find 或 replacement 中的任何一个计算结果为 null，则整个 $replaceOne 表达式计算结果为 null：

例如	结果
{ $replaceOne: { input: null, find: "abc", replacement: "ABC" } }	null
{ $replaceOne: { input: "abc", find: null, replacement: "ABC" } }	null
{ $replaceOne: { input: "abc", find: "abc", replacement: null } }	null

$replaceOne 和排序规则

所有 $replaceOne 表达式的字符串匹配始终区分大小写和变音符号，使用 $replaceOne 执行字符串比较时，将忽略配置的任何排序规则。

例如，创建一个排序规则强度为 1 的示例集合：

db.createCollection( "myColl", {
   
    collation: {
   
    locale: <