enums.c File Reference

Option enum value implementation with dynamic enum-to-string mapping. More...

Go to the source code of this file.

Data Structures
struct	enum_map_descriptor_t
	Descriptor for an enum option with its string value mapping. More...

Functions
const enum_to_string_entry_t *	options_get_enum_entries (const char *option_name, size_t *entry_count)
	Get all enum entries with descriptions for an option.
const char **	options_get_enum_values (const char *option_name, size_t *value_count)
	Get all unique string values for an option.
bool	options_is_enum_option (const char *option_name)
	Check if an option has enum values.

Detailed Description

Option enum value implementation with dynamic enum-to-string mapping.

Definition in file enums.c.

Function Documentation

options_get_enum_entries()

const enum_to_string_entry_t * options_get_enum_entries	(	const char *	option_name,
		size_t *	entry_count
	)

Get all enum entries with descriptions for an option.

Get enum entries with descriptions for an option.

Returns entries containing both string values and descriptions for shell completion. Used by zsh completion to show descriptions alongside values.

Parameters

option_name	Option long name (e.g., "log-level")
entry_count	OUTPUT: Number of entries returned

Returns

Array of enum entries, or NULL if not an enum option

Definition at line 134 of file enums.c.

                                                                                                     {
  if (!option_name || !entry_count) {
    return NULL;
  }
 
  for (size_t i = 0; enum_registry[i].option_name != NULL; i++) {
    if (strcmp(enum_registry[i].option_name, option_name) == 0) {
      /* Count entries up to terminator */
      size_t count = 0;
      for (size_t j = 0; enum_registry[i].map[j].enum_value != -1; j++) {
        count++;
      }
      *entry_count = count;
      return enum_registry[i].map;
    }
  }
 
  *entry_count = 0;
  return NULL;
}

References enum_to_string_entry_t::enum_value, enum_map_descriptor_t::map, and enum_map_descriptor_t::option_name.

options_get_enum_values()

const char ** options_get_enum_values	(	const char *	option_name,
		size_t *	value_count
	)

Get all unique string values for an option.

Get enum values for an option.

Extracts the list of valid string values for an enum option. For options with aliases (like render-mode which has "foreground" and "fg"), both values are included.

Parameters

option_name	Option long name (e.g., "log-level")
value_count	OUTPUT: Number of values returned

Returns

Array of valid string values, or NULL if not an enum option

Definition at line 166 of file enums.c.

                                                                                   {
  if (!option_name || !value_count) {
    return NULL;
  }
 
  /* Find the option's mapping in the registry */
  const enum_map_descriptor_t *descriptor = NULL;
  for (size_t i = 0; enum_registry[i].option_name != NULL; i++) {
    if (strcmp(enum_registry[i].option_name, option_name) == 0) {
      descriptor = &enum_registry[i];
      break;
    }
  }
 
  if (!descriptor || !descriptor->map) {
    *value_count = 0;
    return NULL;
  }
 
  /* Count non-terminator entries */
  size_t count = 0;
  for (size_t i = 0; descriptor->map[i].enum_value != -1; i++) {
    count++;
  }
 
  /* Build array of unique strings (skip duplicates from aliases) */
  const char **values = SAFE_MALLOC(count * sizeof(const char *), const char **);
  size_t unique_count = 0;
 
  for (size_t i = 0; descriptor->map[i].enum_value != -1; i++) {
    const char *str = descriptor->map[i].string;
 
    /* Check if we already have this string (for aliases) */
    bool already_added = false;
    for (size_t j = 0; j < unique_count; j++) {
      if (strcmp(values[j], str) == 0) {
        already_added = true;
        break;
      }
    }
 
    if (!already_added) {
      values[unique_count++] = str;
    }
  }
 
  *value_count = unique_count;
  return values;
}

References enum_to_string_entry_t::enum_value, enum_map_descriptor_t::map, enum_map_descriptor_t::option_name, SAFE_MALLOC, and enum_to_string_entry_t::string.

Referenced by asciichat_suggest_enum_value().

options_is_enum_option()

bool options_is_enum_option

(

const char *

option_name

)

Check if an option has enum values.

Parameters

option_name

Option long name

Returns

true if option has enum values, false otherwise

Definition at line 222 of file enums.c.

                                                     {
  if (!option_name) {
    return false;
  }
 
  for (size_t i = 0; enum_registry[i].option_name != NULL; i++) {
    if (strcmp(enum_registry[i].option_name, option_name) == 0) {
      return true;
    }
  }
 
  return false;
}

References enum_map_descriptor_t::option_name.