1

#ifndef LIB_URL_H

     2

#define LIB_URL_H

     3

     4

/*

     5

 * A trivial parser for simple URLs

     6

 *

     7

 * [ <scheme> [ "+" <scheme> [ ... ] ] "://" ] [ <username> [ ":" <password> ] "@" ] [ <hostname> ] [ ":" <service> ] [ "/" <path> ] [ "?" [ <key> [ "=" <value> ] ] [ "&" [ <key> [ "="     <value> ] ] [ ... ] ]

     8

 *

     9

 *  example.com

    10

 *  tcp://example.com:7348/

    11

 *  psql://postgres@localhost/test_db?charset=utf8

    12

 *  

    13

 */

    14

    15

#include <sys/types.h>

    16

#include <stdio.h>

    17

    18

/*

    19

 * The schema

    20

 */

    21

struct url_schema {

    22

    size_t count;

    23

    const char *list[];

    24

};

    25

    26

/*

    27

 * The options at the end

    28

 */

    29

struct url_opts {

    30

    size_t count;

    31

    struct url_opt {

    32

        const char *key;

    33

        const char *value;

    34

    } list[];

    35

};

    36

    37

/*

    38

 * A parsed URL

    39

 */

    40

struct url {

    41

    struct url_schema *schema;

    42

    const char *username;

    43

    const char *password;

    44

    const char *hostname;

    45

    const char *service;

    46

    const char *path;

    47

    struct url_opts *opts;

    48

};

    49

    50

/*

    51

 * Parse the given `text` as an URL, returning the result in `url`. Optional fields that are missing in the text will

    52

 * cause those values to be returned unmodified.

    53

 *

    54

 * Returns zero if the url was valid and was parsed, nonzero if it was invalid.

    55

 */

    56

int url_parse (struct url *url, const char *text);

    57

    58

/*

    59

 * Prints a url in a debug-output format.

    60

 */

    61

void url_dump (const struct url *url, FILE *stream);

    62

    63

#endif /* LIB_URL_H */