strings.h File Reference

Centralized enum and mode string conversion API. More...

Go to the source code of this file.

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

Single source of truth for all enum/mode ↔ string conversions. Use these functions instead of hardcoded string literals.

Definition in file options/strings.h.

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 92 of file options/strings.c.

                                                               {
  static const char *names[MODE_NAME_CAPACITY]; // Max 32 modes
  size_t count = 0;
 
  for (size_t i = 0; mode_registry[i].name != NULL && count < MODE_NAME_CAPACITY; 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_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

str	String to check

Returns

true if valid mode name, false otherwise

Definition at line 88 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 60 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.

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 74 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_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_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 199 of file options/strings.c.

                                                                                     {
  if (!option_name || !input) {
    return NULL;
  }
 
  size_t value_count = 0;
  const char **values = options_registry_get_enum_values(option_name, NULL, &value_count);
  return values ? levenshtein_find_similar(input, values) : NULL;
}

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

input

Invalid mode string

Returns

Suggested mode name, or NULL if no close match

Definition at line 116 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[MODE_NAME_CAPACITY + 1]; // Max 32 modes + NULL
  for (size_t i = 0; i < count && i < MODE_NAME_CAPACITY; i++) {
    null_terminated[i] = names[i];
  }
  null_terminated[count] = NULL;
 
  return levenshtein_find_similar(input, null_terminated);
}

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

mode	Color mode value

Returns

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

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

                                                             {
  switch (mode) {
  case TERM_COLOR_AUTO:
    return OPT_COLOR_MODE_AUTO;
  case TERM_COLOR_NONE:
    return OPT_COLOR_MODE_NONE;
  case TERM_COLOR_16:
    return OPT_COLOR_MODE_16;
  case TERM_COLOR_256:
    return OPT_COLOR_MODE_256;
  case TERM_COLOR_TRUECOLOR:
    return OPT_COLOR_MODE_TRUECOLOR;
  default:
    return "unknown";
  }
}

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

type	Palette type value

Returns

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

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

                                                        {
  switch (type) {
  case PALETTE_STANDARD:
    return OPT_PALETTE_STANDARD;
  case PALETTE_BLOCKS:
    return OPT_PALETTE_BLOCKS;
  case PALETTE_DIGITAL:
    return OPT_PALETTE_DIGITAL;
  case PALETTE_MINIMAL:
    return OPT_PALETTE_MINIMAL;
  case PALETTE_COOL:
    return OPT_PALETTE_COOL;
  case PALETTE_CUSTOM:
    return OPT_PALETTE_CUSTOM;
  default:
    return "unknown";
  }
}

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.