ссылка на синтаксис регулярного выражения clang-format

Question

Я хочу, чтобы clang-format не изменял строки комментариев, которые я использую для разделения функций друг от друга. Я думаю, что commentPragmas подходит для этого, но я не могу найти информацию о формате регулярного выражения в стиле clang.

Я попытался commentPragmas: '^/\*-.*' захватить мои строки разделителей, которые выглядят как этот

/*------------------------------------------------------------------*/

Но выше регулярное выражение не работает ... Где я могу посмотреть синтаксис регулярных выражений для лязгом-формате?

Answer 1

TL/DR: Вкус POSIX ERE

---

Насколько я могу судить, регулярное выражение аромата не документированы в ClangFormat docs, это довольно бесполезно.

Давайте углубимся в исходный код, чтобы узнать.

Существует класс под названием ContinuationIndenter, в котором есть поле CommentPragmasRegex, типа ... llvm::Regexright here. Ну, это тоже не очень полезно, но, возможно, это просто обертка ...

Выбрано llvm::Regexis a wrapper вокруг ... llvm_regex. Заголовок включает в себя this comment:

Этот файл реализует контрольный символ регулярного выражения POSIX. Поддерживаются как Basic, так и Расширенные регулярные выражения POSIX (ERE). ERE были расширены для поддержки обратных ссылок в матчах. Эта реализация также поддерживает соответствующие строки со встроенными символами NUL.

В header that defines llvm_regex мы также можем найти этот комментарий:

Этот код является производным от OpenBSD в LibC/регулярное выражение