output.h File Reference

Go to the source code of this file.

Typedefs
typedef asciichat_error_t(*	ui_output_write_fn) (int fd, const char *data, size_t length)

Functions
void	ui_output_set_writer (ui_output_write_fn writer)
asciichat_error_t	ui_output_write (int fd, const char *data, size_t length)
asciichat_error_t	ui_output_printf (int fd, const char *format,...)

Typedef Documentation

ui_output_write_fn

typedef asciichat_error_t(* ui_output_write_fn) (int fd, const char *data, size_t length)

Definition at line 4 of file output.h.

Function Documentation

ui_output_printf()

asciichat_error_t ui_output_printf	(	int	fd,
		const char *	format,
			... )

Definition at line 26 of file output.c.

                                                                    {
  if (!format)
    return SET_ERRNO(ERROR_INVALID_PARAM, "UI output format is NULL");
  char text[UI_OUTPUT_TEXT_BUFFER_SIZE];
  va_list args;
  va_start(args, format);
  int n = vsnprintf(text, sizeof(text), format, args);
  va_end(args);
  if (n < 0 || (size_t)n >= sizeof(text))
    return SET_ERRNO(ERROR_BUFFER_OVERFLOW, "UI formatted output exceeds capacity");
  return ui_output_write(fd, text, (size_t)n);
}

References args, ERROR_BUFFER_OVERFLOW, ERROR_INVALID_PARAM, SET_ERRNO, UI_OUTPUT_TEXT_BUFFER_SIZE, and ui_output_write().

Referenced by fps_counter_render().

ui_output_set_writer()

void ui_output_set_writer

(

ui_output_write_fn

writer

)

The presenter installs a sink; standalone widgets use platform output.

Definition at line 13 of file output.c.

                                                     {
  atomic_ptr_store(&g_writer, (void *)writer);
}

ui_output_write()

asciichat_error_t ui_output_write	(	int	fd,
		const char *	data,
		size_t	length )

Definition at line 16 of file output.c.

                                                                           {
  if (fd < 0 || (!data && length))
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid UI output descriptor or text");
  ui_output_write_fn writer = (ui_output_write_fn)atomic_ptr_load(&g_writer);
  if (writer)
    return writer(fd, data, length);
  return platform_write_all(fd, data, length) == length
             ? ASCIICHAT_OK
             : SET_ERRNO_SYS(ERROR_FILE_OPERATION, "Cannot write complete UI output");
}

References ASCIICHAT_OK, ERROR_FILE_OPERATION, ERROR_INVALID_PARAM, platform_write_all(), SET_ERRNO, and SET_ERRNO_SYS.

Referenced by frame_buffer_flush(), and ui_output_printf().