netsurf/utils/url.c

188 lines
4.3 KiB
C

/*
* Copyright 2006 Richard Wilson <info@tinct.net>
* Copyright 2005 James Bursa <bursa@users.sourceforge.net>
* Copyright 2005 John M Bell <jmb202@ecs.soton.ac.uk>
*
* This file is part of NetSurf, http://www.netsurf-browser.org/
*
* NetSurf is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; version 2 of the License.
*
* NetSurf is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
/**
* \file
* \brief Implementation of URI percent escaping.
*
* Percent encoding of URI is subject to RFC3986 however this is not
* implementing URI behaviour purely the percent encoding so only the
* unreserved set is not encoded and arbitrary binary data may be
* unescaped.
*
* \note Earlier RFC (2396, 1738 and 1630) list the tilde ~ character
* as special so its handling is ambiguious
*/
#include <ctype.h>
#include <assert.h>
#include <string.h>
#include <stdlib.h>
#include <stdbool.h>
#include "utils/ascii.h"
#include "utils/config.h"
#include "utils/log.h"
#include "utils/url.h"
/**
* Convert a hex digit to a hex value
*
* Must be called with valid hex char, results undefined otherwise.
*
* \param[in] c character to convert to value
* \return the value of c
*/
static inline char xdigit_to_hex(char c)
{
if (c >= '0' && c <= '9') {
return c - '0';
} else if (c >= 'A' && c <= 'F') {
return c - 'A' + 10;
} else {
return c - 'a' + 10;
}
}
/* exported interface documented in utils/url.h */
nserror url_unescape(const char *str, size_t length,
size_t *length_out, char **result_out)
{
const char *str_end;
size_t new_len;
char *res_pos;
char *result;
if ((str == NULL) || (result_out == NULL)) {
return NSERROR_BAD_PARAMETER;
}
if (length == 0) {
length = strlen(str);
}
result = malloc(length + 1);
if (result == NULL) {
return NSERROR_NOMEM;
}
res_pos = result;
str_end = str + length;
if (length >= 3) {
str_end -= 2;
while (str < str_end) {
char c = *str;
char c1 = *(str + 1);
char c2 = *(str + 2);
if (c == '%' && ascii_is_hex(c1) && ascii_is_hex(c2)) {
c = xdigit_to_hex(c1) << 4 | xdigit_to_hex(c2);
str += 2;
}
*res_pos++ = c;
str++;
}
str_end += 2;
}
while (str < str_end) {
*res_pos++ = *str++;
}
*res_pos = '\0';
new_len = res_pos - result;
if (new_len != length) {
/* Shrink wrap the allocation around the string */
char *tmp = realloc(result, new_len + 1);
if (tmp != NULL) {
result = tmp;
}
}
if (length_out != NULL) {
*length_out = new_len;
}
*result_out = result;
return NSERROR_OK;
}
/* exported interface documented in utils/url.h */
nserror url_escape(const char *unescaped, bool sptoplus,
const char *escexceptions, char **result)
{
size_t len, new_len;
char *escaped, *pos;
const char *c;
if (unescaped == NULL || result == NULL) {
return NSERROR_BAD_PARAMETER;
}
len = strlen(unescaped);
escaped = malloc(len * 3 + 1);
if (escaped == NULL) {
return NSERROR_NOMEM;
}
pos = escaped;
for (c = unescaped; *c != '\0'; c++) {
/* Check if we should escape this byte.
* '~' is unreserved and should not be percent encoded, if
* you believe the spec; however, leaving it unescaped
* breaks a bunch of websites, so we escape it anyway. */
if (!isascii(*c) ||
(strchr(":/?#[]@" /* gen-delims */
"!$&'()*+,;=" /* sub-delims */
"<>%\"{}|\\^`~" /* others */, *c) &&
(!escexceptions ||
!strchr(escexceptions, *c))) ||
*c <= 0x20 || *c == 0x7f) {
if (*c == 0x20 && sptoplus) {
*pos++ = '+';
} else {
*pos++ = '%';
*pos++ = "0123456789ABCDEF"[(*c >> 4) & 0xf];
*pos++ = "0123456789ABCDEF"[*c & 0xf];
}
} else {
/* unreserved characters: [a-zA-Z0-9-._] */
*pos++ = *c;
}
}
*pos = '\0';
new_len = pos - escaped;
if (new_len != len) {
/* Shrink wrap the allocation around the escaped string */
char *tmp = realloc(escaped, new_len + 1);
if (tmp != NULL) {
escaped = tmp;
}
}
*result = escaped;
return NSERROR_OK;
}