ascii-chat
Binary v0.16.50-198-g78f51665f
Library lib/v0.3.2-2240-g78f51665f
Video chat in your terminal
Loading...
Searching...
No Matches
strings.c File Reference

Centralized enum and mode string conversion - single source of truth. More...

Go to the source code of this file.

Data Structures

struct  mode_string_mapping_t
 Mode name mapping for string conversion. More...

Macros

#define MODE_NAME_CAPACITY   32

Functions

const char * asciichat_mode_to_string (asciichat_mode_t mode)
 Convert mode enum to string.
asciichat_mode_t asciichat_string_to_mode (const char *str)
 Convert string to mode enum.
bool asciichat_is_valid_mode_string (const char *str)
 Check if string is a valid mode name.
size_t asciichat_get_all_mode_strings (const char ***out_names)
 Get all mode strings.
const char * asciichat_suggest_mode (const char *input)
 Suggest closest matching mode using fuzzy matching.
const char * color_mode_to_string (terminal_color_mode_t mode)
 Convert color mode enum to string.
const char * render_mode_to_string (terminal_render_mode_t mode)
const char * palette_type_to_string (palette_type_t type)
 Convert palette type enum to string.
const char * asciichat_suggest_enum_value (const char *option_name, const char *input)
 Suggest closest matching enum value using fuzzy matching.

Detailed Description

Centralized enum and mode string conversion - single source of truth.

This module provides bidirectional conversion between enums and strings:

  • Mode enum ↔ mode string ("server", "client", "mirror", etc.)
  • Option enum values ↔ string values ("auto", "none", "16", etc.)
  • Fuzzy matching suggestions via levenshtein distance

All mode and enum string conversions should use this module.

Definition in file options/strings.c.

Macro Definition Documentation

◆ MODE_NAME_CAPACITY

#define MODE_NAME_CAPACITY   32

Definition at line 15 of file options/strings.c.

Referenced by asciichat_get_all_mode_strings(), and asciichat_suggest_mode().

Function Documentation

◆ asciichat_get_all_mode_strings()

size_t asciichat_get_all_mode_strings ( const char *** out_names)

Get all mode strings.

Parameters
out_namesOutput array of mode name pointers
Returns
Number of mode names

Definition at line 87 of file options/strings.c.

87 {
88 static const char *names[MODE_NAME_CAPACITY]; // Max 32 modes
89 size_t count = 0;
90
91 for (size_t i = 0; mode_registry[i].name != NULL && count < MODE_NAME_CAPACITY; i++) {
92 // The HTTP API entry point is selected by its dedicated launcher and is
93 // not a user-facing mode for generic mode completion/help lists.
94 if (mode_registry[i].mode == MODE_API_SERVER || strcmp(mode_registry[i].name, "acds") == 0)
95 continue;
96 // Skip duplicates (like "acds" alias)
97 bool duplicate = false;
98 for (size_t j = 0; j < count; j++) {
99 if (strcmp(names[j], mode_registry[i].name) == 0) {
100 duplicate = true;
101 break;
102 }
103 }
104 if (!duplicate) {
105 names[count++] = mode_registry[i].name;
106 }
107 }
108
109 if (out_names) {
110 *out_names = names;
111 }
112 return count;
113}
@ MODE_API_SERVER
Image-to-ASCII HTTP API server.
Definition options.h:923
#define MODE_NAME_CAPACITY

References MODE_API_SERVER, and MODE_NAME_CAPACITY.

Referenced by asciichat_suggest_mode().

◆ asciichat_is_valid_mode_string()

bool asciichat_is_valid_mode_string ( const char * str)

Check if string is a valid mode name.

Parameters
strString to check
Returns
true if valid mode name, false otherwise

Definition at line 83 of file options/strings.c.

83 {
85}
@ MODE_INVALID
Invalid mode.
Definition options.h:924
asciichat_mode_t asciichat_string_to_mode(const char *str)
Convert string to mode enum.

References asciichat_string_to_mode(), and MODE_INVALID.

◆ asciichat_mode_to_string()

const char * asciichat_mode_to_string ( asciichat_mode_t mode)

Convert mode enum to string.

