$ regexMatch（汇总）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 聚合管道运营商 > $ regexMatch（汇总）

在本页面

定义
句法
行为
例子

定义¶

$regexMatch¶

4.2版中的新功能。

执行正则表达式（regex）模式匹配并返回：

true 如果存在匹配项。
false 如果不存在匹配项。

MongoDB使用支持UTF-8的Perl兼容正则表达式（即“ PCRE”）版本8.41。

在MongoDB 4.2之前，聚合管道只能$regex在$match阶段中使用查询运算符。有关在查询中使用正则表达式的更多信息，请参见$regex。

语法¶

该$regexMatch操作的语法如下：

复制

{ $regexMatch: { input: <expression> , regex: <expression>, options: <expression> } }

领域描述

输入

您希望在其上应用正则表达式模式的字符串。可以是字符串或任何可解析为字符串的有效表达式。

正则表达式

要应用的正则表达式模式。可以是任何可解析为字符串或正则表达式模式的有效表达式/<pattern>/。使用regex时/<patthern>/，还可以指定regex选项i和m（但不能指定 sor x选项）：

"pattern"
/<pattern>/
/<pattern>/<options>

另外，您也可以在options字段中指定正则表达式选项。要指定s或x选项，必须使用options字段。

您不能在regex和options 字段中同时指定选项。

选项

可选的。以下内容<options>可用于正则表达式。

注意

您不能在regex和 options字段中同时指定选项。

选项	描述
`i`	不区分大小写以匹配大小写。您可以在`options`字段中或正则表达式字段中指定选项。
`m`	对于包含锚点的模式（即`^`开始， `$`结束），请在每行的开头或结尾匹配具有多行值的字符串。如果没有此选项，这些锚点将在字符串的开头或结尾匹配。如果模式不包含锚点，或者字符串值不包含换行符（例如`\n`），则该`m`选项无效。
`x`	“扩展”功能可以忽略模式中的所有空白字符，除非转义或包含在字符类中。此外，它会忽略中间的字符，包括未转义的井号/磅（`#`）字符和下一个新行，因此您可以在复杂模式中添加注释。这仅适用于数据字符；空格字符永远不会出现在图案的特殊字符序列中。该`x`选项不影响VT字符（即代码11）的处理。您只能在`options`字段中指定选项。
`s`	允许点字符（即`.`）匹配所有字符，包括换行符。您只能在`options`字段中指定选项。

返回¶

运算符返回一个布尔值：

true 如果存在匹配项。
false 如果不存在匹配项。

也可以看看

行为¶

`$regexMatch`和排序规则¶

$regexMatch忽略为collection指定的归类db.collection.aggregate()和索引（如果使用）。

例如，创建一个具有整理强度的样本集合 1（即仅比较基本字符而忽略其他区别，例如大小写和变音符号）：

复制

db.createCollection( "myColl", { collation: { locale: "fr", strength: 1 } } )

插入以下文件：

复制

db.myColl.insertMany([
   { _id: 1, category: "café" },
   { _id: 2, category: "cafe" },
   { _id: 3, category: "cafE" }
])

使用集合的排序规则，以下操作将执行不区分大小写和不区分音素的匹配：

复制

db.myColl.aggregate( [ { $match: { category: "cafe" } } ] )

该操作返回以下3个文档：

复制

{ "_id" : 1, "category" : "café" }
{ "_id" : 2, "category" : "cafe" }
{ "_id" : 3, "category" : "cafE" }

但是，聚合表达式会$regexMatch忽略排序规则；也就是说，以下正则表达式模式匹配示例区分大小写和变音符号：

复制

db.myColl.aggregate( [ { $addFields: { results: { $regexMatch: { input: "$category", regex: /cafe/ }  } } } ] )
db.myColl.aggregate(
   [ { $addFields: { results: { $regexMatch: { input: "$category", regex: /cafe/ }  } } } ],
   { collation: { locale: "fr", strength: 1 } }       // Ignored in the $regexMatch
)

这两个操作都返回以下内容：

复制

{ "_id" : 1, "category" : "café", "results" : false }
{ "_id" : 2, "category" : "cafe", "results" : true }
{ "_id" : 3, "category" : "cafE", "results" : false }

