dolphindb 2.0.600 → 2.0.601

package/index.d.ts

@@ -229,7 +229,10 @@ export declare class DdbObj<T extends DdbValue = DdbValue> {
         deep?: boolean;
     }): T;
 }
+/** Formats a single element (value) as a string according to DdbType, null returns a 'null' string */
 export declare function format(type: DdbType, value: DdbValue, le: boolean, options: InspectOptions): string;
+/** formatted vector, the index-th item in the collection is a string, a null value returns a 'null' string */
+export declare function formati(obj: DdbObj<DdbVectorValue>, index: number, options: InspectOptions): string;
 export declare class DdbVoid extends DdbObj<undefined> {
     constructor();
 }

package/index.js

@@ -1179,6 +1179,7 @@ export class DdbObj {
         return obj;
     }
 }
+/** Formats a single element (value) as a string according to DdbType, null returns a 'null' string */
 export function format(type, value, le, options) {
     switch (type) {
         case DdbType.bool:
@@ -1364,6 +1365,66 @@ export function format(type, value, le, options) {
             return inspect(value, options);
     }
 }
+/** formatted vector, the index-th item in the collection is a string, a null value returns a 'null' string */
+export function formati(obj, index, options) {
+    if (64 <= obj.type && obj.type < 128) { // array vector
+        // 因为 array vector 目前只支持：Logical, Integral（不包括 INT128, COMPRESS 类型）, Floating, Temporal
+        // 都对应 TypedArray 中的一格，所以 lengths.length 等于 block 中的 row 的个数
+        // av = array(INT[], 0, 5)
+        // append!(av, [1..1])
+        // append!(av, [1..70000])
+        // append!(av, [1..1])
+        // append!(av, [1..500])
+        // ...
+        // av
+        const _type = obj.type - 64;
+        let offset = 0;
+        for (const { lengths, data, rows } of obj.value) {
+            let acc_len = 0;
+            if (offset + rows <= index) {
+                offset += rows;
+                continue; // 跳过这个 block
+            }
+            for (const length of lengths) {
+                if (offset < index) {
+                    offset++;
+                    acc_len += length;
+                    continue;
+                }
+                const limit = 10;
+                let items = new Array(Math.min(limit, length));
+                for (let i = 0; i < items.length; i++)
+                    items[i] = format(_type, data[acc_len + i], obj.le, options);
+                return (items.join(', ') + (length > limit ? ', ...' : '')).bracket('square');
+            }
+        }
+    }
+    switch (obj.type) {
+        case DdbType.string:
+        case DdbType.symbol:
+            return obj.value[index];
+        case DdbType.symbol_extended: {
+            const { base, data } = obj.value;
+            return base[data[index]];
+        }
+        case DdbType.uuid:
+        case DdbType.int128:
+        case DdbType.ipaddr:
+            return format(obj.type, obj.value.subarray(16 * index, 16 * (index + 1)), obj.le, options);
+        case DdbType.blob: {
+            const value = obj.value[index];
+            return value.length > 100 ?
+                DdbObj.dec.decode(value.subarray(0, 98)) + '…'
+                :
+                    DdbObj.dec.decode(value);
+        }
+        case DdbType.complex:
+        case DdbType.point:
+            return format(obj.type, obj.value.subarray(2 * index, 2 * (index + 1)), obj.le, options);
+        default:
+            return format(obj.type, obj.value[index], obj.le, options);
+    }
+}
 export class DdbVoid extends DdbObj {
     constructor() {
         super({