TE_get_text_line
Example: TE_get_text_line | Text Retrieval Functions |
Reads the text from the designated line in the terminal emulator screen.
char *TE_get_text_line( int col, int row, int width, char *text );
Inputs
col, row | The column and row coordinates of the first character in the line to be read. |
width | The width of the text line to be read. If the width is less than 1, then the end of the line is assumed. |
Outputs
text | The string that was read from the screen. The string is null-terminated. Be careful to allocate a large enough buffer to accommodate the text. |
Note that for any output parameter, you can specify NULL if you do not need the value.
TE_get_text_line copies a line of text from the terminal screen to a buffer text. The first character in the line is defined by col, row. The column coordinate of the last character in the line is indicated by width. If the line contains tabs or spaces, the equivalent number of spaces is returned.
The terminal emulator screen is measured in characters. The character with position 1,1 is in the top left corner of the screen. If you set the width to less than 1, then the end of the line is assumed. For example, in order indicate that the function should read the text in the fifth row of the screen, you can specify
TE_get_text_line(1,5,-1, text);
Since the width parameter is set to -1, the function will read all text in the fifth row.
Return Values
This function returns a pointer to the buffer text. If the function fails, it returns null and sets TE_errno to an error code.
Parameterization
You cannot use standard parameterization for any arguments in this function.