Importing Scalar-Vec-Util-0.03.tar.gz

[perl/modules/Scalar-Vec-Util.git] / README

diff --git a/README b/README
index 69aa06bc0b036be56553a43c7ad6eaeb633381a2..ca8ba6bc9f083dde901208b6a0abdf73fe68dfe6 100644 (file)
--- a/README
+++ b/README
@@ -2,7 +2,7 @@ NAME
     Scalar::Vec::Util - Utility routines for vec strings.
 
 VERSION
-    Version 0.02
+    Version 0.03
 
 SYNOPSIS
         use Scalar::Vec::Util qw/vfill vcopy veq/;
@@ -56,6 +56,37 @@ EXPORT
     The constants "SVU_PP" and "SVU_SIZE" are also only exported on request.
     They are all exported by the tags ':consts' and ':all'.
 
+BENCHMARKS
+    The following timings were obtained by running the "samples/bench.pl"
+    script with perl 5.8.8 on a Core 2 Duo 2.66GHz machine. The "_pp"
+    entries are the pure Perl versions, while "_bv" are Bit::Vector
+    versions.
+
+    Filling bits at a given position :
+                          Rate vfill_pp vfill_bv    vfill
+            vfill_pp    80.3/s       --    -100%    -100%
+            vfill_bv 1053399/s 1312401%       --     -11%
+            vfill    1180792/s 1471129%      12%       --
+
+    Copying bits from a bit vector to a different one :
+                         Rate vcopy_pp vcopy_bv    vcopy
+            vcopy_pp    112/s       --    -100%    -100%
+            vcopy_bv  62599/s   55622%       --     -89%
+            vcopy    558491/s  497036%     792%       --
+
+    Moving bits in the same bit vector from a given position to a different
+    one :
+                         Rate vmove_pp vmove_bv    vmove
+            vmove_pp   64.8/s       --    -100%    -100%
+            vmove_bv  64742/s   99751%       --     -88%
+            vmove    547980/s  845043%     746%       --
+
+    Testing bit equality from different positions of different bit vectors :
+                       Rate  veq_pp  veq_bv     veq
+            veq_pp   92.7/s      --   -100%   -100%
+            veq_bv  32777/s  35241%      --    -94%
+            veq    505828/s 545300%   1443%      --
+
 CAVEATS
     Please report architectures where we can't use the alignment as the move
     unit. I'll add exceptions for them.