Parameters
modeMode enum value
Returns
Mode name string (e.g., "server", "client", "mirror")

Definition at line 55 of file options/strings.c.

55 {
56 // Special case: MODE_DISCOVERY is the default mode, show as "default" to users
57 if (mode == MODE_DISCOVERY) {
58 return "default";
59 }
60
61 for (size_t i = 0; mode_registry[i].name != NULL; i++) {
62 if (mode_registry[i].mode == mode) {
63 return mode_registry[i].name;
64 }
65 }
66 return "unknown";
67}
@ MODE_DISCOVERY
Discovery mode - participant that can dynamically become host.
Definition options.h:921

References MODE_DISCOVERY.

◆ asciichat_string_to_mode()

asciichat_mode_t asciichat_string_to_mode ( const char * str)

Convert string to mode enum.

Parameters
strMode name string
Returns
Mode enum value, or MODE_UNKNOWN if invalid

Definition at line 69 of file options/strings.c.

69 {
70 if (!str) {
71 return MODE_INVALID;
72 }
73
74 for (size_t i = 0; mode_registry[i].name != NULL; i++) {
75 if (strcmp(mode_registry[i].name, str) == 0) {
76 return mode_registry[i].mode;
77 }
78 }
79
80 return MODE_INVALID;
81}

References MODE_INVALID.

Referenced by asciichat_is_valid_mode_string().

◆ asciichat_suggest_enum_value()

const char * asciichat_suggest_enum_value ( const char * option_name,
const char * input )

Suggest closest matching enum value using fuzzy matching.

Parameters
option_nameOption name (e.g., "color-mode", "palette")
inputInvalid enum value string
Returns
Suggested enum value, or NULL if no close match

Definition at line 198 of file options/strings.c.

198 {
199 if (!option_name || !input) {
200 return NULL;
201 }
202
203 size_t value_count = 0;
204 const char **values = options_registry_get_enum_values(option_name, NULL, &value_count);
205 return values ? levenshtein_find_similar(input, values) : NULL;
206}
const char * levenshtein_find_similar(const char *unknown, const char *const *candidates)
Find the most similar string from a NULL-terminated array.
const char ** options_registry_get_enum_values(const char *option_name, const char ***descriptions, size_t *count)
Get enum values for an option.
Definition public_api.c:272

References levenshtein_find_similar(), and options_registry_get_enum_values().

Referenced by parse_color_mode(), parse_palette_type(), and parse_render_mode().

◆ asciichat_suggest_mode()

const char * asciichat_suggest_mode ( const char * input)

Suggest closest matching mode using fuzzy matching.

Parameters
inputInvalid mode string
Returns
Suggested mode name, or NULL if no close match

Definition at line 115 of file options/strings.c.

115 {
116 if (!input) {
117 return NULL;
118 }
119
120 const char **names = NULL;
121 size_t count = asciichat_get_all_mode_strings(&names);
122
123 // Create a NULL-terminated array for libflags suggestion matching.
124 static const char *null_terminated[MODE_NAME_CAPACITY + 1]; // Max 32 modes + NULL
125 for (size_t i = 0; i < count && i < MODE_NAME_CAPACITY; i++) {
126 null_terminated[i] = names[i];
127 }
128 null_terminated[count] = NULL;
129
130 return levenshtein_find_similar(input, null_terminated);
131}
size_t asciichat_get_all_mode_strings(const char ***out_names)
Get all mode strings.

References asciichat_get_all_mode_strings(), levenshtein_find_similar(), and MODE_NAME_CAPACITY.

◆ color_mode_to_string()

const char * color_mode_to_string ( terminal_color_mode_t mode)

Convert color mode enum to string.

Parameters
modeColor mode value
Returns
Color mode string (e.g., "auto", "256", "truecolor")

Definition at line 137 of file options/strings.c.

