如何将GNU argp中--help的短选项-?替换为-h？

要把argp默认的-? help短选项改成常见的-h，你需要禁用argp的默认help选项，然后自定义一个-h/--help选项并处理其逻辑，具体步骤如下：

实现步骤 #

1. 禁用默认help选项：在argp结构体中设置ARGP_NO_HELP标志，屏蔽默认的-?选项。
2. 添加自定义help选项：在argp_option数组中定义-h/--help选项，和其他自定义选项放在一起。
3. 处理help逻辑：在解析回调函数中捕获-h选项，调用argp_help输出标准格式的帮助信息后退出程序。

完整代码示例 #

#include <argp.h>
#include <stdlib.h>

// 程序版本与反馈地址
const char *argp_program_version = "myprog 1.0";
const char *argp_program_bug_address = "<your-email@example.com>";

// 程序描述与位置参数说明
static char doc[] = "A sample program using argp with custom -h help option";
static char args_doc[] = "[INPUT_FILE...]";

// 自定义选项数组
static struct argp_option options[] = {
    {"help",    'h', 0, 0, "Show this help message and exit", 0},
    {"verbose", 'v', 0, 0, "Enable verbose output mode", 0},
    {"output",  'o', "FILE", 0, "Write output to FILE instead of stdout", 0},
    {0} // 选项数组结束标记
};

// 选项解析回调函数
static error_t parse_opt(int key, char *arg, struct argp_state *state) {
    switch (key) {
        case 'h':
            // 输出标准帮助信息并退出
            argp_help(state, state->out_stream, ARGP_HELP_STD_HELP);
            exit(EXIT_SUCCESS);
        case 'v':
            // 示例：开启verbose模式（替换为你的业务逻辑）
            // verbose = 1;
            break;
        case 'o':
            // 示例：设置输出文件（替换为你的业务逻辑）
            // output_file = arg;
            break;
        case ARGP_KEY_ARG:
            // 处理位置参数（示例）
            // input_files[state->arg_num] = arg;
            break;
        case ARGP_KEY_END:
            // 参数解析完成后的检查（示例）
            // if (state->arg_num < 1) argp_error(state, "No input files provided");
            break;
        default:
            return ARGP_ERR_UNKNOWN;
    }
    return 0;
}

// 配置argp结构体，禁用默认help选项
static struct argp argp = {
    options,
    parse_opt,
    args_doc,
    doc,
    0,
    0,
    0,
    ARGP_NO_HELP
};

int main(int argc, char **argv) {
    argp_parse(&argp, argc, argv, 0, 0, 0);
    return 0;
}

说明 #

• 启用ARGP_NO_HELP后，argp不会自动生成-?选项，完全由你自定义的-h提供help功能。
• 使用ARGP_HELP_STD_HELP参数调用argp_help，会生成和argp默认格式一致的帮助文本，保证输出风格统一。
• 这种方式无需自定义键，直接捕获'h'键处理，逻辑清晰且符合常规程序的使用习惯。

内容的提问来源于stack exchange，提问作者Nullndr