我需要帮助从 sprockets 解码这个正则表达式

Question

我需要帮助从 sprockets 中解码这个正则表达式。我不确定这匹配什么，但如果有人给我一些提示或起点。

HEADER_PATTERN = /
\A (
  (?m:\s*) (
   (\/\* (?m:.*?) \*\/) |
   (\#\#\# (?m:.*?) \#\#\#) |
   (\/\/ .* \n?)+ |
   (\# .* \n?)+
  )
 )+
/x

Answer 1

HEADER_PATTERN = /
\A (                             # Start of string
  (?m:\s*) (                     # Match optional whitespace
   (\/\* (?m:.*?) \*\/) |        # Either match /* (any characters, lazily) */
   (\#\#\# (?m:.*?) \#\#\#) |    # or ### (any characters, lazily) ###
   (\/\/ .* \n?)+ |              # or // (any characters except newlines) until optional newline (one or more)
   (\# .* \n?)+                  # or # (any characters except newlines) until optional newline (one or more)
  )
 )+                              # once or more
/x

(?m:...) 允许此子表达式中的点也匹配换行符，而通常不匹配。 （这是 Ruby 的专长；几乎所有其他正则表达式风格都使用 (?s:...)）

所以看起来这个正则表达式匹配文件/字符串开头的块 cmets 或行 cmets。

Answer 2

\A

定位到字符串的开头

(

启动一个包含整个字符串的组。它以 )+ 结尾，因此匹配 1 个或多个实例。

(?m:\s*)

为此原子打开多行标志，并匹配零个或多个“空格”字符（例如空格、垂直制表符、水平制表符、换行符或回车符）。我不知道他们为什么在这里打开多行标志，因为这不会影响 \s 转义。

(\/\* (?m:.*?) \*\/)

第一位\/ 匹配/ 字符（因为/ 是正则表达式的分隔符而被转义）。 \* 匹配 * 字符。由于 x 修饰符，可以忽略空格。然后它再次为.*? 打开多行标志，这使得. 匹配换行符。这里的? 使* 修饰符不贪婪，因此它匹配任何字符，但只与使其余模式匹配所需的字符一样少。然后是* 和/。换句话说，它匹配 C 风格的注释 (/* text */)

|

或

(\#\#\# (?m:.*?) \#\#\#)

匹配### 包围的任何文本，例如### something ###。再次使用带有. 的多行修饰符和非贪婪匹配，因此一旦### 匹配某些内容，它就会停止匹配。由于x 修饰符，# 字符被转义。

|

或

(\/\/ .* \n?)+

匹配//，后跟任意文本，后跟可选的换行符。我猜换行符是可选的，以防这是字符串的结尾。缺少多行修饰符使. 不匹配换行符。这基本上匹配 // 后跟任何内容，直到行尾。

|

或

(\# .* \n?)+

匹配#，后跟任意文本，后跟可选换行符。与前面的模式相同，但使用# 而不是//。请注意，较早的 ### 模式优先，因为它更早，所以如果文本匹配 ### 模式，它将不会被这个匹配。

最后，整个内容使用x 修饰符，因此空格、换行符和模式中# 之后的任何文本都将被忽略（这就是它跨多行编写的原因）。这只是为了便于阅读。