Merge commit 'upstream/1.4.8'

Conflicts:
	debian/changelog
	debian/control
	debian/libconfig++9-dev.install
	debian/libconfig8.install
	debian/libconfig9-dev.install
	debian/rules

1 files changed, 115 insertions, 0 deletions

diff --git a/examples/c/example1.c b/examples/c/example1.c
new file mode 100644
index 0000000..5c776a8
--- /dev/null
+++ b/examples/c/example1.c
@@ -0,0 +1,115 @@
+/* ----------------------------------------------------------------------------
+   libconfig - A library for processing structured configuration files
+   Copyright (C) 2005-2010  Mark A Lindner
+
+   This file is part of libconfig.
+
+   This library is free software; you can redistribute it and/or
+   modify it under the terms of the GNU Lesser General Public License
+   as published by the Free Software Foundation; either version 2.1 of
+   the License, or (at your option) any later version.
+
+   This library 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
+   Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Library General Public
+   License along with this library; if not, see
+   <http://www.gnu.org/licenses/>.
+   ----------------------------------------------------------------------------
+*/
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <libconfig.h>
+
+/* This example reads the configuration file 'example.cfg' and displays
+ * some of its contents.
+ */
+
+int main(int argc, char **argv)
+{
+  config_t cfg;
+  config_setting_t *setting;
+  const char *str;
+
+  config_init(&cfg);
+
+  /* Read the file. If there is an error, report it and exit. */
+  if(! config_read_file(&cfg, "example.cfg"))
+  {
+    fprintf(stderr, "%s:%d - %s\n", config_error_file(&cfg),
+            config_error_line(&cfg), config_error_text(&cfg));
+    config_destroy(&cfg);
+    return(EXIT_FAILURE);
+  }
+
+  /* Get the store name. */
+  if(config_lookup_string(&cfg, "name", &str))
+    printf("Store name: %s\n\n", str);
+  else
+    fprintf(stderr, "No 'name' setting in configuration file.\n");
+
+  /* Output a list of all books in the inventory. */
+  setting = config_lookup(&cfg, "inventory.books");
+  if(setting != NULL)
+  {
+    int count = config_setting_length(setting);
+    int i;
+
+    printf("%-30s  %-30s   %-6s  %s\n", "TITLE", "AUTHOR", "PRICE", "QTY");
+
+    for(i = 0; i < count; ++i)
+    {
+      config_setting_t *book = config_setting_get_elem(setting, i);
+
+      /* Only output the record if all of the expected fields are present. */
+      const char *title, *author;
+      double price;
+      int qty;
+
+      if(!(config_setting_lookup_string(book, "title", &title)
+           && config_setting_lookup_string(book, "author", &author)
+           && config_setting_lookup_float(book, "price", &price)
+           && config_setting_lookup_int(book, "qty", &qty)))
+        continue;
+
+      printf("%-30s  %-30s  $%6.2f  %3d\n", title, author, price, qty);
+    }
+    putchar('\n');
+  }
+
+  /* Output a list of all movies in the inventory. */
+  setting = config_lookup(&cfg, "inventory.movies");
+  if(setting != NULL)
+  {
+    unsigned int count = config_setting_length(setting);
+    unsigned int i;
+
+    printf("%-30s  %-10s   %-6s  %s\n", "TITLE", "MEDIA", "PRICE", "QTY");
+    for(i = 0; i < count; ++i)
+    {
+      config_setting_t *movie = config_setting_get_elem(setting, i);
+
+      /* Only output the record if all of the expected fields are present. */
+      const char *title, *media;
+      double price;
+      int qty;
+
+      if(!(config_setting_lookup_string(movie, "title", &title)
+           && config_setting_lookup_string(movie, "media", &media)
+           && config_setting_lookup_float(movie, "price", &price)
+           && config_setting_lookup_int(movie, "qty", &qty)))
+        continue;
+
+      printf("%-30s  %-10s  $%6.2f  %3d\n", title, media, price, qty);
+    }
+    putchar('\n');
+  }
+
+  config_destroy(&cfg);
+  return(EXIT_SUCCESS);
+}
+
+/* eof */