Method
TermboxTerminalprintf_ex
Declaration
gboolean
tbg_terminal_printf_ex (
TbgTerminal* self,
int x,
int y,
TbgAttr fg,
TbgAttr bg,
gsize* out_width,
GError** error,
const char* format,
...
)
Description
Format UTF-8 text, print it into the internal back buffer, and optionally return its display width.
Non-printable characters and truncated UTF-8 byte sequences are replaced with U+FFFD. Newlines are supported and move output to the next row;
out_width is the width the string would occupy on a single line.
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_ex().
This method is not directly available to language bindings.
Parameters
x-
Type:
intX coordinate of the first cell.
y-
Type:
intY coordinate of the first cell.
fg-
Type:
TbgAttrForeground attribute.
bg-
Type:
TbgAttrBackground attribute.
out_width-
Type:
gsize*Return location for printed cell width, or
NULL.The argument will be set by the function. The argument can be NULL. error-
Type:
GErrorReturn location for a
GError, orNULL.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.