mdbx: add tutorial/sample-mdbx.c and drop obsolete sample-mdb.txt.

Also this is a testcase for https://github.com/leo-yuriev/libmdbx/issues/11.

Change-Id: I95c876b1120c1479b2e740b43f6c60e2ac8b33c1

AUTHORS

@@ -6,6 +6,7 @@ Chris Mikkelson <cmikk@qwest.net>
 Claude Brisson <claude.brisson@gmail.com>
 David Barbour <dmbarbour@gmail.com>
 David Wilson <dw@botanicus.net>
+dreamsxin <dreamsxin@126.com>
 Hallvard Furuseth <hallvard@openldap.org>, <h.b.furuseth@usit.uio.no>
 Heiko Becker <heirecka@exherbo.org>
 Howard Chu <hyc@openldap.org>, <hyc@symas.com>

Makefile

@@ -53,10 +53,13 @@ TEST_OBJ	:= $(patsubst %.cc,%.o,$(TEST_SRC))
 
 .PHONY: mdbx all install clean check coverage
 
-all: $(LIBRARIES) $(TOOLS) test/test
+all: $(LIBRARIES) $(TOOLS) test/test example
 
 mdbx: libmdbx.a libmdbx.so
 
+example: mdbx.h tutorial/sample-mdbx.c libmdbx.so
+	$(CC) $(CFLAGS) -I. tutorial/sample-mdbx.c ./libmdbx.so -o example
+
 tools: $(TOOLS)
 
 install: $(LIBRARIES) $(TOOLS) $(HEADERS)

libmdbx.files

@@ -1,3 +1,4 @@
+tutorial/sample-mdbx.c
 AUTHORS
 LICENSE
 Makefile

tutorial/sample-mdb.txt

@@ -1,66 +0,0 @@
-/* sample-mdb.txt - MDB toy/sample
- *
- * Do a line-by-line comparison of this and sample-bdb.txt
- */
-
-/*
- * Copyright 2015-2017 Leonid Yuriev <leo@yuriev.ru>.
- * Copyright 2012-2015 Howard Chu, Symas Corp.
- * Copyright 2015,2016 Peter-Service R&D LLC.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted only as authorized by the OpenLDAP
- * Public License.
- *
- * A copy of this license is available in the file LICENSE in the
- * top-level directory of the distribution or, alternatively, at
- * <http://www.OpenLDAP.org/license.html>.
- */
-
-#include <stdio.h>
-#include "mdbx.h"
-
-int main(int argc,char * argv[])
-{
-	int rc;
-	MDBX_env *env;
-	MDBX_dbi dbi;
-	MDBX_val key, data;
-	MDBX_txn *txn;
-	MDBX_cursor *cursor;
-	char sval[32];
-
-	/* Note: Most error checking omitted for simplicity */
-
-	rc = mdbx_env_create(&env);
-	rc = mdbx_env_open(env, "./testdb", 0, 0664);
-	rc = mdbx_txn_begin(env, NULL, 0, &txn);
-	rc = mdbx_dbi_open(txn, NULL, 0, &dbi);
-
-	key.iov_len = sizeof(int);
-	key.iov_base = sval;
-	data.iov_len = sizeof(sval);
-	data.iov_base = sval;
-
-	sprintf(sval, "%03x %d foo bar", 32, 3141592);
-	rc = mdbx_put(txn, dbi, &key, &data, 0);
-	rc = mdbx_txn_commit(txn);
-	if (rc) {
-		fprintf(stderr, "mdbx_txn_commit: (%d) %s\n", rc, mdbx_strerror(rc));
-		goto leave;
-	}
-	rc = mdbx_txn_begin(env, NULL, MDBX_RDONLY, &txn);
-	rc = mdbx_cursor_open(txn, dbi, &cursor);
-	while ((rc = mdbx_cursor_get(cursor, &key, &data, MDBX_NEXT)) == 0) {
-		printf("key: %p %.*s, data: %p %.*s\n",
-			key.iov_base,  (int) key.iov_len,  (char *) key.iov_base,
-			data.iov_base, (int) data.iov_len, (char *) data.iov_base);
-	}
-	mdbx_cursor_close(cursor);
-	mdbx_txn_abort(txn);
-leave:
-	mdbx_dbi_close(env, dbi);
-	mdbx_env_close(env);
-	return 0;
-}

