Method
VteTerminalmatch_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. |