native_dynamic_request_fields.h

Go to the documentation of this file.

/**
 * @file
 * @brief Request field extraction helpers for in-process dynamic handling.
 *
 * Provides URL decoding, query-string parsing, and form-value extraction
 * so that the dynamic runtime can read request parameters without
 * delegating to a child process.
 */
 
#ifndef PHAROS_NATIVE_DYNAMIC_REQUEST_FIELDS_H
#define PHAROS_NATIVE_DYNAMIC_REQUEST_FIELDS_H
 
#include <stddef.h>
 
/** @name URL decoding
 * @{
 */
 
/**
 * @brief Decodes a percent-encoded URL string.
 *
 * Allocates a new buffer containing the decoded result.  The @c +
 * character is decoded as a space.
 *
 * @param encoded  Percent-encoded input string.
 * @return Newly allocated decoded string, or NULL on allocation failure.
 *         Caller must free.
 */
char *native_dynamic_url_decode(const char *encoded);
 
/** @} */
 
/** @name Query-string helpers
 * @{
 */
 
/**
 * @brief Extracts a parameter value from a query string.
 *
 * Searches @p query for @c key=value pairs separated by @c & and
 * returns the decoded value for the first match.
 *
 * @param query  Raw query string (without the leading @c ? ).
 * @param key    Parameter name to look up.
 * @return Newly allocated decoded value, or NULL if not found.
 *         Caller must free.
 */
char *native_dynamic_query_value(const char *query, const char *key);
 
/** @} */
 
/** @name Form-value helpers
 * @{
 */
 
/**
 * @brief Extracts a value from a URL-encoded form body.
 *
 * Searches @p body for @c key=value pairs separated by @c & and
 * returns the decoded value for the first match.
 *
 * @param body  URL-encoded form body.
 * @param key   Form field name to look up.
 * @return Newly allocated decoded value, or NULL if not found.
 *         Caller must free.
 */
char *native_dynamic_form_value(const char *body, const char *key);
 
/** @} */
 
/** @name Cookie helpers
 * @{
 */
 
/**
 * @brief Extracts a cookie value from a Cookie header string.
 *
 * Searches @p cookie_header for @c name=value pairs separated by
 * @c ; and returns the decoded value for the first match.
 *
 * @param cookie_header  Raw Cookie header value.
 * @param name  Cookie name to look up.
 * @return Newly allocated cookie value, or NULL if not found.
 *         Caller must free.
 */
char *native_dynamic_cookie_value(const char *cookie_header, const char *name);
 
/** @} */
 
#endif