NAME

khttp_urldecode, khttp_urldecode_inplace —

URL decoding for kcgi

LIBRARY

library “libkcgi”

SYNOPSIS

#include <sys/types.h>
#include <stdarg.h>
#include <stdint.h>
#include <kcgi.h>

enum kcgi_err
khttp_urldecode(const char *src, char **dst);

enum kcgi_err
khttp_urldecode_inplace(char *src);

DESCRIPTION

Decode the percent-encoded string src. In khttp_urldecode(), the result is placed in dst. In khttp_urldecode_inplace(), the input string src is overwritten with the result, which will be the same or shorter in length.

These accept uppercase and lowercase percent encoding, for example. “%A0” or “%a0”, respectively.

The deprecated form of these functions, kutil_urldecode() and kutil_urldecode_inplace(), should no longer be used.

RETURN VALUES

khttp_urldecode() and khttp_urldecode_inplace() return an error code:

KCGI_OK: Success (not an error).
KCGI_ENOMEM: Memory failure (only khttp_urldecode()).
KCGI_FORM: Malformed input or NULL src or dst arguments.

If khttp_urldecode() returns an error, it always sets dst to NULL. khttp_urldecode_inplace(), however, may leave a partially-decoded string in src.

AUTHORS

Written by Kristaps Dzonsons <kristaps@bsd.lv>.