@rogolev/value 0.0.1 → 0.0.2

package/src/helpers/to_bool.mjs

@@ -1,68 +1,68 @@
-import is_array from './is_array.mjs';
-
-/**
- * Приводит значение переменной к логическому типу.
- *
- * ### Описание
- *
- * Функция `to_bool` используется для преобразования различных типов данных в логическое значение.
- * Если значение является пустым массивом, функция возвращает `false`.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Переменная, значение которой необходимо привести к логическому типу.
- *
- * ### Возвращаемое значение
- *
- * Возвращает логическое значение, соответствующее переданному значению.
- *
- * ### Примеры использования
- *
- * 1. Преобразование пустого массива в `false`:
- *
- *    ```js
- *    const result = to_bool([]);
- *    // Результат: false
- *    ```
- *
- * 2. Преобразование пустого ассоциативного массива в `false`:
- *
- *    ```js
- *    const result = to_bool({});
- *    // Результат: false
- *    ```
- *
- * 3. Преобразование непустого массива в `true`:
- *
- *    ```js
- *    const result = to_bool([1, 2, 3]);
- *    // Результат: true
- *    ```
- *
- * 4. Преобразование других значений:
- *
- *    ```js
- *    const result1 = to_bool('example');
- *    // Результат: true
- *
- *    const result2 = to_bool(123);
- *    // Результат: true
- *
- *    const result3 = to_bool(null);
- *    // Результат: false
- *
- *    const result4 = to_bool(undefined);
- *    // Результат: false
- *    ```
- *
- * @param {any} value Переменная, значение которой необходимо привести к логическому типу.
- * @returns {boolean} Возвращает приведенное к логическому типу значение переменной `value`.
- */
-export default function to_bool(value) {
-    if (is_array(value) && Object.keys(value).length === 0) {
-        return false;
-    }
-
-    return Boolean(value);
-}
+import is_array from './is_array.mjs';
+
+/**
+ * Приводит значение переменной к логическому типу.
+ *
+ * ### Описание
+ *
+ * Функция `to_bool` используется для преобразования различных типов данных в логическое значение.
+ * Если значение является пустым массивом, функция возвращает `false`.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Переменная, значение которой необходимо привести к логическому типу.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает логическое значение, соответствующее переданному значению.
+ *
+ * ### Примеры использования
+ *
+ * 1. Преобразование пустого массива в `false`:
+ *
+ *    ```js
+ *    const result = to_bool([]);
+ *    // Результат: false
+ *    ```
+ *
+ * 2. Преобразование пустого ассоциативного массива в `false`:
+ *
+ *    ```js
+ *    const result = to_bool({});
+ *    // Результат: false
+ *    ```
+ *
+ * 3. Преобразование непустого массива в `true`:
+ *
+ *    ```js
+ *    const result = to_bool([1, 2, 3]);
+ *    // Результат: true
+ *    ```
+ *
+ * 4. Преобразование других значений:
+ *
+ *    ```js
+ *    const result1 = to_bool('example');
+ *    // Результат: true
+ *
+ *    const result2 = to_bool(123);
+ *    // Результат: true
+ *
+ *    const result3 = to_bool(null);
+ *    // Результат: false
+ *
+ *    const result4 = to_bool(undefined);
+ *    // Результат: false
+ *    ```
+ *
+ * @param {any} value Переменная, значение которой необходимо привести к логическому типу.
+ * @returns {boolean} Возвращает приведенное к логическому типу значение переменной `value`.
+ */
+export default function to_bool(value) {
+    if (is_array(value) && Object.keys(value).length === 0) {
+        return false;
+    }
+
+    return Boolean(value);
+}

package/src/helpers/to_boolean.mjs

