@yuneta/gobj-js 7.25.0 → 7.25.2

package/README.md

@@ -527,6 +527,12 @@ kw_get_str (gobj, kw, path, default_value, flag)
 kw_get_dict(gobj, kw, path, default_value, flag)
 kw_get_list(gobj, kw, path, default_value, flag)
 kw_get_dict_value(gobj, kw, path, default_value, flag)
+// A typed reader answers the value when it has the reader's type, and
+// the default AS GIVEN otherwise (absent key or other type), as in C:
+//   kw_get_list(gobj, {x: [1, 2]}, "x", [], 0)   → [1, 2]  (the same array)
+//   kw_get_dict(gobj, {}, "x", null, 0)          → null
+//   kw_get_bool(gobj, {x: "false"}, "x", true, 0) → true   (not a boolean)
+//   kw_get_bool(gobj, {x: "false"}, "x", true, KW_WILD_NUMBER) → false
 
 kw_set_dict_value(gobj, kw, path, value)
 kw_set_subdict_value(gobj, kw, path, key, value)

package/dist/gobj-js.cjs.js

@@ -3215,8 +3215,8 @@ function trace_msg(format) {
 }
 function trace_json(jn, msg) {
 	if (console_wants("json", msg)) {
-		if (msg) window.console.warn("=====> " + msg);
-		window.console.dir(jn);
+		if (msg) _console.warn("=====> " + msg);
+		_console.dir(jn);
 	}
 	emit_log_callback("json", jn, current_timestamp());
 }
