feat: add set method.

Author: ghosind

src/dynamicBuffer.ts

@@ -1,7 +1,7 @@
 import { constants } from 'buffer';
 
 import { DynamicBufferIterator } from './iterator';
-import { checkRange, swap } from './utils';
+import { checkBounds, checkRange, swap } from './utils';
 
 /**
  * The character encoding that is supported by Node.js, copy from Node.js Buffer module.
@@ -625,6 +625,24 @@ export class DynamicBuffer {
     return this;
   }
 
+  /**
+   * Sets a value or an array of values.
+   *
+   * @param array A typed or untyped array of values to set.
+   * @param offset The index in the current array at which the values are to be written.
+   */
+  set(array: ArrayLike<number>, offset: number = 0): void {
+    if (array.length > 0) {
+      checkBounds('offset', offset, 0, this.length - array.length);
+    }
+
+    if (!this.buffer || this.length <= 0) {
+      return;
+    }
+
+    this.subarray(0, this.length).set(array, offset);
+  }
+
   /**
    * Returns a new Buffer that references the same memory as the original, but offset and cropped
    * by the start and end indices.

test/write.spec.ts

@@ -209,3 +209,38 @@ describe('Write tests', () => {
     });
   });
 });
+
+describe('Set tests', () => {
+  it('Test set', () => {
+    const buf = new DynamicBuffer('hello');
+
+    buf.set([97], 1);
+
+    assert.equal(buf.toString(), 'hallo');
+  });
+
+  it('Test set of empty buffer', () => {
+    const buf = new DynamicBuffer();
+
+    assert.doesNotThrow(() => {
+      buf.set([]);
+    });
+
+    assert.throws(() => {
+      buf.set([97]);
+    });
+  });
+
+  it('Test set offset parameter', () => {
+    const buf = new DynamicBuffer('xxxxx');
+
+    assert.doesNotThrow(() => {
+      buf.set([97, 98], 3);
+    });
+    assert.equal(buf.toString(), 'xxxab');
+
+    assert.throws(() => {
+      buf.set([97, 98], 4);
+    });
+  });
+});