要执行不区分大小写的正则表达式模式匹配，请改用 i Option。有关示例，请参见 i选项。

例子¶

`$regexMatch`及其选项¶

为了说明$regexMatch此示例中讨论的操作员的行为，请products使用以下文档创建样本集合：

复制

db.products.insertMany([
   { _id: 1, description: "Single LINE description." },
   { _id: 2, description: "First lines\nsecond line" },
   { _id: 3, description: "Many spaces before     line" },
   { _id: 4, description: "Multiple\nline descriptions" },
   { _id: 5, description: "anchors, links and hyperlinks" },
   { _id: 6, description: "métier work vocation" }
])

默认情况下，$regexMatch执行区分大小写的匹配。例如，以下聚合在字段上区分大小写 。正则表达式模式不指定任何分组：$regexMatchdescription/line/

复制

db.products.aggregate([
   { $addFields: { result: { $regexMatch: { input: "$description", regex: /line/ } } } }
])

该操作返回以下内容：

{ "_id" : 1, "description" : "Single LINE description.", "result" : false }
{ "_id" : 2, "description" : "First lines\nsecond line", "result" : true }
{ "_id" : 3, "description" : "Many spaces before     line", "result" : true }
{ "_id" : 4, "description" : "Multiple\nline descriptions", "result" : true }
{ "_id" : 5, "description" : "anchors, links and hyperlinks", "result" : false }
{ "_id" : 6, "description" : "métier work vocation", "result" : false }

以下正则表达式模式在模式中/lin(e|k)/指定了一个分组 (e|k)：

复制

db.products.aggregate([
   { $addFields: { result: { $regexMatch: { input: "$description", regex: /lin(e|k)/ } } } }
])

该操作返回以下内容：

{ "_id" : 1, "description" : "Single LINE description.", "result" : false }
{ "_id" : 2, "description" : "First lines\nsecond line", "result" : true }
{ "_id" : 3, "description" : "Many spaces before     line", "result" : true }
{ "_id" : 4, "description" : "Multiple\nline descriptions", "result" : true }
{ "_id" : 5, "description" : "anchors, links and hyperlinks", "result" : true }
{ "_id" : 6, "description" : "métier work vocation", "result" : false }

`i`选项¶

注意

您不能在regex和 options字段中同时指定选项。

要执行不区分大小写的模式匹配，请在正则表达式字段或选项字段中包括i选项：

// Specify i as part of the regex field
{ $regexMatch: { input: "$description", regex: /line/i } }

// Specify i in the options field
{ $regexMatch: { input: "$description", regex: /line/, options: "i" } }
{ $regexMatch: { input: "$description", regex: "line", options: "i" } }

例如，以下聚合对字段执行不区分大小写 $regexMatch的操作description。正则表达式模式/line/不指定任何分组：

复制

db.products.aggregate([
   { $addFields: { result: { $regexMatch: { input: "$description", regex: /line/i } } } }
])

该操作返回以下文档：

{ "_id" : 1, "description" : "Single LINE description.", "result" : true }
{ "_id" : 2, "description" : "First lines\nsecond line", "result" : true }
{ "_id" : 3, "description" : "Many spaces before     line", "result" : true }
{ "_id" : 4, "description" : "Multiple\nline descriptions", "result" : true }
{ "_id" : 5, "description" : "anchors, links and hyperlinks", "result" : false }
{ "_id" : 6, "description" : "métier work vocation", "result" : false }

`m`选项¶

注意

您不能在regex和 options字段中同时指定选项。

以匹配指定的锚定件（例如^，$用于多行字符串的每一行），包括米选项作为的一部分的正则表达式字段或选项字段：

// Specify m as part of the regex field
{ $regexMatch: { input: "$description", regex: /line/m } }

// Specify m in the options field
{ $regexMatch: { input: "$description", regex: /line/, options: "m" } }
{ $regexMatch: { input: "$description", regex: "line", options: "m" } }

以下示例同时包含i和m选项，以匹配以字母s或多S行字符串开头的行：

复制

db.products.aggregate([
   { $addFields: { result: { $regexMatch: { input: "$description", regex: /^s/im } } } }
])

该操作返回以下内容：

