@creejs/commons-lang 2.1.8 → 2.1.9

package/dist/cjs/index-dev.cjs

@@ -153,7 +153,8 @@ var TypeUtils = {
   isFloat64Array,
   isBigInt64Array,
   isBigUint64Array,
-  isTypedArray
+  isTypedArray,
+  isArrayBuffer
 };
 /**
    * Checks if the given value is an array.
@@ -483,7 +484,7 @@ function isInt32Array (value) {
 function isUint32Array (value) {
   return value instanceof Uint32Array
 }
-// export function isFloat16Array (value) {
+// function isFloat16Array (value) {
 //   return value instanceof Float16Array
 // }
 /**
@@ -519,6 +520,15 @@ function isBigUint64Array (value) {
   return value instanceof BigUint64Array
 }
 
+/**
+ * Checks if the given value is an ArrayBuffer.
+ * @param {*} value - The value to check.
+ * @returns {boolean} True if the value is an ArrayBuffer, false otherwise.
+ */
+function isArrayBuffer (value) {
+  return value instanceof ArrayBuffer
+}
+
 // 3rd
 // internal
 // owned
@@ -557,7 +567,8 @@ var TypeAssert = {
   assertFloat64Array,
   assertBigInt64Array,
   assertBigUint64Array,
-  assertTypedArray
+  assertTypedArray,
+  assertArrayBuffer
 };
 /**
    * if value is not Array, throw error
@@ -911,6 +922,18 @@ function assertBigUint64Array (value, paramName) {
   }
 }
 
+/**
+ * Asserts that the given value is an ArrayBuffer.
+ * @param {*} value - The value to check.
+ * @param {string} [paramName] - Optional parameter name for error message.
+ * @throws {Error} Throws an error if the value is not an ArrayBuffer.
+ */
+function assertArrayBuffer (value, paramName) {
+  if (!isArrayBuffer(value)) {
+    throw new Error(`${paramName ? '"' + paramName + '" ' : ' '}Not ArrayBuffer`)
+  }
+}
+
 // 3rd
 // internal
 // owned
@@ -1947,6 +1970,68 @@ function equals (src, target) {
   return true
 }
 
+var ArrayBufferUtils = {
+  readString,
+  writeString
+};
+
+// module vars
+const textDecoder = new TextDecoder();
+const textEncoder = new TextEncoder();
+/**
+ * Reads a string from an ArrayBuffer at the specified offset and length.
+ * 1. if offset >= buffer.byteLength, return undefined
+ * 2. if length is not specified, read all bytes from offset to the end of buffer
+ * 3. if length is specified
+ *   * if offset + length >= buffer.byteLength, return a Uint8Array from offset to the end of buffer
+ *   * if offset + length < buffer.byteLength, return a Uint8Array from offset to offset + length
+ * @param {ArrayBuffer} buffer - The buffer to read from.
+ * @param {number} [offset=0] - The offset in bytes to start reading from.
+ * @param {number} [length] - The number of bytes to read.
+ * @returns {string|undefined} The decoded string.
+ */
+function readString (buffer, offset = 0, length) {
+  assertArrayBuffer(buffer);
+  assertNotNegative(offset);
+  if (offset >= buffer.byteLength) {
+    return undefined
+  }
+  let uint8Array = null;
+  if (length != null) {
+    assertPositive(length);
+    if (offset + length >= buffer.byteLength) {
+      uint8Array = new Uint8Array(buffer, offset);
+    } else {
+      uint8Array = new Uint8Array(buffer, offset, length);
+    }
+  } else {
+    uint8Array = new Uint8Array(buffer, offset);
+  }
+
+  // An ArrayBuffer, a TypedArray, or a DataView object containing the encoded text to decode.
+  return textDecoder.decode(uint8Array)
+}
+
+/**
+ * Writes a string to an ArrayBuffer at the specified offset.
+ * @param {ArrayBuffer} buffer - The buffer to write to
+ * @param {string} str - The string to write
+ * @param {number} [offset=0] - The offset in bytes to start writing
+ * @returns {void}
+ */
+function writeString (buffer, str, offset = 0) {
+  assertArrayBuffer(buffer, 'buffer');
+  assertString(str, 'str');
+  assertNotNegative(offset, 'offset');
+  const uint8Array = textEncoder.encode(str);
+  const strByteLength = uint8Array.byteLength;
+  if (offset + strByteLength > buffer.byteLength) {
+    throw new Error(`offset + str.byteLength > buffer.byteLength:${offset + strByteLength} > ${buffer.byteLength}`)
+  }
+  const dataView = new Uint8Array(buffer, offset, uint8Array.byteLength);
+  dataView.set(uint8Array);
+}
+
 /**
  * @module Lang
  * @description Core language utilities for type checking, string manipulation, and common operations.
@@ -1966,9 +2051,11 @@ var index = {
   ClassProxyUtils,
   InstanceProxyUtils,
   ReflectUtils,
-  TypedArrayUtils
+  TypedArrayUtils,
+  ArrayBufferUtils
 };
 
+exports.ArrayBufferUtils = ArrayBufferUtils;
 exports.ClassProxyUtils = ClassProxyUtils;
 exports.Exec = ExecUtils;
 exports.ExecUtils = ExecUtils;