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 |
GdkEvent* |
A |
|
The data is owned by the caller of the function. | |
tag |
int* |
A location to store the tag, or |
|
The argument will be set by the function. | |
The argument can be NULL . | |
The instance takes ownership of the data, and is responsible for freeing it. |
Return value
Returns: | char* |
A newly allocated string which matches one of the previously
set regular expressions, or |
|
The caller of the method takes ownership of the data, and is responsible for freeing it. | |
The return value can be NULL . | |
The string is a NUL terminated UTF-8 string. |