ascii-chat/string_8h_source.html

#pragma once


#include <libplatform/util/string.h>


#include <stddef.h>

#include <stdbool.h>

#include <stdarg.h>

#include <stdio.h>

#include <ascii-chat/asciichat_errno.h>


#ifdef _WIN32

#include <BaseTsd.h>

typedef SSIZE_T ssize_t;

#else

#include <sys/types.h>

#endif


int platform_vsnprintf(char *str, size_t size, const char *format, va_list ap);

int platform_asprintf(char **strp, const char *format, ...);

int platform_vasprintf(char **strp, const char *format, va_list ap);

char *platform_strdup(const char *s);

int platform_strcasecmp(const char *s1, const char *s2);

int platform_strncasecmp(const char *s1, const char *s2, size_t n);

char *platform_strtok_r(char *str, const char *delim, char **saveptr);

size_t platform_strlcpy(char *dst, const char *src, size_t size);

int platform_strncpy(char *dst, size_t dst_size, const char *src, size_t count);

ssize_t platform_getline(char **lineptr, size_t *n, FILE *stream);

asciichat_error_t platform_escape_shell_path(const char *path, char *output, size_t output_size);


/* ============================================================================

 * String Escaping Functions

 * @{

 */


void escape_ascii(const char *str, const char *escape_char, char *out_buffer, size_t out_buffer_size);


bool validate_shell_safe(const char *str, const char *allowed_chars);


bool escape_shell_single_quotes(const char *str, char *out_buffer, size_t out_buffer_size);


bool escape_shell_double_quotes(const char *str, char *out_buffer, size_t out_buffer_size);


bool string_needs_shell_quoting(const char *str);


bool escape_path_for_shell(const char *path, char *out_buffer, size_t out_buffer_size);


/* ============================================================================

 * String Formatting and Display

 * @{

 */


#include "../log/log.h"


const char *colored_string(log_color_t color, const char *text);

int colored_string_set_output_fd(int fd);


void truncate_with_ellipsis(const char *input, char *output, size_t output_size, int max_width);


void truncate_with_ellipsis_mode(const char *input, char *output, size_t output_size, int max_width, bool utf8);


void strip_ansi_codes(const char *input, char *output, size_t output_size);


asciichat_errno.h
Synchronized per-thread pending error stacks and value snapshots. SET_ERRNO pushes,...

asciichat_error_t
asciichat_error_t
Error and exit codes - unified status values (0-255).
Definition error_codes.h:44

log_color_t
log_color_t
Color enum for logging - indexes into color arrays.
Definition log/log.h:147

colored_string
const char * colored_string(log_color_t color, const char *text)
Build a colored string for terminal output.
Definition string.c:284

colored_string_set_output_fd
int colored_string_set_output_fd(int fd)
Definition string.c:274

strip_ansi_codes
void strip_ansi_codes(const char *input, char *output, size_t output_size)
Strip ANSI escape codes from a string.
Definition string.c:374

escape_shell_double_quotes
bool escape_shell_double_quotes(const char *str, char *out_buffer, size_t out_buffer_size)
Escape a string for safe use in shell commands (double quotes, Windows-compatible).

truncate_with_ellipsis_mode
void truncate_with_ellipsis_mode(const char *input, char *output, size_t output_size, int max_width, bool utf8)
Truncate a string to a maximum display width with a terminal-appropriate ellipsis.
Definition string.c:334

escape_shell_single_quotes
bool escape_shell_single_quotes(const char *str, char *out_buffer, size_t out_buffer_size)
Validate that a string contains only safe characters for shell commands.

escape_ascii
void escape_ascii(const char *str, const char *escape_char, char *out_buffer, size_t out_buffer_size)
Escape ASCII characters in a string.

escape_path_for_shell
bool escape_path_for_shell(const char *path, char *out_buffer, size_t out_buffer_size)
Check if a string needs shell quoting (contains spaces or special chars).

truncate_with_ellipsis
void truncate_with_ellipsis(const char *input, char *output, size_t output_size, int max_width)
Truncate a string to a maximum display width, with ellipsis.
Definition string.c:370

log.h
📝 Logging API with multiple log levels and terminal output control