writer.c File Reference

Write ANSI ASCII frames to file descriptor. More...

Go to the source code of this file.

Data Structures
struct	terminal_fd_writer_s

Typedefs
typedef struct terminal_fd_writer_s	terminal_fd_writer_t

Functions
asciichat_error_t	terminal_fd_writer_create (int fd, terminal_fd_writer_t **out)
	Create a terminal FD writer to a file descriptor.
asciichat_error_t	terminal_fd_writer_write (terminal_fd_writer_t *writer, const char *frame)
	Write a frame to the file descriptor.
void	terminal_fd_writer_destroy (terminal_fd_writer_t *writer)
	Destroy terminal FD writer.

Detailed Description

Write ANSI ASCII frames to file descriptor.

Definition in file writer.c.

Typedef Documentation

terminal_fd_writer_t

typedef struct terminal_fd_writer_s terminal_fd_writer_t

Function Documentation

terminal_fd_writer_create()

asciichat_error_t terminal_fd_writer_create	(	int	fd,
		terminal_fd_writer_t **	out
	)

Create a terminal FD writer to a file descriptor.

Parameters

fd	File descriptor to write to (e.g., STDOUT_FILENO, open file)
out	Pointer to store writer context

Returns

ASCIICHAT_OK on success

Definition at line 19 of file writer.c.

                                                                                {
  if (fd < 0) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid fd: %d", fd);
  }
 
  FILE *fp = platform_fdopen("terminal_fd_writer", fd, "w");
  if (!fp) {
    return SET_ERRNO_SYS(ERROR_INVALID_PARAM, "fdopen failed for FD %d", fd);
  }
 
  terminal_fd_writer_t *writer = SAFE_CALLOC(1, sizeof(*writer), terminal_fd_writer_t *);
  writer->fp = fp;
 
  log_debug("terminal_fd_writer: created with fd=%d", fd);
  *out = writer;
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK, ERROR_INVALID_PARAM, terminal_fd_writer_s::fp, log_debug, platform_fdopen(), SAFE_CALLOC, SET_ERRNO, and SET_ERRNO_SYS.

terminal_fd_writer_destroy()

void terminal_fd_writer_destroy

(

terminal_fd_writer_t *

writer

)

Destroy terminal FD writer.

Parameters

writer

Writer context to destroy

Definition at line 62 of file writer.c.

                                                              {
  if (!writer)
    return;
  if (writer->fp) {
    fclose(writer->fp);
    writer->fp = NULL;
  }
  SAFE_FREE(writer);
}

References terminal_fd_writer_s::fp, and SAFE_FREE.

terminal_fd_writer_write()

asciichat_error_t terminal_fd_writer_write	(	terminal_fd_writer_t *	writer,
		const char *	frame
	)

Write a frame to the file descriptor.

Writes the frame data followed by a newline. Frame should contain ANSI-colored ASCII art, typically from rendering output.

Parameters

writer	Writer context
frame	Frame data to write (NULL is no-op)

Returns

ASCIICHAT_OK on success

Definition at line 37 of file writer.c.

                                                                                            {
  if (!writer) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid writer context");
  }
 
  if (!frame) {
    return ASCIICHAT_OK; // No-op for NULL frame
  }
 
  // Write frame and newline
  int ret = fprintf(writer->fp, "%s\n", frame);
  if (ret < 0) {
    return SET_ERRNO_SYS(ERROR_INVALID_PARAM, "fprintf failed");
  }
 
  // Flush to ensure output is visible immediately
  int flush_ret = fflush(writer->fp);
  if (flush_ret != 0) {
    return SET_ERRNO_SYS(ERROR_INVALID_PARAM, "fflush failed");
  }
 
  log_debug_every(NS_PER_SEC_INT, "terminal_fd_writer: wrote frame (%zu bytes)", strlen(frame));
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK, ERROR_INVALID_PARAM, terminal_fd_writer_s::fp, frame, log_debug_every, NS_PER_SEC_INT, SET_ERRNO, and SET_ERRNO_SYS.