Method

TermboxTerminalprint

Declaration

gboolean
tbg_terminal_print (
  TbgTerminal* self,
  int x,
  int y,
  TbgAttr fg,
  TbgAttr bg,
  const char* str,
  GError** error
)

Description

Print UTF-8 text into the internal back buffer.

Non-printable characters and truncated UTF-8 byte sequences are replaced with U+FFFD. Newlines are supported and move output to the next row.

If the starting coordinate is out of bounds, an error is returned. If the starting coordinate is in bounds but the text extends out of bounds, the out-of-bounds part is ignored.

Parameters

x

Type: int

X coordinate of the first cell.

y

Type: int

Y coordinate of the first cell.

fg

Type: TbgAttr

Foreground attribute.

bg

Type: TbgAttr

Background attribute.

str

Type: const char*

UTF-8 text to print.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will be left initialized to NULL by the method if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: gboolean

TRUE on success, or FALSE with error set.