@@ -1,64 +1,64 @@
-import to_bool from './to_bool.mjs';
-
-/**
- * Приводит значение переменной к логическому типу.
- *
- * ### Описание
- *
- * Функция `to_boolean` является синонимом функции `to_bool` и используется для преобразования различных типов данных в логическое значение.
- * Если значение является пустым массивом, функция возвращает `false`.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Переменная, значение которой необходимо привести к логическому типу.
- *
- * ### Возвращаемое значение
- *
- * Возвращает логическое значение, соответствующее переданному значению.
- *
- * ### Примеры использования
- *
- * 1. Преобразование пустого массива в `false`:
- *
- *    ```js
- *    const result = to_boolean([]);
- *    // Результат: false
- *    ```
- *
- * 2. Преобразование пустого ассоциативного массива в `false`:
- *
- *    ```js
- *    const result = to_boolean({});
- *    // Результат: false
- *    ```
- *
- * 3. Преобразование непустого массива в `true`:
- *
- *    ```js
- *    const result = to_boolean([1, 2, 3]);
- *    // Результат: true
- *    ```
- *
- * 4. Преобразование других значений:
- *
- *    ```js
- *    const result1 = to_boolean('example');
- *    // Результат: true
- *
- *    const result2 = to_boolean(123);
- *    // Результат: true
- *
- *    const result3 = to_boolean(null);
- *    // Результат: false
- *
- *    const result4 = to_boolean(undefined);
- *    // Результат: false
- *    ```
- *
- * @param {any} value Переменная, значение которой необходимо привести к логическому типу.
- * @returns {boolean} Возвращает приведенное к логическому типу значение переменной `value`.
- */
-export default function to_boolean(value) {
-    return to_bool(value);
-}
+import to_bool from './to_bool.mjs';
+
+/**
+ * Приводит значение переменной к логическому типу.
+ *
+ * ### Описание
+ *
+ * Функция `to_boolean` является синонимом функции `to_bool` и используется для преобразования различных типов данных в логическое значение.
+ * Если значение является пустым массивом, функция возвращает `false`.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Переменная, значение которой необходимо привести к логическому типу.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает логическое значение, соответствующее переданному значению.
+ *
+ * ### Примеры использования
+ *
+ * 1. Преобразование пустого массива в `false`:
+ *
+ *    ```js
+ *    const result = to_boolean([]);
+ *    // Результат: false
+ *    ```
+ *
+ * 2. Преобразование пустого ассоциативного массива в `false`:
+ *
+ *    ```js
+ *    const result = to_boolean({});
+ *    // Результат: false
+ *    ```
+ *
+ * 3. Преобразование непустого массива в `true`:
+ *
+ *    ```js
+ *    const result = to_boolean([1, 2, 3]);
+ *    // Результат: true
+ *    ```
+ *
+ * 4. Преобразование других значений:
+ *
+ *    ```js
+ *    const result1 = to_boolean('example');
+ *    // Результат: true
+ *
+ *    const result2 = to_boolean(123);
+ *    // Результат: true
+ *
+ *    const result3 = to_boolean(null);
+ *    // Результат: false
+ *
+ *    const result4 = to_boolean(undefined);
+ *    // Результат: false
+ *    ```
+ *
+ * @param {any} value Переменная, значение которой необходимо привести к логическому типу.
+ * @returns {boolean} Возвращает приведенное к логическому типу значение переменной `value`.
+ */
+export default function to_boolean(value) {
+    return to_bool(value);
+}

package/src/helpers/to_float.mjs

