git.sur5r.net Git - i3/i3/blob - include/regex.h

   1 /*
   2  * vim:ts=4:sw=4:expandtab
   3  *
   4  * i3 - an improved dynamic tiling window manager
   5  * © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
   6  *
   7  * regex.c: Interface to libPCRE (perl compatible regular expressions).
   8  *
   9  */
  10 #pragma once
  11
  12 /**
  13  * Creates a new 'regex' struct containing the given pattern and a PCRE
  14  * compiled regular expression. Also, calls pcre_study because this regex will
  15  * most likely be used often (like for every new window and on every relevant
  16  * property change of existing windows).
  17  *
  18  * Returns NULL if the pattern could not be compiled into a regular expression
  19  * (and ELOGs an appropriate error message).
  20  *
  21  */
  22 struct regex *regex_new(const char *pattern);
  23
  24 /**
  25  * Frees the given regular expression. It must not be used afterwards!
  26  *
  27  */
  28 void regex_free(struct regex *regex);
  29
  30 /**
  31  * Checks if the given regular expression matches the given input and returns
  32  * true if it does. In either case, it logs the outcome using LOG(), so it will
  33  * be visible without debug logging.
  34  *
  35  */
  36 bool regex_matches(struct regex *regex, const char *input);