get_text_range
Description:
Extracts a view of the visible part of the terminal.
The entire scrollback buffer is scanned, so it is possible to read the entire contents of the buffer using this function.
This method is unaware of BiDi. The columns passed in start_col
and end_row
, and returned in attributes
are logical columns.
Since 0.68, passing a non-%NULL array
parameter is deprecated. Since 0.72, passing a non-%NULL array
parameter will
make this function itself return null
. Since 0.72, passing a non-%NULL is_selected
function will make this function
itself return null
.
Parameters:
this |
a Terminal |
start_row |
first row to search for data |
start_col |
first column to search for data |
end_row |
last row to search for data |
end_col |
last column to search for data |
is_selected |
a SelectionFunc callback. Deprecated: 0.44: Always pass |
attributes |
location for storing text attributes. Deprecated: 0.68: Always pass |
user_data |
user data to be passed to the callback |
Returns:
a newly allocated text string, or |