@@ -1,72 +1,72 @@
-import is_float from './is_float.mjs';
-import is_int from './is_int.mjs';
-import is_string from './is_string.mjs';
-import to_bool from './to_bool.mjs';
-
-/**
- * Приводит значение переменной к числу с плавающей точкой.
- *
- * ### Описание
- *
- * Функция `to_float` используется для преобразования различных типов данных в число с плавающей точкой. Если значение не является числом или строкой, функция возвращает `1` для истинных значений и `0` для ложных значений.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Переменная, значение которой необходимо привести к числу с плавающей точкой.
- *
- * ### Возвращаемое значение
- *
- * Возвращает число с плавающей точкой, соответствующее переданному значению.
- *
- * ### Примеры использования
- *
- * 1. Преобразование строки в число с плавающей точкой:
- *
- *    ```js
- *    const result = to_float('123.45');
- *    // Результат: 123.45
- *    ```
- *
- * 2. Преобразование целого числа в число с плавающей точкой:
- *
- *    ```js
- *    const result = to_float(123);
- *    // Результат: 123.0
- *    ```
- *
- * 3. Преобразование булевых значений:
- *
- *    ```js
- *    const result1 = to_float(true);
- *    // Результат: 1.0
- *
- *    const result2 = to_float(false);
- *    // Результат: 0.0
- *    ```
- *
- * 4. Преобразование других значений:
- *
- *    ```js
- *    const result1 = to_float(null);
- *    // Результат: 0.0
- *
- *    const result2 = to_float(undefined);
- *    // Результат: 0.0
- *
- *    const result3 = to_float('example');
- *    // Результат: 0.0
- *    ```
- *
- * @param {any} value Переменная, значение которой необходимо привести к числу с плавающей точкой.
- * @returns {number} Возвращает приведенное к числу с плавающей точкой значение переменной `value`.
- */
-export default function to_float(value) {
-    if (!is_int(value) && !is_float(value) && !is_string(value)) {
-        return Number(to_bool(value));
-    }
-
-    const result = parseFloat(value);
-
-    return Number.isNaN(result) ? 0 : result;
-}
+import is_float from './is_float.mjs';
+import is_int from './is_int.mjs';
+import is_string from './is_string.mjs';
+import to_bool from './to_bool.mjs';
+
+/**
+ * Приводит значение переменной к числу с плавающей точкой.
+ *
+ * ### Описание
+ *
+ * Функция `to_float` используется для преобразования различных типов данных в число с плавающей точкой. Если значение не является числом или строкой, функция возвращает `1` для истинных значений и `0` для ложных значений.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Переменная, значение которой необходимо привести к числу с плавающей точкой.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает число с плавающей точкой, соответствующее переданному значению.
+ *
+ * ### Примеры использования
+ *
+ * 1. Преобразование строки в число с плавающей точкой:
+ *
+ *    ```js
+ *    const result = to_float('123.45');
+ *    // Результат: 123.45
+ *    ```
+ *
+ * 2. Преобразование целого числа в число с плавающей точкой:
+ *
+ *    ```js
+ *    const result = to_float(123);
+ *    // Результат: 123.0
+ *    ```
+ *
+ * 3. Преобразование булевых значений:
+ *
+ *    ```js
+ *    const result1 = to_float(true);
+ *    // Результат: 1.0
+ *
+ *    const result2 = to_float(false);
+ *    // Результат: 0.0
+ *    ```
+ *
+ * 4. Преобразование других значений:
+ *
+ *    ```js
+ *    const result1 = to_float(null);
+ *    // Результат: 0.0
+ *
+ *    const result2 = to_float(undefined);
+ *    // Результат: 0.0
+ *
+ *    const result3 = to_float('example');
+ *    // Результат: 0.0
+ *    ```
+ *
+ * @param {any} value Переменная, значение которой необходимо привести к числу с плавающей точкой.
+ * @returns {number} Возвращает приведенное к числу с плавающей точкой значение переменной `value`.
+ */
+export default function to_float(value) {
+    if (!is_int(value) && !is_float(value) && !is_string(value)) {
+        return Number(to_bool(value));
+    }
+
+    const result = parseFloat(value);
+
+    return Number.isNaN(result) ? 0 : result;
+}

package/src/helpers/to_int.mjs

