summaryrefslogtreecommitdiffstats
path: root/url.h
blob: cd9140e9946b16d10989dbf11b4830d69fc72857 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
#ifndef URL_H
#define URL_H

struct strbuf;

int is_url(const char *url);
int is_urlschemechar(int first_flag, int ch);
char *url_decode(const char *url);
char *url_decode_mem(const char *url, int len);

/*
 * Similar to the url_decode_{,mem} methods above, but doesn't assume there
 * is a scheme followed by a : at the start of the string. Instead, %-sequences
 * before any : are also parsed.
 */
char *url_percent_decode(const char *encoded);

char *url_decode_parameter_name(const char **query);
char *url_decode_parameter_value(const char **query);

void end_url_with_slash(struct strbuf *buf, const char *url);
void str_end_url_with_slash(const char *url, char **dest);

/*
 * The set of unreserved characters as per STD66 (RFC3986) is
 * '[A-Za-z0-9-._~]'. These characters are safe to appear in URI
 * components without percent-encoding.
 */
int is_rfc3986_unreserved(char ch);

/*
 * This is a variant of is_rfc3986_unreserved() that treats uppercase
 * letters as "reserved". This forces them to be percent-encoded, allowing
 * 'Foo' (%46oo) and 'foo' (foo) to be distinct on case-folding filesystems.
 */
int is_casefolding_rfc3986_unreserved(char c);

#endif /* URL_H */