@@ -3604,7 +3604,11 @@ function kw_delete(gobj, kw, path) {
 	return 0;
 }
 /************************************************************
-*
+*  As the C kw_get_bool(): a boolean found is the answer, and
+*  anything else gives the default back -- unless KW_WILD_NUMBER
+*  asks to read a number (0 is false), a string ("true"/"false"
+*  in any case, else its integer) or null (false). Before gobj-js
+*  7.25.2 the value went through Boolean(), so "false" was TRUE.
 ************************************************************/
 function kw_get_bool(gobj, kw, path, default_value, flag) {
 	if (gobj && !is_gobj(gobj)) log_error(`GObj bad instanceof`);
@@ -3612,6 +3616,7 @@ function kw_get_bool(gobj, kw, path, default_value, flag) {
 	const required = flag && flag & kw_flag_t.KW_REQUIRED;
 	const create = flag && flag & kw_flag_t.KW_CREATE;
 	const extract = flag && flag & kw_flag_t.KW_EXTRACT;
+	const wild = flag && flag & kw_flag_t.KW_WILD_NUMBER;
 	if (b === void 0) {
 		if (create) {
 			let v = Boolean(default_value);
@@ -3623,8 +3628,23 @@ function kw_get_bool(gobj, kw, path, default_value, flag) {
 		}
 		return Boolean(default_value);
 	}
+	let value;
+	if (is_boolean(b)) value = b;
+	else if (wild && is_number(b)) value = b !== 0;
+	else if (wild && is_string(b)) {
+		if (b.toLowerCase() === "true") value = true;
+		else if (b.toLowerCase() === "false") value = false;
+		else value = (parseInt(b) || 0) !== 0;
+	} else if (wild && b === null) value = false;
+	else {
+		if (required) {
+			log_error(`${gobj_short_name(gobj)}: path value MUST BE a boolean: ${path}`);
+			trace_msg(kw);
+		}
+		return Boolean(default_value);
+	}
 	if (extract) kw_delete(gobj, kw, path);
-	return Boolean(b);
+	return value;
 }
 /************************************************************
 *
@@ -3687,7 +3707,12 @@ function kw_get_real(gobj, kw, path, default_value, flag) {
 	return Number(v);
 }
 /************************************************************
-*
+*  The default comes back AS GIVEN, as in the C kw_get_str()
+*  (`const char *default_value`, where 0 is NULL). Turned into
+*  a string, a default of 0 or null was "0" or "null", which is
+*  TRUE: an `if(value)` on the answer took an absent key for a
+*  present one. KW_CREATE stores a string default, and null for
+*  any other, as C stores json_null() for a NULL default.
 ************************************************************/
 function kw_get_str(gobj, kw, path, default_value, flag) {
 	if (gobj && !is_gobj(gobj)) log_error(`GObj bad instanceof`);
@@ -3697,14 +3722,13 @@ function kw_get_str(gobj, kw, path, default_value, flag) {
 	const extract = flag && flag & kw_flag_t.KW_EXTRACT;
 	if (v === void 0) {
 		if (create) {
-			let v = String(default_value);
-			kw_set_dict_value(gobj, kw, path, v);
-			return v;
+			kw_set_dict_value(gobj, kw, path, is_string(default_value) ? default_value : null);
+			return default_value;
 		} else if (required) {
 			log_error(`path not found: '${path}'`);
 			trace_json(kw);
 		}
-		return String(default_value);
+		return default_value;
 	}
 	if (extract) kw_delete(gobj, kw, path);
 	if (!is_string(v)) {
@@ -3712,9 +3736,9 @@ function kw_get_str(gobj, kw, path, default_value, flag) {
 			log_error(`${gobj_short_name(gobj)}: path value MUST BE a string: ${path}`);
 			trace_msg(kw);
 		}
-		return String(default_value);
+		return default_value;
 	}
-	return String(v);
+	return v;
 }
 /************************************************************
 *
@@ -3740,7 +3764,11 @@ function kw_get_pointer(gobj, kw, path, default_value, flag) {
 	return v;
 }
 /************************************************************
-*
+*  As the C kw_get_dict(): a dict found is the answer, and
+*  anything else gives the default back AS GIVEN (null stays
+*  null). KW_CREATE stores a dict default, never a null one.
+*  Before gobj-js 7.25.2 the answer went through Object(), so a
+*  null default came back as {} and a 0 as a Number object.
 ************************************************************/
 function kw_get_dict(gobj, kw, path, default_value, flag) {
 	if (gobj && !is_gobj(gobj)) log_error(`GObj bad instanceof`);
@@ -3749,25 +3777,25 @@ function kw_get_dict(gobj, kw, path, default_value, flag) {
 	const create = flag && flag & kw_flag_t.KW_CREATE;
 	const extract = flag && flag & kw_flag_t.KW_EXTRACT;
 	if (v === void 0) {
-		if (create) {
-			let v = Object(default_value);
-			kw_set_dict_value(gobj, kw, path, v);
-			return v;
-		} else if (required) {
+		if (create && is_object(default_value) && kw) {
+			kw_set_dict_value(gobj, kw, path, default_value);
+			return default_value;
+		}
+		if (required) {
 			log_error(`path not found: '${path}'`);
 			trace_json(kw);
 		}
-		return Object(default_value);
+		return default_value;
 	}
-	if (extract) kw_delete(gobj, kw, path);
 	if (!is_object(v)) {
 		if (required) {
-			log_error(`path value MUST BE a dict: ${path}`);
+			log_error(`${gobj_short_name(gobj)}: path value MUST BE a dict: ${path}`);
 			trace_msg(kw);
 		}
-		return Object(default_value);
+		return default_value;
 	}
-	return Object(v);
+	if (extract) kw_delete(gobj, kw, path);
+	return v;
 }
 /************************************************************
 *
@@ -3793,7 +3821,12 @@ function kw_get_dict_value(gobj, kw, path, default_value, flag) {
 	return v;
 }
 /************************************************************
-*
+*  As the C kw_get_list(): a list found is the answer, and
+*  anything else gives the default back AS GIVEN. KW_CREATE
+*  stores a list default, never a null one. Before gobj-js
+*  7.25.2 the answer went through Array(), which WRAPS its
+*  argument: a list found came back as [list], a default of []
+*  as [[]] and a null one as [null].
 ************************************************************/
 function kw_get_list(gobj, kw, path, default_value, flag) {
 	if (gobj && !is_gobj(gobj)) log_error(`GObj bad instanceof`);
@@ -3802,25 +3835,25 @@ function kw_get_list(gobj, kw, path, default_value, flag) {
 	const create = flag && flag & kw_flag_t.KW_CREATE;
 	const extract = flag && flag & kw_flag_t.KW_EXTRACT;
 	if (v === void 0) {
-		if (create) {
-			let v = Array(default_value);
-			kw_set_dict_value(gobj, kw, path, v);
-			return v;
-		} else if (required) {
+		if (create && is_array(default_value) && kw) {
+			kw_set_dict_value(gobj, kw, path, default_value);
+			return default_value;
+		}
+		if (required) {
 			log_error(`path not found: '${path}'`);
 			trace_json(kw);
 		}
-		return Array(default_value);
+		return default_value;
 	}
-	if (extract) kw_delete(gobj, kw, path);
 	if (!is_array(v)) {
 		if (required) {
-			log_error(`path value MUST BE an array: ${path}`);
+			log_error(`${gobj_short_name(gobj)}: path value MUST BE an array: ${path}`);
 			trace_msg(kw);
 		}
-		return Array(default_value);
+		return default_value;
 	}
-	return Array(v);
+	if (extract) kw_delete(gobj, kw, path);
+	return v;
 }
 /************************************************************
 *
@@ -3856,7 +3889,7 @@ function kw_set_subdict_value(gobj, kw, path, key, value) {
 		log_error("kw is not an object");
 		return -1;
 	}
-	let subdict = kw_get_dict(gobj, kw, path, {}, true, true);
+	let subdict = kw_get_dict(gobj, kw, path, {}, kw_flag_t.KW_CREATE);
 	if (!is_object(subdict)) {
 		log_error("subdict is not an object");
 		return -1;