Basic C library to easily parse arguments
Go to file
2024-01-05 10:05:14 +00:00
.gitignore r 2023-05-11 21:54:43 +01:00
carg-parse.c Update carg-parse.c 2023-09-17 19:31:21 +01:00
carg-parse.h Update carg-parse.h 2023-10-03 11:48:28 +01:00
LICENSE Initial commit 2023-05-11 11:33:09 +01:00
README.md fixed formatting 2023-07-29 13:33:34 +01:00
test.c added support for --flags 2023-07-29 13:23:01 +01:00

carg-parse

Basic C library to easily parse arguments

Usage

for a full example of usage look at test.c

Call carg_parse(int argc, char** argv) it will return carg_parse_data* containing:

typedef struct 
{
    char* exec_name;

    uint32_t values_len;
    char** values;

    uint32_t lv_len;
    char** lv_labels;
    char** lv_values;

    uint32_t flags_len;
    char** flags;
} carg_parse_data;

Values is an array of all of the free standing arguments passed in

LV is a dictionary, labels in lv_labels and values in lv_values, it contains any labeled arguments '-a b', if a value is not provided lv_value will point to NULL

values, lv_values and flags all point to argv, lv_labels points to argv + 1, as to ignore the dash ('-'), and flags does the same except + 2 as to ignore the double dash ('--')

when done with the data, call carg_parse_free(carg_parse_data* data) to free the data, it does not free the individual values and labels, as these just point to the values in argv, so if you have moved / modified these pointers, you will have to free them yourself. this has the benifit as well, of allowing you to free carg, even if you have values pointing to strings passed in.