dolphindb 3.1.53 → 3.1.55

package/index.d.ts

@@ -168,12 +168,14 @@ export interface InspectOptions extends UtilInspectOptions {
     colors?: boolean;
     /** `null` decimal places 小数位数 */
     decimals?: number;
+    /** `在 format 中默认为 false，在 inspect 中默认为 true` 决定 null 值如何返回. nullstr ? 'null' : '' */
+    nullstr?: boolean;
     /** `true` 决定格式化后的数据是否有千分位 */
     grouping?: boolean;
     /** timestamp 类型转换为字符串表示时显示到秒还是毫秒 */
     timestamp?: 's' | 'ms';
 }
-/** 根据 DdbType 格式化单个元素 (value) 为字符串，空值返回 'null' 字符串 */
+/** 根据 DdbType 格式化单个元素 (value) 为字符串，空值根据 nullstr 选项返回 'null' / '' 字符串 */
 export declare function format(type: DdbType, value: DdbValue, le: boolean, options?: InspectOptions): string;
 /** 格式化向量、集合中的第 index 项为字符串，空值返回 'null' 字符串  formatted vector, the index-th item in the collection is a string, a null value returns a 'null' string */
 export declare function formati(obj: DdbVectorObj, index: number, options?: InspectOptions): string;

package/index.js

@@ -1564,12 +1564,18 @@ export class DdbObj {
     }
 }
 const gray_nullstr = 'null'.gray;
+function get_nullstr(options) {
+    return options.nullstr ?
+        options.colors ? gray_nullstr : 'null'
+        :
+            '';
+}
 function format_time(type, value, options) {
     if (value === null ||
         value === ((type === DdbType.timestamp ||
             type === DdbType.nanotime ||
             type === DdbType.nanotimestamp) ? nulls.int64 : nulls.int32))
-        return options.colors ? gray_nullstr : 'null';
+        return get_nullstr(options);
     let str;
     // formatter 可能会在 value 不属于 new Date() 有效值时，调用  抛出错误，这里统一处理
     try {
@@ -1588,25 +1594,32 @@ function format_time(type, value, options) {
 }
 function format_number(type, value, options) {
     return value === null || value === number_nulls.get(type) ?
-        options.colors ? gray_nullstr : 'null'
+        get_nullstr(options)
         : colored(get_number_formatter(type === DdbType.int || type === DdbType.long || type === DdbType.short, options.decimals, options.grouping).format(value), 'green', options.colors);
 }
-/** 根据 DdbType 格式化单个元素 (value) 为字符串，空值返回 'null' 字符串 */
+/** 根据 DdbType 格式化单个元素 (value) 为字符串，空值根据 nullstr 选项返回 'null' / '' 字符串 */
 export function format(type, value, le, options = {}) {
     switch (type) {
-        case DdbType.void: {
-            const str = value === DdbVoidType.default ? 'default' : 'null';
-            return options.colors ? str.gray : str;
-        }
-        case DdbType.bool:
-            return inspect((value === null || value === nulls.int8) ?
-                null
+        case DdbType.void:
+            return options.nullstr ?
+                value === DdbVoidType.default ?
+                    options.colors ? 'default'.gray : 'default'
+                    :
+                        options.colors ? gray_nullstr : 'null'
                 :
-                    Boolean(value), options);
+                    '';
+        case DdbType.bool:
+            if (value === null || value === nulls.int8)
+                return get_nullstr(options);
+            else {
+                const str = String(Boolean(value));
+                return options.colors ? str.blue : str;
+            }
         case DdbType.char:
-            return inspect((value === null || value === nulls.int8) ?
-                null
+            return value === null || value === nulls.int8 ?
+                get_nullstr(options)
                 :
+                    inspect(
                     // ascii printable
                     // http://facweb.cs.depaul.edu/sjost/it212/documents/ascii-pr.htm
                     (32 <= value && value <= 126) ?
@@ -1678,13 +1691,13 @@ export function format(type, value, le, options = {}) {
             const { scale, data } = value;
             if (data === null ||
                 is_decimal_null_value(type, data))
-                return 'null';
+                return get_nullstr(options);
             const s = String(data < 0 ? -data : data).padStart(scale, '0');
             const str = (data < 0 ? '-' : '') + (scale ? `${s.slice(0, -scale) || '0'}.${s.slice(-scale)}` : s);
             return options.colors ? str.green : str;
         }
         default:
-            return inspect(value, options);
+            return value === null ? get_nullstr(options) : inspect(value, options);
     }
 }
 /** 格式化向量、集合中的第 index 项为字符串，空值返回 'null' 字符串  formatted vector, the index-th item in the collection is a string, a null value returns a 'null' string */
@@ -1858,7 +1871,8 @@ export function convert(type, value, le, { blob = 'string', char = 'string', tim
         case DdbType.decimal32:
         case DdbType.decimal64:
         case DdbType.decimal128:
-            return format(type, value, le, { colors: false, timestamp });
+            // 将表示 format 返回的表示空值的空字符串 '' 转为 null
+            return format(type, value, le, { colors: false, timestamp }) || null;
         default:
             throw new Error(String(DdbType[type] || type) + t(' 暂时不支持转换为 js 对象'));
     }