Method

VteTerminalmatch_check

Declaration [src]

char*
vte_terminal_match_check (
  VteTerminal* terminal,
  glong column,
  glong row,
  int* tag
)

Description [src]

Checks if the text in and around the specified position 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.

Deprecated since:0.46

Use vte_terminal_match_check_event() instead.

Parameters

column glong
 

The text column.

row glong
 

The text row.

tag int*
 

A location to store the tag, or NULL.

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

Return value

Returns: char*
 

A newly allocated string which matches one of the previously set regular expressions.

 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.