/* Copyright (C) 2007-2008 The Android Open Source Project
**
** This software is licensed under the terms of the GNU General Public
** License version 2, as published by the Free Software Foundation, and
** may be copied, distributed, and modified under those terms.
**
** 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.
*/

#pragma once

#include "android/utils/compiler.h"

ANDROID_BEGIN_HEADER

/** ANDROID CONFIGURATION FILE SUPPORT
 **
 ** A configuration file is loaded as a simplre tree of (key,value)
 ** pairs. keys and values are simple strings
 **/
typedef struct AConfig  AConfig;

struct AConfig
{
    AConfig*     next;
    AConfig*     first_child;
    AConfig*     last_child;
    const char*  name;
    const char*  value;
};

/* parse a text string into a config node tree */
extern void   aconfig_load(AConfig*  root, char*  data);

/* parse a file into a config node tree, return 0 in case of success, -1 otherwise */
extern int    aconfig_load_file(AConfig*  root, const char*  path);

/* save a config node tree into a file, return 0 in case of success, -1 otherwise */
extern int aconfig_save_file(const AConfig* root, const char* path);

/* create a single config node */
extern AConfig*  aconfig_node(const char *name, const char *value);

/* locate a named child of a config node */
extern const AConfig* aconfig_find_const(const AConfig* root, const char* name);

/* locate a named child of a config node. NULL if it doesn't exist. */
extern AConfig* aconfig_find(AConfig* root, const char* name);

/* add a named child to a config node (or modify it if it already exists) */
extern void aconfig_set(AConfig* root, const char* name, const char* value);

/* look up a child by name and return its value, eventually converted
 * into a boolean or integer */
extern int aconfig_bool(const AConfig* root, const char* name, int _default);
extern unsigned aconfig_unsigned(const AConfig* root,
                                 const char* name,
                                 unsigned _default);
extern int aconfig_int(const AConfig* root, const char* name, int _default);
extern const char* aconfig_str(const AConfig* root,
                               const char* name,
                               const char* _default);

/* Recusively destroy a node and its children. */
extern void aconfig_node_free(AConfig *root);

ANDROID_END_HEADER