added another iteration test; (#17)

updated docs;

Author: zethon

doc/README.md

@@ -177,14 +177,37 @@ Batch reads allow you to read a batch of data sequentially stored.
 
 Here is an example of iterating all the records in a string database.
 
+Example 1 - Using Indicies
 ```cpp
 ashdb::AshDB<std::string> stringdb("stringdb");
 assert(db.opened() == false);
 assert(db.open() == ashdb::OpenStatus::OK);
 for (auto i = 0u; i < db.size(); ++i)
 {
     std::string str = db.read(i);
-    std::cout << i << ':' << str << '\n';
+    std::cout << str << '\n';
+}
+```
+
+Example 2 - Using Ranges
+```cpp
+ashdb::AshDB<std::string> stringdb("stringdb");
+assert(db.opened() == false);
+assert(db.open() == ashdb::OpenStatus::OK);
+for (auto str : db)
+{
+    std::cout << str << '\n';
+}
+```
+
+Example 3 - Using Iterators
+```cpp
+ashdb::AshDB<std::string> stringdb("stringdb");
+assert(db.opened() == false);
+assert(db.open() == ashdb::OpenStatus::OK);
+for (auto it = db.begin(); it != db.end(); ++it)
+{
+    std::cout << *it << '\n';
 }
 ```
 

tests/test_basic.cpp

@@ -508,9 +508,9 @@ BOOST_AUTO_TEST_CASE(db_size)
     BOOST_TEST(db.databaseSize() > 210);
 }
 
-BOOST_AUTO_TEST_CASE(iterator)
+BOOST_AUTO_TEST_CASE(iterator1)
 {
-    auto tempFolder = ashdb::test::tempFolder("iterator");
+    auto tempFolder = ashdb::test::tempFolder("iterator1");
 
     ashdb::Options options;
     options.filesize_max = 1024;
@@ -534,4 +534,30 @@ BOOST_AUTO_TEST_CASE(iterator)
     }
 }
 
+BOOST_AUTO_TEST_CASE(iterator2)
+{
+    auto tempFolder = ashdb::test::tempFolder("iterator2");
+
+    ashdb::Options options;
+    options.filesize_max = 1024;
+
+    ashdb::AshDB<int> db{tempFolder, options};
+    BOOST_TEST(db.open() == ashdb::OpenStatus::OK);
+
+    ashdb::AshDB<int>::Batch batch;
+
+    // create the initial 100 records
+    for (auto i = 0u; i < 100; ++i)
+    {
+        batch.push_back(i * 10);
+    }
+    BOOST_TEST(db.write(batch) == ashdb::WriteStatus::OK);
+
+    int x = 0;
+    for (auto it = db.begin(); it != db.end(); ++it)
+    {
+        BOOST_TEST(*it == (x++ * 10));
+    }
+}
+
 BOOST_AUTO_TEST_SUITE_END()