khttp_urlencode.3

NAME

khttp_urlencode — URL encoding for kcgi

LIBRARY

library “libkcgi”

SYNOPSIS

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

char *
khttp_urlencode(const char *cp);

DESCRIPTION

Percent-encodes a string cp, usually for embedding in a URL, and returns the allocated result. If passed a NULL, returns an allocated empty string.

The encoding uses capital-letter hex encoding.

RETURN VALUES

Returns a newly-allocated string that must be freed with free(3) or NULL if allocation fails.

The deprecated form of this function, kutil_urlencode(), should no longer be used.

EXAMPLES

The following table shows strings pre- and post-encoding.

foo bar	foo+bar
foo+bar	foo%2Bbar

AUTHORS

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