137 {
138 switch (mode) {
139 case TERM_COLOR_AUTO:
140 return OPT_COLOR_MODE_AUTO;
141 case TERM_COLOR_NONE:
142 return OPT_COLOR_MODE_NONE;
143 case TERM_COLOR_16:
144 return OPT_COLOR_MODE_16;
145 case TERM_COLOR_256:
146 return OPT_COLOR_MODE_256;
147 case TERM_COLOR_TRUECOLOR:
149 default:
150 return "unknown";
151 }
152}
#define OPT_COLOR_MODE_256
Definition enums.h:101
#define OPT_COLOR_MODE_NONE
Definition enums.h:98
#define OPT_COLOR_MODE_TRUECOLOR
Definition enums.h:102
#define OPT_COLOR_MODE_AUTO
Definition enums.h:97
#define OPT_COLOR_MODE_16
Definition enums.h:100

References OPT_COLOR_MODE_16, OPT_COLOR_MODE_256, OPT_COLOR_MODE_AUTO, OPT_COLOR_MODE_NONE, and OPT_COLOR_MODE_TRUECOLOR.

Referenced by ui_session_help_render().

◆ palette_type_to_string()

const char * palette_type_to_string ( palette_type_t type)

Convert palette type enum to string.

Parameters
typePalette type value
Returns
Palette type string (e.g., "standard", "blocks", "cool")

Definition at line 175 of file options/strings.c.

175 {
176 switch (type) {
177 case PALETTE_STANDARD:
179 case PALETTE_BLOCKS:
180 return OPT_PALETTE_BLOCKS;
181 case PALETTE_DIGITAL:
182 return OPT_PALETTE_DIGITAL;
183 case PALETTE_MINIMAL:
184 return OPT_PALETTE_MINIMAL;
185 case PALETTE_COOL:
186 return OPT_PALETTE_COOL;
187 case PALETTE_CUSTOM:
188 return OPT_PALETTE_CUSTOM;
189 default:
190 return "unknown";
191 }
192}
#define OPT_PALETTE_CUSTOM
Definition enums.h:125
#define OPT_PALETTE_COOL
Definition enums.h:124
#define OPT_PALETTE_MINIMAL
Definition enums.h:123
#define OPT_PALETTE_BLOCKS
Definition enums.h:121
#define OPT_PALETTE_STANDARD
Definition enums.h:120
#define OPT_PALETTE_DIGITAL
Definition enums.h:122
@ PALETTE_BLOCKS
Unicode block characters: " ░░▒▒▓▓██".
Definition palette.h:102
@ PALETTE_CUSTOM
User-defined via –palette-chars.
Definition palette.h:110
@ PALETTE_COOL
Ascending blocks: " ▁▂▃▄▅▆▇█".
Definition palette.h:108
@ PALETTE_STANDARD
Standard ASCII palette: " ...',;:clodxkO0KXNWM".
Definition palette.h:100
@ PALETTE_DIGITAL
Digital/glitch aesthetic: " -=≡≣▰▱◼".
Definition palette.h:104
@ PALETTE_MINIMAL
Simple ASCII: " .-+*#".
Definition palette.h:106

References OPT_PALETTE_BLOCKS, OPT_PALETTE_COOL, OPT_PALETTE_CUSTOM, OPT_PALETTE_DIGITAL, OPT_PALETTE_MINIMAL, OPT_PALETTE_STANDARD, PALETTE_BLOCKS, PALETTE_COOL, PALETTE_CUSTOM, PALETTE_DIGITAL, PALETTE_MINIMAL, and PALETTE_STANDARD.

◆ render_mode_to_string()

const char * render_mode_to_string ( terminal_render_mode_t mode)

Definition at line 158 of file options/strings.c.

158 {
159 switch (mode) {
160 case RENDER_MODE_FOREGROUND:
162 case RENDER_MODE_BACKGROUND:
164 case RENDER_MODE_HALF_BLOCK:
166 default:
167 return "unknown";
168 }
169}
#define OPT_RENDER_MODE_FOREGROUND
Definition enums.h:128
#define OPT_RENDER_MODE_HALF_BLOCK
Definition enums.h:132
#define OPT_RENDER_MODE_BACKGROUND
Definition enums.h:130

References OPT_RENDER_MODE_BACKGROUND, OPT_RENDER_MODE_FOREGROUND, and OPT_RENDER_MODE_HALF_BLOCK.

Referenced by ui_session_help_render().