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...

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 (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.

Function Documentation

asciichat_get_all_mode_strings()

size_t asciichat_get_all_mode_strings

(

const char ***

out_names

)

Get all mode strings.

Parameters

out_names

Output array of mode name pointers

Returns

Number of mode names

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

                                                               {
  static const char *names[32]; // Max 32 modes
  size_t count = 0;
 
  for (size_t i = 0; mode_registry[i].name != NULL && count < 32; i++) {
    // Skip duplicates (like "acds" alias)
    bool duplicate = false;
    for (size_t j = 0; j < count; j++) {
      if (strcmp(names[j], mode_registry[i].name) == 0) {
        duplicate = true;
        break;
      }
    }
    if (!duplicate) {
      names[count++] = mode_registry[i].name;
    }
  }
 
  if (out_names) {
    *out_names = names;
  }
  return count;
}

References mode_string_mapping_t::name.

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

str	String to check

Returns

true if valid mode name, false otherwise

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

                                                     {
  return asciichat_string_to_mode(str) != MODE_INVALID;
}

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

mode	Mode enum value

Returns

Mode name string (e.g., "server", "client", "mirror")

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

                                                            {
  // Special case: MODE_DISCOVERY is the default mode, show as "default" to users
  if (mode == MODE_DISCOVERY) {
    return "default";
  }
 
  for (size_t i = 0; mode_registry[i].name != NULL; i++) {
    if (mode_registry[i].mode == mode) {
      return mode_registry[i].name;
    }
  }
  return "unknown";
}

References MODE_DISCOVERY, and mode_string_mapping_t::name.

asciichat_string_to_mode()

asciichat_mode_t asciichat_string_to_mode

(

const char *

str

)

Convert string to mode enum.

Parameters

str	Mode name string

Returns

Mode enum value, or MODE_UNKNOWN if invalid

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

                                                           {
  if (!str) {
    return MODE_INVALID;
  }
 
  for (size_t i = 0; mode_registry[i].name != NULL; i++) {
    if (strcmp(mode_registry[i].name, str) == 0) {
      return mode_registry[i].mode;
    }
  }
 
  return MODE_INVALID;
}

References mode_string_mapping_t::mode, MODE_INVALID, and mode_string_mapping_t::name.

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_name	Option name (e.g., "color-mode", "palette")
input	Invalid enum value string

Returns

Suggested enum value, or NULL if no close match

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

                                                                                     {
  if (!option_name || !input) {
    return NULL;
  }
 
  size_t value_count = 0;
  const char **values = options_get_enum_values(option_name, &value_count);
 
  if (!values || value_count == 0) {
    return NULL;
  }
 
  // Create NULL-terminated array for levenshtein_find_similar
  static const char *null_terminated[64]; // Max 64 enum values
  for (size_t i = 0; i < value_count && i < 63; i++) {
    null_terminated[i] = values[i];
  }
  null_terminated[value_count] = NULL;
 
  return levenshtein_find_similar(input, null_terminated);
}

References levenshtein_find_similar(), and options_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

input

Invalid mode string

Returns

Suggested mode name, or NULL if no close match

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

                                                      {
  if (!input) {
    return NULL;
  }
 
  const char **names = NULL;
  size_t count = asciichat_get_all_mode_strings(&names);
 
  // Create NULL-terminated array for levenshtein_find_similar
  static const char *null_terminated[33]; // Max 32 modes + NULL
  for (size_t i = 0; i < count && i < 32; i++) {
    null_terminated[i] = names[i];
  }
  null_terminated[count] = NULL;
 
  return levenshtein_find_similar(input, null_terminated);
}

References asciichat_get_all_mode_strings(), and levenshtein_find_similar().

color_mode_to_string()

const char * color_mode_to_string

(

terminal_color_mode_t

mode

)

Convert color mode enum to string.

Parameters

mode	Color mode value

Returns

Color mode string (e.g., "auto", "256", "truecolor")

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

                                                             {
  switch (mode) {
  case TERM_COLOR_AUTO:
    return "auto";
  case TERM_COLOR_NONE:
    return "none";
  case TERM_COLOR_16:
    return "16";
  case TERM_COLOR_256:
    return "256";
  case TERM_COLOR_TRUECOLOR:
    return "truecolor";
  default:
    return "unknown";
  }
}

References TERM_COLOR_16, TERM_COLOR_256, TERM_COLOR_AUTO, TERM_COLOR_NONE, and TERM_COLOR_TRUECOLOR.

Referenced by keyboard_help_render().

palette_type_to_string()

const char * palette_type_to_string

(

palette_type_t

type

)

Convert palette type enum to string.

Parameters

type	Palette type value

Returns

Palette type string (e.g., "standard", "blocks", "cool")

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

                                                        {
  switch (type) {
  case PALETTE_STANDARD:
    return "standard";
  case PALETTE_BLOCKS:
    return "blocks";
  case PALETTE_DIGITAL:
    return "digital";
  case PALETTE_MINIMAL:
    return "minimal";
  case PALETTE_COOL:
    return "cool";
  case PALETTE_CUSTOM:
    return "custom";
  default:
    return "unknown";
  }
}

References PALETTE_BLOCKS, PALETTE_COOL, PALETTE_CUSTOM, PALETTE_DIGITAL, PALETTE_MINIMAL, and PALETTE_STANDARD.

render_mode_to_string()

const char * render_mode_to_string

(

render_mode_t

mode

)

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

                                                      {
  switch (mode) {
  case RENDER_MODE_FOREGROUND:
    return "foreground";
  case RENDER_MODE_BACKGROUND:
    return "background";
  case RENDER_MODE_HALF_BLOCK:
    return "half-block";
  default:
    return "unknown";
  }
}

References RENDER_MODE_BACKGROUND, RENDER_MODE_FOREGROUND, and RENDER_MODE_HALF_BLOCK.

Referenced by keyboard_help_render().