Merge uaudio stragglers.

[disorder] / lib / kvp.h

/*
 * This file is part of DisOrder.
 * Copyright (C) 2004, 2005, 2007, 2008 Richard Kettlewell
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
/** @file lib/kvp.h
 * @brief Linked list of key-value pairs
 */

#ifndef KVP_H
#define KVP_H

struct dynstr;
struct sink;

/** @brief Linked list of key-value pairs */
struct kvp {
  /** @brief Next entry */
  struct kvp *next;

  /** @brief Name
   *
   * Might not be unique.  Must not be null.
   */
  const char *name;

  /** @brief Value
   *
   * Must not be null.
   */
  const char *value;
};

struct kvp *kvp_urldecode(const char *ptr, size_t n);
/* url-decode [ptr,ptr+n) */

char *kvp_urlencode(const struct kvp *kvp, size_t *np);
/* url-encode @kvp@ into a null-terminated string.  If @np@ is not
 * null return the length thru it. */

int kvp_set(struct kvp **kvpp, const char *name, const char *value);
/* set @name@ to @value@.  If @value@ is 0, remove @name@.
 * Returns 1 if we made a real change, else 0. */

const char *kvp_get(const struct kvp *kvp, const char *name);
/* Get the value of @name@ */

int urldecode(struct sink *sink, const char *ptr, size_t n);
/* url-decode the @n@ bytes at @ptr@, writing the results to @s@.
 * Return 0 on success, -1 on error. */

int urlencode(struct sink *sink, const char *s, size_t n);
/* url-encode the @n@ bytes at @s@, writing to @sink@.  Return 0 on
 * success, -1 on error.  */

char *urlencodestring(const char *s);
/* return the url-encoded form of @s@ */

char *urldecodestring(const char *s, size_t ns);
struct kvp *kvp_make(const char *key, ...);

#endif /* KVP_H */

/*
Local Variables:
c-basic-offset:2
comment-column:40
End:
*/