Quassel IRC

h1. Pattern matching

*WORK IN PROGRESS*

{{toc}}

h2. Upgrade notice

*This changed in Quassel @0.13@.  "Follow the migration guide":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Migrating-from-versions-prior-to-013 if you're upgrading from an earlier version.*

When using the client and core with different versions, some ignore rules will be processed differently.

h2. Breakdown of usage

Quassel supports several types of pattern matching for ignore and highlight rules.

h3. Ignore Rules

|_. @Regular expression@ |_. Item |_. Pattern matching type |

| Unchecked | @Ignore Rule@ | "Wildcard":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Wildcard |

| Unchecked | @Scope@ | "Multiple wildcard":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Multiple-wildcard |

| Checked | @Ignore Rule@ | "Regular expression":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Regular-expression |

| Checked | @Scope@ | "Multiple wildcard":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Multiple-wildcard |

_For backwards compatibility, the @Regular expression@ checkbox only affects @Ignore Rule@ and not @Scope@._

h3. Highlight Rules

|_. @RegEx@ |_. Item |_. Pattern matching type |

| Unchecked | @Rule@ | "Phrase":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Wildcard |

| Unchecked | @Sender@ | "Multiple wildcard":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Multiple-wildcard |

| Unchecked | @Channel@ | "Multiple wildcard":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Multiple-wildcard |

| Checked | @Rule@ | "Regular expression":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Regular-expression |

| Checked | @Sender@ | "Regular expression":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Regular-expression |

| Checked | @Channel@ | "Regular expression":https://bugs.quassel-irc.org/projects/quassel-irc/wiki/Pattern_matching#Regular-expression |

_This applies to both @Local Highlights@ and @Remote Highlights@ (or if using Monolithic, @Legacy Highlights@ and @Highlights@)._

h2. Types

h3. Phrase

This matches exactly what you type.

<pre>

word

</pre>

* Matches

** @word@

** @A word.@

** @has a word in it@ 

* Does not match

** @wording@

_Changed in Quassel @0.13@:_

Spaces are matched, too, allowing you to be more specific.

<pre>

 spaced

</pre>

_There's a leading space in the example above._

* Matches

** @, spaced@

** @is spaced out@

* Does not match

** @;spaced@

h3. Wildcard

_Changed in Quassel @0.13@:_

This uses simple wildcard substitution with @*@ and @?@ to match any characters or a single character, respectively.

<pre>

*Asking questions\?  Nope?

</pre>

* Matches

** @Asking questions? Nopea@

** @Basking questions? Nope.@

* Does not match

** @Asking questions. Nope.@

** @Asking questions? Nopes.@

Implicit wildcard is supported, too, allowing you to match everything *except* for what you specify.

<pre>

!*filter*

</pre>

* Matches

** _Everything, unless it contains something from the below list_

* Does not match

** @filter@

** @filtering@

** @#nofilter yo@

Exclamation points can be escaped at the beginning to match something that starts with @!@ (_this is not required elsewhere_).

<pre>

\!*filter*

</pre>

* Matches

** @!filter@

** @!yes filtering@

* Does not match

** @filter@

The @\@ character can be escaped, too, in case you're matching something that starts with @\!@.

<pre>

\\!*filter*

</pre>

* Matches

** @\!filter@

** @\!yes filtering@

* Does not match

** @filter@

** @!filter@

h3. Multiple wildcard

h3. Regular expression

TODO

h2. Migrating from versions prior to @0.13@

Quassel @0.13@ introduced new behavior for pattern matching to provide more flexibility and to improve performance.

h3. Ignore Rules

h3. Highlight Rules

h2. Technical details

For all the technical details and source code changes, take a look at "Quassel pull request #415":https://github.com/quassel/quassel/pull/415 .  @MultiPhrase@ is not covered here as Quassel only uses it internally for nickname matching.