{ "_id" : 1, "description" : "Single LINE description.", "result" : true }
{ "_id" : 2, "description" : "First lines\nsecond line", "result" : true }
{ "_id" : 3, "description" : "Many spaces before     line", "result" : false }
{ "_id" : 4, "description" : "Multiple\nline descriptions", "result" : false }
{ "_id" : 5, "description" : "anchors, links and hyperlinks", "result" : false }
{ "_id" : 6, "description" : "métier work vocation", "result" : false }

`x`选项¶

注意

您不能在regex和 options字段中同时指定选项。

要忽略模式中所有未转义的空格字符和注释（由未转义的哈希#字符和下一个换行符表示），请在options字段中包含s选项：

// Specify x in the options field
{ $regexMatch: { input: "$description", regex: /line/, options: "x" } }
{ $regexMatch: { input: "$description", regex: "line", options: "x" } }

以下示例包括x跳过未转义的空白和注释的选项：

复制

db.products.aggregate([
   { $addFields: { returns: { $regexMatch: { input: "$description", regex: /lin(e|k) # matches line or link/, options:"x" } } } }
])

该操作返回以下内容：

{ "_id" : 1, "description" : "Single LINE description.", "returns" : false }
{ "_id" : 2, "description" : "First lines\nsecond line", "returns" : true }
{ "_id" : 3, "description" : "Many spaces before     line", "returns" : true }
{ "_id" : 4, "description" : "Multiple\nline descriptions", "returns" : true }
{ "_id" : 5, "description" : "anchors, links and hyperlinks", "returns" : true }
{ "_id" : 6, "description" : "métier work vocation", "returns" : false }

`s`选项¶

注意

您不能在regex和 options字段中同时指定选项。

要允许模式中的点字符（即.）与所有字符（包括换行符）匹配，请在选项字段中包含s选项：

// Specify s in the options field
{ $regexMatch: { input: "$description", regex: /m.*line/, options: "s" } }
{ $regexMatch: { input: "$description", regex: "m.*line", options: "s" } }

以下示例包括s允许点字符（即。）匹配所有字符（包括换行符）的i选项，以及执行不区分大小写的匹配的选项：

复制

db.products.aggregate([
   { $addFields: { returns: { $regexMatch: { input: "$description", regex:/m.*line/, options: "si"  } } } }
])

该操作返回以下内容：

{ "_id" : 1, "description" : "Single LINE description.", "returns" : false }
{ "_id" : 2, "description" : "First lines\nsecond line", "returns" : false }
{ "_id" : 3, "description" : "Many spaces before     line", "returns" : true }
{ "_id" : 4, "description" : "Multiple\nline descriptions", "returns" : true }
{ "_id" : 5, "description" : "anchors, links and hyperlinks", "returns" : false }
{ "_id" : 6, "description" : "métier work vocation", "returns" : false }

使用`$regexMatch`检查电子邮件地址¶

feedback使用以下文档创建样本集合：

复制

db.feedback.insertMany([
   { "_id" : 1, comment: "Hi, I'm just reading about MongoDB -- aunt.arc.tica@example.com"  },
   { "_id" : 2, comment: "I wanted to concatenate a string" },
   { "_id" : 3, comment: "How do I convert a date to string? Contact me at either cam@mongodb.com or c.dia@mongodb.com" },
   { "_id" : 4, comment: "It's just me. I'm testing.  fred@MongoDB.com" }
])

以下汇总使用$regexMatch来检查该comment字段是否包含带有的电子邮件地址， @mongodb.com并将反馈分类为Employee或 External。

复制

db.feedback.aggregate( [
    { $addFields: {
       "category": { $cond: { if:  { $regexMatch: { input: "$comment", regex: /[a-z0-9_.+-]+@mongodb.com/i } },
                              then: "Employee",
                              else: "External" } }
    } },

该操作返回以下文档：

MongoDB 中文手册

$ regexMatch（汇总）

定义¶

语法¶

返回¶

行为¶

$regexMatch和排序规则¶

例子¶

$regexMatch及其选项¶

i选项¶

m选项¶

x选项¶

s选项¶

使用$regexMatch检查电子邮件地址¶

`$regexMatch`和排序规则¶

`$regexMatch`及其选项¶

`i`选项¶

`m`选项¶

`x`选项¶

`s`选项¶

使用`$regexMatch`检查电子邮件地址¶