Method

TermboxTerminalprintf

Declaration

gboolean
tbg_terminal_printf (
  TbgTerminal* self,
  int x,
  int y,
  TbgAttr fg,
  TbgAttr bg,
  GError** error,
  const char* format,
  ...
)

Description

Format UTF-8 text and print it 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.

This varargs function is skipped in introspection. Bindings should use tbg_terminal_print().

This method is not directly available to language bindings.

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.

error

Type: GError

Return location for a GError, or NULL.

The argument will be set by the function.
The argument can be NULL.
The caller of the method takes ownership of the returned data, and is responsible for freeing it.
format

Type: const char*

Printf-style UTF-8 format string.

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

Type: 

Arguments for format.

Return value

Type: gboolean

TRUE on success, or FALSE with error set.