dolphindb 3.0.39 → 3.0.40

package/README.zh.md

@@ -64,20 +64,23 @@ https://www.npmjs.com/package/dolphindb
 
 ##### 1. 安装
 
-1.1. 在机器上安装最新版的 Node.js 及浏览器。
-    - windows: https://nodejs.org/en/download/current/
-    - linux: https://github.com/nodesource/distributions?tab=readme-ov-file#debian-and-ubuntu-based-distributions
+1.1. 在机器上安装最新版的 Node.js 及浏览器。  
+- windows: https://nodejs.org/en/download/prebuilt-installer/current
+- linux: https://github.com/nodesource/distributions?tab=readme-ov-file#debian-and-ubuntu-based-distributions  
+
 1.2. （可选）使用以下命令创建新项目。如果已有项目，可跳过此步。
-    ```bash
-    mkdir dolphindb-example
-    cd dolphindb-example
-    npm init --yes
-    ```
+```bash
+mkdir dolphindb-example
+cd dolphindb-example
+npm init --yes
+```
+
 1.3. 用编辑器打开 package.json 文件，在 `"main": "./index.js"` 下方加入一行 "type": "module", 这样能够启用 ECMAScript modules，在后面代码中可以使用 `import { DDB } from 'dolphindb'` 导入 npm 包。
+
 1.4. 在项目中安装 npm 包。
-    ```bash
-    npm install dolphindb
-    ```
+```bash
+npm install dolphindb
+```
 
 ##### 2. 使用
 

package/browser.d.ts

@@ -330,7 +330,7 @@ export declare class DdbObj<TValue extends DdbValue = DdbValue> {
     pack(): Uint8Array;
     static pack_vector_body(value: DdbVectorValue, type: DdbType, length: number): ArrayBufferView[];
     /** 将 DdbObj 转换为 js 原生数据类型
-        - 标量对应 number, bigint 或者字符串
+        - 标量对应 number, bigint 或者字符串 (其中时间类型转换为常用的字符串表示)
         - 数组对应 js 原生数组
         - 表格对应 DdbTableData
         - 矩阵对应 DdbMatrixData

package/browser.js

@@ -1068,6 +1068,38 @@ export class DdbObj {
                         ...DdbObj.pack_vector_body(data, this.type, this.rows * this.cols)
                     ];
                 }
+                case DdbForm.tensor: {
+                    const { le, value } = this;
+                    const { tensor_type, device_type, tensor_flags, dimensions, shape, strides, preserve_value, elem_count, data } = value;
+                    // 计算总的字节长度
+                    const totalLength = 10 + dimensions * 8 * 2 + 8 + 8 + data.length; // 12 字节元数据 + 维度信息 + 保留值和元素数量 + 数据部分
+                    const buffer = new ArrayBuffer(totalLength);
+                    const dv = new DataView(buffer);
+                    const uint8Array = new Uint8Array(buffer);
+                    // 写入元数据
+                    // uint8Array[0] = type;
+                    // uint8Array[1] = form;
+                    uint8Array[0] = tensor_type;
+                    uint8Array[1] = device_type;
+                    dv.setUint32(2, tensor_flags, le);
+                    dv.setInt32(6, dimensions, le);
+                    // 写入形状和步长
+                    const shapeStart = 10;
+                    const stridesStart = shapeStart + dimensions * 8;
+                    for (let d = 0; d < dimensions; d++) {
+                        dv.setBigInt64(shapeStart + d * 8, BigInt(shape[d]), le);
+                        dv.setBigInt64(stridesStart + d * 8, BigInt(strides[d]), le);
+                    }
+                    // 写入保留值和元素数量
+                    const preserveValueStart = stridesStart + dimensions * 8;
+                    dv.setBigInt64(preserveValueStart, preserve_value, le);
+                    const storageStart = preserveValueStart + 8;
+                    dv.setBigInt64(storageStart, BigInt(elem_count), le);
+                    // 写入数据
+                    const dataStart = storageStart + 8;
+                    uint8Array.set(data, dataStart);
+                    return [uint8Array];
+                }
                 default:
                     throw new Error(t('vector {{type}} 暂不支持序列化', { type: get_type_name(type) }));
             }