@rogolev/value 0.0.1

package/src/helpers/print.mjs

@@ -0,0 +1,245 @@
+import gettype from './gettype.mjs';
+import is_bool from './is_bool.mjs';
+import is_class from './is_class.mjs';
+import to_string from './to_string.mjs';
+
+function print_array(value) {
+    let result = Array.isArray(value) ? '[' : '{';
+
+    for (const [k, v] of Object.entries(value)) {
+        result += `\n    ${k}: ${print(v, true).replace(/\n/g, '\n    ')},`;
+    }
+
+    return (result += (result.length > 1 ? '\n' : '') + (Array.isArray(value) ? ']' : '}'));
+}
+
+function print_object(value) {
+    let result = `${to_string(value)} {`;
+
+    let new_line = false;
+
+    for (const [k, v] of Object.entries(value)) {
+        new_line = true;
+
+        result += `\n    ${k} = ${print(v, true).replace(/\n/g, '\n    ')};`;
+    }
+
+    return (result += `${new_line ? '\n' : ''}${Array.isArray(value) ? ']' : '}'}`);
+}
+
+function print_class(value) {
+    const parent = Object.getPrototypeOf(value);
+
+    let result = `class ${value.name ? `${value.name} ` : ''}${is_class(parent) ? `extends ${parent.name} ` : ''}{`;
+
+    let new_line = false;
+
+    for (const [k, v] of Object.entries(value)) {
+        new_line = true;
+
+        result += `\n    ${k} = ${print(v, true).replace(/\n/g, '\n    ')};`;
+    }
+
+    return (result += `${new_line ? '\n' : ''}}`);
+}
+
+function print_string(value) {
+    return `"${value}"`;
+}
+
+/**
+ * Преобразует значение переменной в строку и выводит его на консоль.
+ *
+ * ### Описание
+ *
+ * Функция `print` используется для преобразования различных типов данных в строку и вывода их на консоль. Она обрабатывает массивы, объекты, классы, функции, символы и другие типы данных, возвращая их строковое представление.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Переменная, значение которой необходимо преобразовать в строку и вывести на консоль.
+ *
+ * - `return_result` (boolean)
+ *      Если `true`, функция возвращает строковое представление значения переменной.
+ *      Если `false`, функция выводит строковое представление значения переменной на консоль.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает строковое представление значения переменной, если параметр `return_result` равен `true`. В противном случае возвращает `undefined`.
+ *
+ * ### Примеры использования
+ *
+ * 1. Преобразование строки:
+ *
+ *    ```js
+ *    print('example');
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    "example"
+ *    ```
+ *
+ * 2. Преобразование числа:
+ *
+ *    ```js
+ *    print(123);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    123
+ *    ```
+ *
+ * 3. Преобразование булевых значений:
+ *
+ *    ```js
+ *    print(true);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    true
+ *    ```
+ *
+ *    ```js
+ *    print(false);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    false
+ *    ```
+ *
+ * 4. Преобразование null и undefined:
+ *
+ *    ```js
+ *    print(null);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    null
+ *    ```
+ *
+ *    ```js
+ *    print(undefined);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    undefined
+ *    ```
+ *
+ * 5. Преобразование массива:
+ *
+ *    ```js
+ *    const arr = [1, 2, 3];
+ *    print(arr);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    [
+ *        0: 1,
+ *        1: 2,
+ *        2: 3,
+ *    ]
+ *    ```
+ *
+ * 6. Преобразование ассоциативного массива:
+ *
+ *    ```js
+ *    const obj = { key: 'value' };
+ *    print(obj);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    {
+ *        key: "value",
+ *    }
+ *    ```
+ *
+ * 7. Преобразование функции:
+ *
+ *    ```js
+ *    const func = function() {};
+ *    print(func);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    function func() {}
+ *    ```
+ *
+ * 8. Преобразование символа:
+ *
+ *    ```js
+ *    const symbol = Symbol('example');
+ *    print(symbol);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    Symbol(example)
+ *    ```
+ *
+ * 9. Преобразование класса:
+ *
+ *    ```js
+ *    class MyClass {
+ *        static test = 'test';
+ *    }
+ *    print(MyClass);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    class MyClass {
+ *        test = "test";
+ *    }
+ *    ```
+ *
+ * 10. Преобразование экземпляра класса:
+ *
+ *    ```js
+ *    class MyClass {
+ *        test = 'test';
+ *    }
+ *    const instance = new MyClass();
+ *    print(instance);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    object MyClass {
+ *        test = "test";
+ *    }
+ *    ```
+ *
+ * @param {any} value Переменная, значение которой необходимо преобразовать в строку и вывести на консоль.
+ * @param {boolean} return_result Если `true`, функция возвращает строковое представление значения переменной. Если `false`, функция выводит строковое представление значения переменной на консоль.
+ * @returns {string|undefined} Возвращает строковое представление значения переменной, если параметр `return_result` равен `true`. В противном случае возвращает `undefined`.
+ */
+export default function print(value, return_result = false) {
+    if (!is_bool(return_result)) {
+        throw new TypeError('Параметр "return_result" должен быть логическим типом.');
+    }
+
+    let result = '';
+
+    switch (gettype(value)) {
+        case 'array':
+            result = print_array(value);
+            break;
+        case 'object':
+            result =
+                value.toString() === '[object Object]' ? print_object(value) : value.toString();
+            break;
+        case 'class':
+            result = print_class(value);
+            break;
+        case 'string':
+            result = print_string(value);
+            break;
+        default:
+            result = to_string(value);
+    }
+
+    if (return_result) {
+        return result;
+    }
+
+    console.log(result);
+
+    return undefined;
+}

