Buffer readuint8 (#11)

* [Implement] Buffer.readUInt8 * [Cleanup] Removing readInt8 Clearing out a stray piece of code left over from a different branch.

Author: RedDwarfian

assembly/buffer/index.ts

@@ -23,6 +23,11 @@ export class Buffer extends Uint8Array {
  return result;
  }
 
+ readUInt8(offset: i32 = 0): u8 {
+ if(<u32>offset > this.dataLength) throw new RangeError(E_INDEXOUTOFRANGE);
+ return load<u8>(this.dataStart + usize(offset));
+ }
+
  writeUInt8(value: u8, offset: i32 = 0): i32 {
  if(<u32>offset > this.dataLength) throw new RangeError(E_INDEXOUTOFRANGE);
  store<u8>(this.dataStart + offset, value);

assembly/node.d.ts

@@ -3,6 +3,8 @@ declare class Buffer extends Uint8Array {
  static alloc(size: i32): Buffer;
  /** This method allocates a new Buffer of indicated size. This is unsafe because the data is not zeroed. */
  static allocUnsafe(size: i32): Buffer;
+ /** Reads an unsigned integer at the designated offset. */
+ readUInt8(offset?: i32): u8;
  /** Writes an inputted u8 value to the buffer, at the desired offset. */
  writeUInt8(value:u8, offset?:i32): i32;
  /** Writes an inputted value to the buffer, at the desired offset. */

tests/buffer.spec.ts

@@ -43,6 +43,22 @@ describe("buffer", () => {
  // TODO: expectFn(() => { Buffer.allocUnsafe(BLOCK_MAXSIZE + 1); }).toThrow();
  });
 
+ test("#readUInt8", () => {
+ let buff = new Buffer(10);
+ buff[0] = -2;
+ buff[9] = 47;
+ // Testing casting between u8 and i8.
+ expect<u8>(buff.readUInt8(0)).toBe(254);
+ expect<u8>(buff.readUInt8()).toBe(254);
+ // Testing offset
+ expect<u8>(buff.readUInt8(9)).toBe(47);
+ // TODO:
+ // expectFn(() => { 
+ // let newBuff = new Buffer(1);
+ // newBuff.readUInt8(5);
+ // }).toThrow(); 
+ });
+
  test("#writeUInt8", () => {
  let buff = new Buffer(5);
  expect<i32>(buff.writeUInt8(4)).toBe(1);
@@ -72,5 +88,5 @@ describe("buffer", () => {
  // let newBuff = new Buffer(1);
  // newBuff.readInt8(5);
  // }).toThrow();
- })
+ });
 });