Vte.Terminal.match_check_event

### Method

# Vte Terminalmatch_check_event

#### Declaration [src]

    char*
    vte_terminal_match_check_event (
      VteTerminal* terminal,
      GdkEvent* event,
      int* tag
    )

#### Description [src]

Checks if the text in and around the position of the event matches any of the regular expressions previously set using vte_terminal_match_add(). If a match exists, the text string is returned and if `tag` is not `NULL`, the number associated with the matched regular expression will be stored in `tag`.

If more than one regular expression has been set with vte_terminal_match_add(), then expressions are checked in the order in which they were added.

#### Parameters

`event`

  Type: `GdkEvent`

  A `GdkEvent`.

  The data is owned by the caller of the method.

`tag`

  Type: `int*`

  A location to store the tag, or `NULL`.

  The argument will be set by the function.
  The argument can be `NULL`.

#### Return value

Type: `char*`

A newly allocated string which matches one of the previously set regular expressions, or `NULL` if there is no match.

The caller of the method takes ownership of the data, and is responsible for freeing it.
The return value can be `NULL`.
The value is a NUL terminated UTF-8 string.