bireader 1.0.4 → 1.0.5

package/README.md

@@ -173,6 +173,16 @@ Common functions for setup and movement shared by both (unless indicated).
   <tr>
     <td>Aliases</td>
     <td>clip(startOffset, endOffset)<br>truncate(startOffset, endOffset)<br>slice(startOffset, endOffset)</td>
+  </tr>
+   <tr>
+    <td>Name</td>
+    <td>extract(<b>length</b>)</td>
+    <td align="center" rowspan="2">length of data from current position</td>
+    <td rowspan="2">Returns data from current read position to supplied length. <br><b>Note:</b> Does not affect supplied data or current read position.</td>
+  </tr>
+  <tr>
+    <td>Aliases</td>
+    <td>wrap(<b>length</b>)<br>lift(<b>length</b>)</td>
   </tr>
   <tr>
     <td>Name</td>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bireader",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Read and write data in binary",
   "main": "index.js",
   "directories": {

package/src/reader.js

@@ -148,6 +148,18 @@ class bireader {
     clip = this.crop = this.truncate = this.slice = function(startOffset, endOffset){
         return this.data.slice(startOffset || 0, endOffset || this.offset)
     }
+
+     /**
+    * Extract array from current position to length supplied
+    * Note: Does not affect supplied data
+    * @param {number} length - length of data to copy from current offset
+    */
+    extract = this.wrap = this.lift = function(length){
+        if(this.offset + (length ||0) > this.size){
+            throw new Error("End offset outside of data: " + this.size)
+        }
+        return this.data.slice(this.offset, this.offset + (length ||0))
+    }
     
     /**
     * Returns current data

package/src/writer.js

@@ -213,6 +213,23 @@ class biwriter {
         }
         return this.data.slice(Math.abs(startOffset || 0), endOffset || this.offset)
     }
+
+    /**
+    * Extract array from current position to length supplied
+    * Note: Does not affect supplied data
+    * Note: Will extend array if strict mode is off
+    * @param {number} length - length of data to copy from current offset
+    */
+    extract = this.wrap = this.lift = function(length){
+        if(this.offset + (length ||0) > this.size){
+            if(this.strict == false){
+                this.extendArray(this.offset + (length ||0) - this.size)
+            } else {
+                throw new Error("End offset outside of data: " + this.size)
+            }
+        }
+        return this.data.slice(this.offset, this.offset + (length ||0))
+    }
     
     /**
     * Returns current data