#ifndef MAGI_INCLUDED_FIELD
#define MAGI_INCLUDED_FIELD


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * Form Field
 */
struct magi_field {
    char *name;  /* name: free(name) is valid. */
    char *data;  /* data: free(data) is valid. */
    int  len;    /* Length of data. */
    struct magi_param_list *params;  /* Only used if field is for file. */
};

/* Null is valid "struct magi_field_list *" object. */
struct magi_field_list {
    struct magi_field_list *next;
    struct magi_field      item;
};

/*
 * Adds *item to the begining of *list, item and list are dereferencable;
 * Returns null in case of error.
 */
int magi_field_list_add(
    struct magi_field_list **list,
    struct magi_field      *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_field *magi_field_list_get(
    struct magi_field_list *list,
    const char             *name
);

/*
 * Destroys list; list is not valid after destruction.
 */
void magi_field_list_destroy(struct magi_field_list *list);


#endif