Interface RegexCompileFlags


public interface RegexCompileFlags
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    The pattern is forced to be "anchored", that is,
    it is constrained to match only at the first matching point in the
    string that is being searched.
    static final int
    Usually any newline character or character sequence
    is recognised.
    static final int
    Letters in the pattern match both upper- and
    lowercase letters.
    static final int
    No special options set.
    static final int
    A dollar metacharacter ("$") in the pattern
    matches only at the end of the string.
    static final int
    A dot metacharacter (".") in the pattern matches all
    characters, including newlines.
    static final int
    Names used to identify capturing subpatterns need not
    be unique.
    static final int
    Whitespace data characters in the pattern are
    totally ignored except when escaped or inside a character class.
    static final int
    Limits an unanchored pattern to match before (or at) the
    first newline.
    static final int
    Changes behaviour so that it is compatible with
    JavaScript rather than PCRE.
    static final int
    By default, GRegex treats the strings as consisting
    of a single line of characters (even if it actually contains
    newlines).
    static final int
    Usually any newline character or character sequence
    is recognized.
    static final int
    Usually any newline character or character sequence is
    recognized.
    static final int
    Usually any newline character or character sequence is
    recognized.
    static final int
    Usually any newline character or character sequence is
    recognized.
    static final int
    Disables the use of numbered capturing
    parentheses in the pattern.
    static final int
    Since 2.74 and the port to pcre2, requests JIT
    compilation, which, if the just-in-time compiler is available, further
    processes a compiled pattern into machine code that executes much
    faster.
    static final int
    Usually strings must be valid UTF-8 strings, using this
    flag they are considered as a raw sequence of bytes.
    static final int
    Inverts the "greediness" of the quantifiers so that
    they are not greedy by default, but become greedy if followed by "?
  • Field Details

    • DEFAULT

      static final int DEFAULT
      No special options set. Since: 2.74
      See Also:
    • CASELESS

      static final int CASELESS
      Letters in the pattern match both upper- and
      lowercase letters. This option can be changed within a pattern
      by a "(?i)" option setting.
      See Also:
    • MULTILINE

      static final int MULTILINE
      By default, GRegex treats the strings as consisting
      of a single line of characters (even if it actually contains
      newlines). The "start of line" metacharacter ("^") matches only
      at the start of the string, while the "end of line" metacharacter
      ("$") matches only at the end of the string, or before a terminating
      newline (unless %G_REGEX_DOLLAR_ENDONLY is set). When
      %G_REGEX_MULTILINE is set, the "start of line" and "end of line"
      constructs match immediately following or immediately before any
      newline in the string, respectively, as well as at the very start
      and end. This can be changed within a pattern by a "(?m)" option
      setting.
      See Also:
    • DOTALL

      static final int DOTALL
      A dot metacharacter (".") in the pattern matches all
      characters, including newlines. Without it, newlines are excluded.
      This option can be changed within a pattern by a ("?s") option setting.
      See Also:
    • EXTENDED

      static final int EXTENDED
      Whitespace data characters in the pattern are
      totally ignored except when escaped or inside a character class.
      Whitespace does not include the VT character (code 11). In addition,
      characters between an unescaped "#" outside a character class and
      the next newline character, inclusive, are also ignored. This can
      be changed within a pattern by a "(?x)" option setting.
      See Also:
    • ANCHORED

      static final int ANCHORED
      The pattern is forced to be "anchored", that is,
      it is constrained to match only at the first matching point in the
      string that is being searched. This effect can also be achieved by
      appropriate constructs in the pattern itself such as the "^"
      metacharacter.
      See Also:
    • DOLLAR_ENDONLY

      static final int DOLLAR_ENDONLY
      A dollar metacharacter ("$") in the pattern
      matches only at the end of the string. Without this option, a
      dollar also matches immediately before the final character if
      it is a newline (but not before any other newlines). This option
      is ignored if %G_REGEX_MULTILINE is set.
      See Also:
    • UNGREEDY

      static final int UNGREEDY
      Inverts the "greediness" of the quantifiers so that
      they are not greedy by default, but become greedy if followed by "?".
      It can also be set by a "(?U)" option setting within the pattern.
      See Also:
    • RAW

      static final int RAW
      Usually strings must be valid UTF-8 strings, using this
      flag they are considered as a raw sequence of bytes.
      See Also:
    • NO_AUTO_CAPTURE

      static final int NO_AUTO_CAPTURE
      Disables the use of numbered capturing
      parentheses in the pattern. Any opening parenthesis that is not
      followed by "?" behaves as if it were followed by "?:" but named
      parentheses can still be used for capturing (and they acquire numbers
      in the usual way).
      See Also:
    • OPTIMIZE

      static final int OPTIMIZE
      Since 2.74 and the port to pcre2, requests JIT
      compilation, which, if the just-in-time compiler is available, further
      processes a compiled pattern into machine code that executes much
      faster. However, it comes at the cost of extra processing before the
      match is performed, so it is most beneficial to use this when the same
      compiled pattern is used for matching many times. Before 2.74 this
      option used the built-in non-JIT optimizations in pcre1.
      See Also:
    • FIRSTLINE

      static final int FIRSTLINE
      Limits an unanchored pattern to match before (or at) the
      first newline. Since: 2.34
      See Also:
    • DUPNAMES

      static final int DUPNAMES
      Names used to identify capturing subpatterns need not
      be unique. This can be helpful for certain types of pattern when it
      is known that only one instance of the named subpattern can ever be
      matched.
      See Also:
    • NEWLINE_CR

      static final int NEWLINE_CR
      Usually any newline character or character sequence is
      recognized. If this option is set, the only recognized newline character
      is '\r'.
      See Also:
    • NEWLINE_LF

      static final int NEWLINE_LF
      Usually any newline character or character sequence is
      recognized. If this option is set, the only recognized newline character
      is '\n'.
      See Also:
    • NEWLINE_CRLF

      static final int NEWLINE_CRLF
      Usually any newline character or character sequence is
      recognized. If this option is set, the only recognized newline character
      sequence is '\r\n'.
      See Also:
    • NEWLINE_ANYCRLF

      static final int NEWLINE_ANYCRLF
      Usually any newline character or character sequence
      is recognized. If this option is set, the only recognized newline character
      sequences are '\r', '\n', and '\r\n'. Since: 2.34
      See Also:
    • BSR_ANYCRLF

      static final int BSR_ANYCRLF
      Usually any newline character or character sequence
      is recognised. If this option is set, then "\R" only recognizes the newline
      characters '\r', '\n' and '\r\n'. Since: 2.34
      See Also:
    • JAVASCRIPT_COMPAT

      static final int JAVASCRIPT_COMPAT
      Changes behaviour so that it is compatible with
      JavaScript rather than PCRE. Since GLib 2.74 this is no longer supported,
      as libpcre2 does not support it. Since: 2.34 Deprecated: 2.74
      See Also: