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: {