From 6837c5ac80e3624c6dc3a82d03e50d68b2f5a989 Mon Sep 17 00:00:00 2001
From: Dirk Engling <erdgeist@erdgeist.org>
Date: Mon, 26 Oct 2026 17:13:36 +0100
Subject: Second run of making variable and function names more readable,
 urlencoder now matches overall naming scheme

---
 ot_urlencoded.h | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 ot_urlencoded.h

(limited to 'ot_urlencoded.h')

diff --git a/ot_urlencoded.h b/ot_urlencoded.h
new file mode 100644
index 0000000..8147370
--- /dev/null
+++ b/ot_urlencoded.h
@@ -0,0 +1,61 @@
+/* This software was written by Dirk Engling <erdgeist@erdgeist.org>
+   It is considered beerware. Prost. Skol. Cheers or whatever.
+
+   $id$ */
+
+#ifndef SCAN_URLENCODED_QUERY_H__
+#define SCAN_URLENCODED_QUERY_H__
+
+#include <stddef.h>
+#include <stdint.h>
+#include <sys/types.h>
+
+typedef struct {
+  const char *key;
+  int         value;
+} ot_keywords;
+
+typedef enum {
+  SCAN_PATH                  = 1,
+  SCAN_SEARCHPATH_PARAM      = 2,
+  SCAN_SEARCHPATH_VALUE      = 4,
+  SCAN_SEARCHPATH_TERMINATOR = 8
+} SCAN_SEARCHPATH_FLAG;
+
+/* string     in: pointer to source
+              out: pointer to next scan position
+   deststring pointer to destination
+   flags      determines, what to parse
+   returns    number of valid converted characters in deststring
+              or -1 for parse error
+              or -2 for terminator found
+*/
+ssize_t urlencoded_parse(char **string, char *deststring, SCAN_SEARCHPATH_FLAG flags);
+
+/* string     in: pointer to source
+              out: pointer to next scan position
+   flags      determines, what to parse
+   returns    value for matched keyword
+              or -1 for parse error
+              or -2 for terminator found
+              or -3 for no keyword matched
+ */
+int     urlencoded_match_keyword(const ot_keywords *keywords, char **string, SCAN_SEARCHPATH_FLAG flags);
+
+/* string     in: pointer to value of a param=value pair to skip
+              out: pointer to next scan position on return
+*/
+void    urlencoded_skip_value(char **string);
+
+/* data       pointer to len chars of string
+ len        length of chars in data to parse
+ number     number to receive result
+ returns    number of bytes not parsed, mostly !=0 means fail
+ */
+ssize_t scan_fixed_int(char *data, size_t len, int *number);
+
+/* The other direction: percent encode len bytes from src into dest and return
+   how many characters were written. dest needs room for three times len. */
+size_t  urlencoded_format(char *dest, const uint8_t *src, size_t len);
+
+#endif
-- 
cgit v1.3