ioblockreader 1.0.2.20130613 → 1.0.3.20130618

data/AUTHORS

@@ -3,3 +3,4 @@
 * 1.0.0.20130611
 * 1.0.1.20130611
 * 1.0.2.20130613
+* 1.0.3.20130618

data/ChangeLog

@@ -1,5 +1,9 @@
 = IOBlockReader Release History
 
+== 1.0.3.20130618 (Beta)
+
+* Added get_block_containing_offset interface
+
 == 1.0.2.20130613 (Beta)
 
 * Added each_block interface

data/README.md

@@ -124,6 +124,23 @@ end
 
 ```
 
+### IOBlockReader#get_block_containing_offset(offset = 0)
+
+Get the block containing a given offset.
+This method is mainly used to provide some low-level access for processes needing great parsing performance.
+
+Parameters:
+* **offset** ( _Fixnum_ ): The offset to be accessed [default = 0]
+Return:
+* _String_ : The block of data containing this offset
+* _Fixnum_ : The beginning offset of this data block
+* _Boolean_ : Is this block the last one?
+
+Example:
+```
+str_data, begin_offset, last_one = content.get_block_containing_offset(20)
+```
+
 ## Contact
 
 Want to contribute? Have any questions? [Contact Muriel!](muriel@x-aeon.com)

data/ReleaseInfo

@@ -2,7 +2,7 @@
 # This file has been generated by RubyPackager during a delivery.
 # More info about RubyPackager: http://rubypackager.sourceforge.net
 {
-  :version => '1.0.2.20130613',
+  :version => '1.0.3.20130618',
   :tags => [ 'Beta' ],
   :dev_status => 'Beta'
 }

data/lib/ioblockreader/ioblockreader.rb

@@ -270,6 +270,31 @@ module IOBlockReader
       end
     end
 
+    # Get the block containing a given offset.
+    # This method is mainly used to provide some low-level access for processes needing great parsing performance.
+    #
+    # Parameters::
+    # * *offset* (_Fixnum_): The offset to be accessed [default = 0]
+    # Return::
+    # * _String_: The block of data containing this offset
+    # * _Fixnum_: The beginning offset of this data block
+    # * _Boolean_: Is this block the last one?
+    def get_block_containing_offset(offset = 0)
+      #puts "[IOBlockReader] - get_block_containing_offset(#{offset})"
+      # Use the cache if possible
+      return [ @cached_block.data, @cached_block.offset, @cached_block.last_block? ] if ((@cached_block != nil) and (offset >= @cached_block.offset) and (offset < @cached_block_end_offset))
+      #puts "[IOBlockReader] - get_block_containing_offset(#{offset}) - Cache miss"
+      single_block_index, _ = offset.divmod(@block_size)
+      if ((block = @blocks[single_block_index]) == nil)
+        read_needed_blocks([single_block_index], single_block_index, single_block_index)
+        block = @blocks[single_block_index]
+      else
+        block.touch
+      end
+      set_cache_block(block)
+      return block.data, block.offset, block.last_block?
+    end
+
     private
 
     # Set the new cache block

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ioblockreader
 version: !ruby/object:Gem::Version
-  version: 1.0.2.20130613
+  version: 1.0.3.20130618
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-13 00:00:00.000000000 Z
+date: 2013-06-18 00:00:00.000000000 Z
 dependencies: []
 description: Ruby library giving block-buffered and cached read over IO objects with
   a String-like interface. Ideal to parse big files as Strings, limiting memory consumption.