@@ -1,93 +1,93 @@
-import to_bool from './to_bool.mjs';
-import is_float from './is_float.mjs';
-import is_int from './is_int.mjs';
-import is_string from './is_string.mjs';
-
-/**
- * Приводит значение переменной к целому числу.
- *
- * ### Описание
- *
- * Функция `to_int` используется для преобразования различных типов данных в целое число. Если значение не является числом или строкой, функция возвращает `1` для истинных значений и `0` для ложных значений.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Переменная, значение которой необходимо привести к целому числу.
- *
- * - `base` (number)
- *      Основание системы счисления для преобразования строки в число. По умолчанию `10`.
- *
- * ### Возвращаемое значение
- *
- * Возвращает целое число, соответствующее переданному значению.
- *
- * ### Примеры использования
- *
- * 1. Преобразование строки в целое число:
- *
- *    ```js
- *    const result = to_int('123');
- *    // Результат: 123
- *    ```
- *
- * 2. Преобразование числа с плавающей точкой в целое число:
- *
- *    ```js
- *    const result = to_int(123.45);
- *    // Результат: 123
- *    ```
- *
- * 3. Преобразование булевых значений:
- *
- *    ```js
- *    const result1 = to_int(true);
- *    // Результат: 1
- *
- *    const result2 = to_int(false);
- *    // Результат: 0
- *    ```
- *
- * 4. Преобразование других значений:
- *
- *    ```js
- *    const result1 = to_int(null);
- *    // Результат: 0
- *
- *    const result2 = to_int(undefined);
- *    // Результат: 0
- *
- *    const result3 = to_int('example');
- *    // Результат: 0
- *    ```
- *
- * 5. Преобразование строки с основанием системы счисления:
- *
- *    ```js
- *    const result1 = to_int('10', 2);
- *    // Результат: 2
- *
- *    const result2 = to_int('A', 16);
- *    // Результат: 10
- *
- *    const result3 = to_int('7', 8);
- *    // Результат: 7
- *    ```
- *
- * @param {any} value Переменная, значение которой необходимо привести к целому числу.
- * @param {number} [base=10] Основание системы счисления для преобразования строки в число.
- * @returns {number} Возвращает приведенное к целому числу значение переменной `value`.
- */
-export default function to_int(value, base = 10) {
-    if (!is_int(base)) {
-        throw new TypeError('Параметр "base" должен быть целым числом.');
-    }
-
-    if (!is_int(value) && !is_float(value) && !is_string(value)) {
-        return Number(to_bool(value));
-    }
-
-    const result = parseInt(value, base);
-
-    return Number.isNaN(result) ? 0 : result;
-}
+import to_bool from './to_bool.mjs';
+import is_float from './is_float.mjs';
+import is_int from './is_int.mjs';
+import is_string from './is_string.mjs';
+
+/**
+ * Приводит значение переменной к целому числу.
+ *
+ * ### Описание
+ *
+ * Функция `to_int` используется для преобразования различных типов данных в целое число. Если значение не является числом или строкой, функция возвращает `1` для истинных значений и `0` для ложных значений.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Переменная, значение которой необходимо привести к целому числу.
+ *
+ * - `base` (number)
+ *      Основание системы счисления для преобразования строки в число. По умолчанию `10`.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает целое число, соответствующее переданному значению.
+ *
+ * ### Примеры использования
+ *
+ * 1. Преобразование строки в целое число:
+ *
+ *    ```js
+ *    const result = to_int('123');
+ *    // Результат: 123
+ *    ```
+ *
+ * 2. Преобразование числа с плавающей точкой в целое число:
+ *
+ *    ```js
+ *    const result = to_int(123.45);
+ *    // Результат: 123
+ *    ```
+ *
+ * 3. Преобразование булевых значений:
+ *
+ *    ```js
+ *    const result1 = to_int(true);
+ *    // Результат: 1
+ *
+ *    const result2 = to_int(false);
+ *    // Результат: 0
+ *    ```
+ *
+ * 4. Преобразование других значений:
+ *
+ *    ```js
+ *    const result1 = to_int(null);
+ *    // Результат: 0
+ *
+ *    const result2 = to_int(undefined);
+ *    // Результат: 0
+ *
+ *    const result3 = to_int('example');
+ *    // Результат: 0
+ *    ```
+ *
+ * 5. Преобразование строки с основанием системы счисления:
+ *
+ *    ```js
+ *    const result1 = to_int('10', 2);
+ *    // Результат: 2
+ *
+ *    const result2 = to_int('A', 16);
+ *    // Результат: 10
+ *
+ *    const result3 = to_int('7', 8);
+ *    // Результат: 7
+ *    ```
+ *
+ * @param {any} value Переменная, значение которой необходимо привести к целому числу.
+ * @param {number} [base=10] Основание системы счисления для преобразования строки в число.
+ * @returns {number} Возвращает приведенное к целому числу значение переменной `value`.
+ */
+export default function to_int(value, base = 10) {
+    if (!is_int(base)) {
+        throw new TypeError('Параметр "base" должен быть целым числом.');
+    }
+
+    if (!is_int(value) && !is_float(value) && !is_string(value)) {
+        return Number(to_bool(value));
+    }
+
+    const result = parseInt(value, base);
+
+    return Number.isNaN(result) ? 0 : result;
+}