package/src/helpers/print_type.mjs

@@ -0,0 +1,261 @@
+import gettype from './gettype.mjs';
+import is_bool from './is_bool.mjs';
+import is_class from './is_class.mjs';
+import print from './print.mjs';
+
+function print_array_type(value) {
+    let result = `array(${Object.values(value).length}) ${Array.isArray(value) ? '[' : '{'}`;
+
+    let new_line = false;
+
+    for (const [k, v] of Object.entries(value)) {
+        new_line = true;
+
+        result += `\n    ${k}: ${print_type(v, true).replace(/\n/g, '\n    ')},`;
+    }
+
+    return (result += `${new_line ? '\n' : ''}${Array.isArray(value) ? ']' : '}'}`);
+}
+
+function print_object_type(value) {
+    let result = `object(${value.constructor.name}) (${Object.values(value).length}) {`;
+
+    let new_line = false;
+
+    for (const [k, v] of Object.entries(value)) {
+        new_line = true;
+
+        result += `\n    ${k} = ${print_type(v, true).replace(/\n/g, '\n    ')};`;
+    }
+
+    return (result += `${new_line ? '\n' : ''}}`);
+}
+
+function print_class_type(value) {
+    const parent = Object.getPrototypeOf(value);
+
+    let result = `class ${value.name ? `${value.name} ` : ''}${is_class(parent) ? `extends ${parent.name} ` : ''}{`;
+
+    let new_line = false;
+
+    for (const [k, v] of Object.entries(value)) {
+        new_line = true;
+
+        result += `\n    ${k} = ${print_type(v, true).replace(/\n/g, '\n    ')};`;
+    }
+
+    return (result += `${new_line ? '\n' : ''}}`);
+}
+
+/**
+ * Преобразует значение переменной в строку с указанием типа и выводит его на консоль.
+ *
+ * ### Описание
+ *
+ * Функция `print_type` используется для преобразования различных типов данных в строку с указанием типа и вывода их на консоль. Она обрабатывает массивы, объекты, классы, функции, символы и другие типы данных, возвращая их строковое представление с указанием типа.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Переменная, значение которой необходимо преобразовать в строку с указанием типа и вывести на консоль.
+ *
+ * - `return_result` (boolean)
+ *      Если `true`, функция возвращает строковое представление значения переменной. Если `false`, функция выводит строковое представление значения переменной на консоль.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает строковое представление значения переменной с указанием типа, если параметр `return_result` равен `true`. В противном случае возвращает `undefined`.
+ *
+ * ### Примеры использования
+ *
+ * 1. Преобразование строки:
+ *
+ *    ```js
+ *    print_type('example');
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    string(7) "example"
+ *    ```
+ *
+ * 2. Преобразование числа:
+ *
+ *    ```js
+ *    print_type(123);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    int(123)
+ *    ```
+ *
+ *    ```js
+ *    print_type(123.45);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    float(123.45)
+ *    ```
+ *
+ * 3. Преобразование булевых значений:
+ *
+ *    ```js
+ *    print_type(true);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    bool(true)
+ *    ```
+ *
+ *    ```js
+ *    print_type(false);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    bool(false)
+ *    ```
+ *
+ * 4. Преобразование null и undefined:
+ *
+ *    ```js
+ *    print_type(null);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    null
+ *    ```
+ *
+ *    ```js
+ *    print_type(undefined);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    undefined
+ *    ```
+ *
+ * 5. Преобразование массива:
+ *
+ *    ```js
+ *    const arr = [1, 2, 3];
+ *    print_type(arr);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    array(3) [
+ *        0: int(1),
+ *        1: int(2),
+ *        2: int(3),
+ *    ]
+ *    ```
+ *
+ * 6. Преобразование ассоциативного массива:
+ *
+ *    ```js
+ *    const obj = { key: 'value' };
+ *    print_type(obj);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    array(1) {
+ *        key: string(5) "value",
+ *    }
+ *    ```
+ *
+ * 7. Преобразование функции:
+ *
+ *    ```js
+ *    const func = function() {};
+ *    print_type(func);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    function func() {}
+ *    ```
+ *
+ * 8. Преобразование символа:
+ *
+ *    ```js
+ *    const symbol = Symbol('example');
+ *    print_type(symbol);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    Symbol(example)
+ *    ```
+ *
+ * 9. Преобразование класса:
+ *
+ *    ```js
+ *    class MyClass {
+ *        static test = 'test';
+ *    }
+ *    print_type(MyClass);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    class MyClass {
+ *        test = string(4) "test";
+ *    }
+ *    ```
+ *
+ * 10. Преобразование экземпляра класса:
+ *
+ *    ```js
+ *    class MyClass {
+ *        test = 'test';
+ *    }
+ *    const instance = new MyClass();
+ *    print_type(instance);
+ *    ```
+ *    Вывод:
+ *    ```txt
+ *    object(MyClass) (1) {
+ *        test: string(4) "test",
+ *    }
+ *    ```
+ *
+ * @param {any} value Переменная, значение которой необходимо преобразовать в строку с указанием типа и вывести на консоль.
+ * @param {boolean} return_result Если `true`, функция возвращает строковое представление значения переменной. Если `false`, функция выводит строковое представление значения переменной на консоль.
+ * @returns {string|undefined} Возвращает строковое представление значения переменной с указанием типа, если параметр `return_result` равен `true`. В противном случае возвращает `undefined`.
+ */
+export default function print_type(value, return_result = false) {
+    if (!is_bool(return_result)) {
+        throw new TypeError('Параметр "return_result" должен иметь логический тип.');
+    }
+
+    let result = '';
+
+    switch (gettype(value)) {
+        case 'boolean':
+            result = value ? 'bool(true)' : 'bool(false)';
+            break;
+        case 'integer':
+            result = `int(${value})`;
+            break;
+        case 'float':
+            result = `float(${value})`;
+            break;
+        case 'string':
+            result = `string(${value.length}) "${value}"`;
+            break;
+        case 'array':
+            result = print_array_type(value);
+            break;
+        case 'object':
+            result = print_object_type(value);
+            break;
+        case 'class':
+            result = print_class_type(value);
+            break;
+        default:
+            result = print(value, true);
+            break;
+    }
+
+    if (return_result) {
+        return result;
+    }
+
+    console.log(result);
+
+    return undefined;
+}

