zsh-syntax-highlighting/highlighters/regexp
2018-02-11 09:58:00 -06:00
..
test-data regexp: Add test for subexpression match 2018-02-11 09:58:00 -06:00
README.md Add regexp highlighter 2017-12-09 16:17:22 -06:00
regexp-highlighter.zsh regexp: Add missing local for arrays match mbegin mend 2018-01-22 21:42:14 -06:00

zsh-syntax-highlighting / highlighters / regexp

This is the regexp highlighter, that highlights user-defined regular expressions. It's similar to the pattern highlighter, but allows more complex patterns.

How to tweak it

To use this highlighter, associate regular expressions with styles in the ZSH_HIGHLIGHT_REGEXP associative array, for example in ~/.zshrc:

  • GNU-Linux

    typeset -A ZSH_HIGHLIGHT_REGEXP
    ZSH_HIGHLIGHT_REGEXP+=('\<sudo\>' fg=123,bold)
    
  • BSD-based platforms

    typeset -A ZSH_HIGHLIGHT_REGEXP
    ZSH_HIGHLIGHT_REGEXP+=('[[:<:]]sudo[[:>:]]' fg=123,bold)
    

This will highlight "sudo" only as a complete word, i.e., "sudo cmd", but not "sudoedit".

As in the example, some regex patterns are platform-dependent. Refer to the manual page of re_format before applying regular expressions to avoid confusing results. If portability matters, using only POSIX ERE (extended regular expressions) could be an option.

The syntax for values is the same as the syntax of "types of highlighting" of the zsh builtin $zle_highlight array, which is documented in the zshzle(1) manual page.

See also: regular expressions tutorial, zsh regexp operator =~ in the zshmisc(1) manual page, GNU