#ifndef MAGI_INCLUDED_PARAM
#define MAGI_INCLUDED_PARAM


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * Parameter
 */
struct magi_param {
    char * name; /* name: free(name) is valid. */
    char * data; /* data: free(data) is valid. */
};

/* Null is valid "struct magi_param_list *" object. */
struct magi_param_list {
    struct magi_param_list * next;
    struct magi_param        item;
};

/*
 * Adds *item to the begining of *list, item and list are dereferencable;
 * Returns null in case of error.
 */
int magi_param_list_add(struct magi_param_list ** list,
                        struct magi_param *       item);

/*
 * Searchs for first node in list: node.name == name, name is C-string;
 * Returns node itself if succeed, otherwise result is null.
 */
struct magi_param * magi_param_list_get(struct magi_param_list * list,
                                        const char *             name);

/*
 * Destroys list; list is not valid after destruction.
 */
void magi_param_list_destroy(struct magi_param_list * list);


#endif