Update documentation/manual.rst

documentation/manual.rst

@@ -81,6 +81,7 @@ Exemplos
 Sequential access
 ~~~~~~~~~~~~~~~~~
 
+
 .. code-block:: cpp
    :linenos:
    
@@ -98,7 +99,50 @@ Sequential access
       std::cout << stream() << std::endl;
 
 
+Access using iterators
+~~~~~~~~~~~~~~~~~~~~~~
+
+
+.. code-block:: cpp
+   :linenos:
+   
+   #include <random_iterator/Stream.hpp>
+   #include <random>
+   
+   ...
+
+   random_iterator::squares4_128        rng(0x548c9decbce65295);
+   std::uniform_int_distribution<double> distribution(0.0, 1.0);
+   
+   auto its = random_iterator::make_stream( distribution, rng, 0 ).begin();
+   
+   for(size_t i=0; i<10; ++i)
+      std::cout << *(its++) << std::endl;
+
+
+
+Access using range semantics 
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+.. code-block:: cpp
+   :linenos:
+   
+   #include <random_iterator/Stream.hpp>
+   #include <random>
+   
+   ...
 
+   random_iterator::squares4_128        rng(0x548c9decbce65295);
+   std::uniform_int_distribution<double> distribution(0.0, 1.0);
+   
+   auto stream = random_iterator::make_stream( distribution, rng, 0 );
+   size_t i=0;
+   for(auto x: stream )
+   {
+      std::cout << x << std::endl;
+      if( ++i > 10) break;
+   }