package/src/helpers/settype.mjs

@@ -0,0 +1,101 @@
+import to_array from './to_array.mjs';
+import to_bool from './to_bool.mjs';
+import to_float from './to_float.mjs';
+import to_int from './to_int.mjs';
+import to_object from './to_object.mjs';
+import to_string from './to_string.mjs';
+
+/**
+ * Приводит значение переменной к указанному типу.
+ *
+ * ### Описание
+ *
+ * Функция `settype` используется для преобразования значения переменной к указанному типу. Поддерживаются типы: `boolean`, `integer`, `float`, `string`, `array`, `object`.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Переменная, значение которой необходимо привести к указанному типу.
+ *
+ * - `type` (string)
+ *      Тип, к которому необходимо привести значение переменной.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает значение переменной, приведенное к указанному типу.
+ *
+ * ### Примеры использования
+ *
+ * 1. Преобразование в булевое значение:
+ *
+ *    ```js
+ *    const result = settype('true', 'boolean');
+ *    // Результат: true
+ *    ```
+ *
+ * 2. Преобразование в целое число:
+ *
+ *    ```js
+ *    const result = settype('123', 'integer');
+ *    // Результат: 123
+ *    ```
+ *
+ * 3. Преобразование в число с плавающей точкой:
+ *
+ *    ```js
+ *    const result = settype('123.45', 'float');
+ *    // Результат: 123.45
+ *    ```
+ *
+ * 4. Преобразование в строку:
+ *
+ *    ```js
+ *    const result = settype(123, 'string');
+ *    // Результат: '123'
+ *    ```
+ *
+ * 5. Преобразование в массив:
+ *
+ *    ```js
+ *    const result = settype('example', 'array');
+ *    // Результат: ['example']
+ *    ```
+ *
+ * 6. Преобразование в объект:
+ *
+ *    ```js
+ *    const result = settype('example', 'object');
+ *    // Результат: { value: 'example' }
+ *    ```
+ *
+ * @param {any} value Переменная, значение которой необходимо привести к указанному типу.
+ * @param {string} type Тип, к которому необходимо привести значение переменной.
+ * @returns {any} Возвращает значение переменной, приведенное к указанному типу.
+ */
+export default function settype(value, type) {
+    if (type === 'boolean' || type === 'bool') {
+        return to_bool(value);
+    }
+
+    if (type === 'integer' || type === 'int') {
+        return to_int(value);
+    }
+
+    if (type === 'float') {
+        return to_float(value);
+    }
+
+    if (type === 'string') {
+        return to_string(value);
+    }
+
+    if (type === 'array') {
+        return to_array(value);
+    }
+
+    if (type === 'object') {
+        return to_object(value);
+    }
+
+    return value;
+}