Method

VteTerminalcheck_hyperlink_at

since: 0.70

Declaration [src]

char*
vte_terminal_check_hyperlink_at (
  VteTerminal* terminal,
  double x,
  double y
)

Description [src]

Returns a nonempty string: the target of the explicit hyperlink (printed using the OSC 8 escape sequence) at the position (x, y), or NULL.

Proper use of the escape sequence should result in URI-encoded URIs with a proper scheme like “http://”, “https://”, “file://”, “mailto:” etc. This is, however, not enforced by VTE. The caller must tolerate the returned string potentially not being a valid URI.

Available since: 0.70

Parameters

x

Type: double

No description available.

y

Type: double

No description available.

Return value

Type: char*

A newly allocated string containing the target of the hyperlink, or NULL.

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