Jim_Nvp Struct Reference

Name Value Pairs, aka: NVP. More...

Data Fields
const char *	name
int	value

Detailed Description

Name Value Pairs, aka: NVP.

• Given a string - return the associated int.
• Given a number - return the associated string.

Very useful when the number is not a simple index into an array of known string, or there may be multiple strings (aliases) that mean then same thing.

An NVP Table is terminated with ".name = NULL".

During the 'name2value' operation, if no matching string is found the pointer to the terminal element (with p->name == NULL) is returned.

Example:

    const Jim_Nvp yn[] = {
        { "yes", 1 },
        { "no" , 0 },
        { "yep", 1 },
        { "nope", 0 },
        { NULL, -1 },
    };

Jim_Nvp *result
e = Jim_Nvp_name2value(interp, yn, "y", &result);
       returns &yn[0];
e = Jim_Nvp_name2value(interp, yn, "n", &result);
       returns &yn[1];
e = Jim_Nvp_name2value(interp, yn, "Blah", &result);
       returns &yn[4];

During the number2name operation, the first matching value is returned.

Definition at line 84 of file jim-nvp.h.

Field Documentation

name

const char* Jim_Nvp::name

Definition at line 85 of file jim-nvp.h.

Referenced by COMMAND_HANDLER(), debug_reason_name(), jim_aice_newtap_cmd(), Jim_GetNvp(), jim_hl_newtap_cmd(), jim_newtap_cmd(), jim_newtap_expected_id(), jim_newtap_ir_param(), Jim_Nvp_name2value(), Jim_Nvp_name2value_nocase(), Jim_Nvp_name2value_nocase_simple(), Jim_Nvp_name2value_simple(), Jim_Nvp_value2name(), Jim_Nvp_value2name_simple(), Jim_SetResult_NvpUnknown(), jim_target_wait_state(), jtag_tap_configure_cmd(), jtag_tap_handle_event(), target_configure(), target_event_name(), target_process_reset(), target_reset_mode_name(), target_state_name(), and target_strerror_safe().

value

int Jim_Nvp::value

Definition at line 86 of file jim-nvp.h.

Referenced by aarch64_jim_configure(), adiv5_jim_spot_configure(), COMMAND_HANDLER(), dap_configure(), jim_aice_newtap_cmd(), jim_arc_add_reg(), jim_arc_add_reg_type_flags(), jim_arc_add_reg_type_struct(), jim_hl_newtap_cmd(), jim_newtap_cmd(), jim_newtap_ir_param(), Jim_Nvp_value2name_simple(), jim_target_invoke_event(), jim_target_reset(), jim_target_wait_state(), jtag_tap_configure_cmd(), jtag_tap_configure_event(), and target_configure().

---

The documentation for this struct was generated from the following file:

• jim-nvp.h