141 lines
3.5 KiB
C
141 lines
3.5 KiB
C
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
|
|
/* soup-form.c : utility functions for HTML forms */
|
|
|
|
/*
|
|
* Copyright 2008 Red Hat, Inc.
|
|
*/
|
|
|
|
/* This one is stripped down to only have soup_form_encode_hash()
|
|
* and soup_form_encode_valist() which are the only bits that soup-uri.c
|
|
* calls.
|
|
*/
|
|
|
|
#include <config.h>
|
|
|
|
#include <string.h>
|
|
|
|
#include "ostree-soup-uri.h"
|
|
|
|
/**
|
|
* SECTION:soup-form
|
|
* @short_description: HTML form handling
|
|
* @see_also: #SoupMultipart
|
|
*
|
|
* libsoup contains several help methods for processing HTML forms as
|
|
* defined by <ulink
|
|
* url="http://www.w3.org/TR/html401/interact/forms.html#h-17.13">the
|
|
* HTML 4.01 specification</ulink>.
|
|
**/
|
|
|
|
/**
|
|
* SOUP_FORM_MIME_TYPE_URLENCODED:
|
|
*
|
|
* A macro containing the value
|
|
* <literal>"application/x-www-form-urlencoded"</literal>; the default
|
|
* MIME type for POSTing HTML form data.
|
|
*
|
|
* Since: 2.26
|
|
**/
|
|
|
|
/**
|
|
* SOUP_FORM_MIME_TYPE_MULTIPART:
|
|
*
|
|
* A macro containing the value
|
|
* <literal>"multipart/form-data"</literal>; the MIME type used for
|
|
* posting form data that contains files to be uploaded.
|
|
*
|
|
* Since: 2.26
|
|
**/
|
|
|
|
#define XDIGIT(c) ((c) <= '9' ? (c) - '0' : ((c) & 0x4F) - 'A' + 10)
|
|
#define HEXCHAR(s) ((XDIGIT (s[1]) << 4) + XDIGIT (s[2]))
|
|
|
|
static void
|
|
append_form_encoded (GString *str, const char *in)
|
|
{
|
|
const unsigned char *s = (const unsigned char *)in;
|
|
|
|
while (*s) {
|
|
if (*s == ' ') {
|
|
g_string_append_c (str, '+');
|
|
s++;
|
|
} else if (!g_ascii_isalnum (*s) && (*s != '-') && (*s != '_')
|
|
&& (*s != '.'))
|
|
g_string_append_printf (str, "%%%02X", (int)*s++);
|
|
else
|
|
g_string_append_c (str, *s++);
|
|
}
|
|
}
|
|
|
|
static void
|
|
encode_pair (GString *str, const char *name, const char *value)
|
|
{
|
|
g_return_if_fail (name != NULL);
|
|
g_return_if_fail (value != NULL);
|
|
|
|
if (str->len)
|
|
g_string_append_c (str, '&');
|
|
append_form_encoded (str, name);
|
|
g_string_append_c (str, '=');
|
|
append_form_encoded (str, value);
|
|
}
|
|
|
|
/**
|
|
* soup_form_encode_hash:
|
|
* @form_data_set: (element-type utf8 utf8) (transfer none): a hash table containing
|
|
* name/value pairs (as strings)
|
|
*
|
|
* Encodes @form_data_set into a value of type
|
|
* "application/x-www-form-urlencoded", as defined in the HTML 4.01
|
|
* spec.
|
|
*
|
|
* Note that the HTML spec states that "The control names/values are
|
|
* listed in the order they appear in the document." Since this method
|
|
* takes a hash table, it cannot enforce that; if you care about the
|
|
* ordering of the form fields, use soup_form_encode_datalist().
|
|
*
|
|
* Return value: the encoded form
|
|
**/
|
|
char *
|
|
soup_form_encode_hash (GHashTable *form_data_set)
|
|
{
|
|
GString *str = g_string_new (NULL);
|
|
GHashTableIter iter;
|
|
gpointer name, value;
|
|
|
|
g_hash_table_iter_init (&iter, form_data_set);
|
|
while (g_hash_table_iter_next (&iter, &name, &value))
|
|
encode_pair (str, name, value);
|
|
return g_string_free (str, FALSE);
|
|
}
|
|
|
|
/**
|
|
* soup_form_encode_valist:
|
|
* @first_field: name of the first form field
|
|
* @args: pointer to additional values, as in soup_form_encode()
|
|
*
|
|
* See soup_form_encode(). This is mostly an internal method, used by
|
|
* various other methods such as soup_uri_set_query_from_fields() and
|
|
* soup_form_request_new().
|
|
*
|
|
* Return value: the encoded form
|
|
**/
|
|
char *
|
|
soup_form_encode_valist (const char *first_field, va_list args)
|
|
{
|
|
GString *str = g_string_new (NULL);
|
|
const char *name, *value;
|
|
|
|
name = first_field;
|
|
value = va_arg (args, const char *);
|
|
while (name && value) {
|
|
encode_pair (str, name, value);
|
|
|
|
name = va_arg (args, const char *);
|
|
if (name)
|
|
value = va_arg (args, const char *);
|
|
}
|
|
|
|
return g_string_free (str, FALSE);
|
|
}
|