tutorial/sample-mdbx.c

@@ -0,0 +1,89 @@
+/* sample-mdb.txt - MDB toy/sample
+ *
+ * Do a line-by-line comparison of this and sample-bdb.txt
+ */
+
+/*
+ * Copyright 2017 Ilya Shipitsin <chipitsine@gmail.com>.
+ * Copyright 2015-2017 Leonid Yuriev <leo@yuriev.ru>.
+ * Copyright 2012-2015 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+
+#include "mdbx.h"
+#include <stdio.h>
+
+int main(int argc, char *argv[]) {
+  (void)argc;
+  (void)argv;
+
+  int rc;
+  MDBX_env *env;
+  MDBX_dbi dbi;
+  MDBX_val key, data;
+  MDBX_txn *txn;
+  MDBX_cursor *cursor;
+  char sval[32];
+
+  rc = mdbx_env_create(&env);
+  if (rc != MDBX_SUCCESS) {
+    fprintf(stderr, "mdbx_env_create: (%d) %s\n", rc, mdbx_strerror(rc));
+    return 0;
+  }
+  rc = mdbx_env_open(env, "./example-db",
+                     MDBX_NOSUBDIR | MDBX_COALESCE | MDBX_LIFORECLAIM, 0664);
+  if (rc != MDBX_SUCCESS) {
+    mdbx_env_close(env);
+    fprintf(stderr, "mdbx_env_open: (%d) %s\n", rc, mdbx_strerror(rc));
+    return 0;
+  }
+
+  rc = mdbx_txn_begin(env, NULL, 0, &txn);
+  if (rc != MDBX_SUCCESS) {
+    fprintf(stderr, "mdbx_txn_begin: (%d) %s\n", rc, mdbx_strerror(rc));
+    goto leave;
+  }
+  rc = mdbx_dbi_open(txn, NULL, 0, &dbi);
+  if (rc != MDBX_SUCCESS) {
+    fprintf(stderr, "mdbx_dbi_open: (%d) %s\n", rc, mdbx_strerror(rc));
+    goto leave;
+  }
+
+  key.iov_len = sizeof(int);
+  key.iov_base = sval;
+  data.iov_len = sizeof(sval);
+  data.iov_base = sval;
+
+  sprintf(sval, "%03x %d foo bar", 32, 3141592);
+  rc = mdbx_put(txn, dbi, &key, &data, 0);
+  if (rc != MDBX_SUCCESS) {
+    fprintf(stderr, "mdbx_put: (%d) %s\n", rc, mdbx_strerror(rc));
+    goto leave;
+  }
+  rc = mdbx_txn_commit(txn);
+  if (rc) {
+    fprintf(stderr, "mdbx_txn_commit: (%d) %s\n", rc, mdbx_strerror(rc));
+    goto leave;
+  }
+  rc = mdbx_txn_begin(env, NULL, MDBX_RDONLY, &txn);
+  rc = mdbx_cursor_open(txn, dbi, &cursor);
+  while ((rc = mdbx_cursor_get(cursor, &key, &data, MDBX_NEXT)) == 0) {
+    printf("key: %p %.*s, data: %p %.*s\n", key.iov_base, (int)key.iov_len,
+           (char *)key.iov_base, data.iov_base, (int)data.iov_len,
+           (char *)data.iov_base);
+  }
+  mdbx_cursor_close(cursor);
+  mdbx_txn_abort(txn);
+leave:
+  mdbx_dbi_close(env, dbi);
+  mdbx_env_close(env);
+  return 0;
+}