@rogolev/value 0.0.1 → 0.0.2

package/src/classes/Convert.mjs

@@ -0,0 +1,819 @@
+import to_array from '../helpers/to_array.mjs';
+import to_assoc from '../helpers/to_assoc.mjs';
+import to_bool from '../helpers/to_bool.mjs';
+import to_float from '../helpers/to_float.mjs';
+import to_int from '../helpers/to_int.mjs';
+import to_list from '../helpers/to_list.mjs';
+import to_object from '../helpers/to_object.mjs';
+import to_string from '../helpers/to_string.mjs';
+
+/**
+ * Класс `Convert` предоставляет методы для преобразования различных типов данных.
+ *
+ * ### Описание
+ *
+ * Класс `Convert` включает в себя статические методы, которые позволяют преобразовывать значения различных типов данных в другие типы.
+ *
+ * ### Методы
+ *
+ * - `Convert.toArray(value)` - Преобразует значение в массив.
+ * - `Convert.toAssoc(value)` - Преобразует значение в ассоциативный массив.
+ * - `Convert.toBool(value)` - Преобразует значение в логическое значение.
+ * - `Convert.toBoolean(value)` - Преобразует значение в логическое значение.
+ * - `Convert.toFloat(value)` - Преобразует значение в число с плавающей точкой.
+ * - `Convert.toInt(value, base)` - Преобразует значение в целое число.
+ * - `Convert.toInteger(value, base)` - Преобразует значение в целое число.
+ * - `Convert.toList(value)` - Преобразует значение в список.
+ * - `Convert.toObject(value)` - Преобразует значение в объект.
+ * - `Convert.toString(value)` - Преобразует значение в строку.
+ *
+ * ### Примеры использования
+ *
+ * ```js
+ * // Преобразование строки в массив
+ * Convert.toArray('example'); // ["example"]
+ *
+ * // Преобразование числа в ассоциативный массив
+ * Convert.toAssoc(123); // { 0: 123 }
+ *
+ * // Преобразование значения в логическое
+ * Convert.toBool('example'); // true
+ *
+ * // Преобразование значения в число с плавающей точкой
+ * Convert.toFloat('123.45'); // 123.45
+ *
+ * // Преобразование значения в целое число
+ * Convert.toInt('123'); // 123
+ *
+ * // Преобразование значения в список
+ * Convert.toList({ key: 'value' }); // ['value']
+ *
+ * // Преобразование значения в объект
+ * Convert.toObject('example'); // { value: 'example' }
+ *
+ * // Преобразование значения в строку
+ * Convert.toString(123); // '123'
+ * ```
+ */
+class Convert {
+    /**
+     * Приводит значение переменной к массиву.
+     *
+     * ### Описание
+     *
+     * Метод `Convert.toArray` используется для преобразования различных типов данных в массив. Если значение
+     * уже является массивом (тип `Array` или ассоциативный массив), возвращается оно же. Объекты
+     * (экземпляры классов) преобразуются в массив с одним элементом.
+     *
+     * #### Примечание
+     *
+     * Метод `Convert.toArray` для объектов (ассоциативных массивов) возвращает результат
+     * работы функции `array`, которая создает объект-контейнер пар ключ-значение
+     * (ассоциативный массив) с помощью конструкции `Object.create(null)`,
+     * копирует все видимые пары в этот контейнер, а также добавляет итератор
+     * `Symbol.iterator` для перебора контейнера в цикле `for-of`.
+     *
+     * ### Параметры
+     *
+     * - `value` (any)
+     *      Переменная, значение которой необходимо привести к массиву.
+     *
+     * ### Возвращаемое значение
+     *
+     * Возвращает массив, содержащий переданное значение. Если значение уже является массивом, возвращается оно же.
+     *
+     * ### Примеры использования
+     *
+     * 1. Преобразование строки в массив:
+     *
+     *    ```js
+     *    const result = Convert.toArray('example');
+     *    // Результат: ["example"]
+     *    ```
+     *
+     * 2. Преобразование числа в массив:
+     *
+     *    ```js
+     *    const result = Convert.toArray(123);
+     *    // Результат: [123]
+     *    ```
+     *
+     * 3. Преобразование массива (без изменений):
+     *
+     *    ```js
+     *    const result = Convert.toArray([1, 2, 3]);
+     *    // Результат: [1, 2, 3]
+     *    ```
+     *
+     * 4. Преобразование объекта в массив:
+     *
+     *    ```js
+     *    const result = Convert.toArray({ key: 'value' });
+     *    // Результат: { key: "value" }
+     *
+     *    const proto = Object.getPrototypeOf(result);
+     *    // Результат: null
+     *
+     *    for (const [key, value] of result) {
+     *        console.log(key, value);
+     *    }
+     *    // Результат: 'key', 'value'
+     *    ```
+     *
+     * 5. Преобразование экземпляра класса в массив:
+     *
+     *    ```js
+     *    class MyClass {}
+     *
+     *    const instance = new MyClass();
+     *    const result = Convert.toArray(instance);
+     *    // Результат: [instance]
+     *    ```
+     *
+     * 6. Преобразование null:
+     *
+     *    ```js
+     *    const result = Convert.toArray(null);
+     *    // Результат: []
+     *    ```
+     *
+     * 7. Преобразование undefined:
+     *
+     *    ```js
+     *    const result = Convert.toArray(undefined);
+     *    // Результат: []
+     *    ```
+     *
+     * @param {any} value Переменная, значение которой необходимо привести к массиву.
+     * @returns {Array|Object} Возвращает приведенное к массиву значение переменной `value`.
+     */
+    static toArray(value) {
+        return to_array(value);
+    }
+
+    /**
+     * Преобразует значение в ассоциативный массив.
+     *
+     * ### Описание
+     *
+     * Метод `Convert.toAssoc` используется для преобразования различных типов данных в ассоциативный массив.
+     * Если значение уже является объектом, возвращается оно же. Массивы преобразуются в объекты с
+     * индексами в качестве ключей.
+     *
+     * #### Примечание
+     *
+     * Метод `Convert.toAssoc` для массивов возвращает объект, где ключами являются индексы элементов массива.
+     *
+     * ### Параметры
+     *
+     * - `value` (any)
+     *      Значение, которое необходимо преобразовать в ассоциативный массив.
+     *
+     * ### Возвращаемое значение
+     *
+     * Возвращает объект, представляющий ассоциативный массив. Если значение уже является объектом, возвращается оно же.
+     *
+     * ### Примеры использования
+     *
+     * 1. Преобразование строки в ассоциативный массив:
+     *
+     *    ```js
+     *    const result = Convert.toAssoc('example');
+     *    // Результат: { 0: 'example' }
+     *    ```
+     *
+     * 2. Преобразование числа в ассоциативный массив:
+     *
+     *    ```js
+     *    const result = Convert.toAssoc(123);
+     *    // Результат: { 0: 123 }
+     *    ```
+     *
+     * 3. Преобразование массива в ассоциативный массив:
+     *
+     *    ```js
+     *    const result = Convert.toAssoc([1, 2, 3]);
+     *    // Результат: { 0: 1, 1: 2, 2: 3 }
+     *    ```
+     *
+     * 4. Преобразование ассоциативного массива (без изменений):
+     *
+     *    ```js
+     *    const result = Convert.toAssoc({ key: 'value' });
+     *    // Результат: { key: 'value' }
+     *    ```
+     *
+     * 5. Преобразование экземпляра класса в ассоциативный массив:
+     *
+     *    ```js
+     *    class MyClass {}
+     *
+     *    const instance = new MyClass();
+     *    const result = Convert.toAssoc(instance);
+     *    // Результат: { 0: instance }
+     *    ```
+     *
+     * 6. Преобразование null:
+     *
+     *    ```js
+     *    const result = Convert.toAssoc(null);
+     *    // Результат: {}
+     *    ```
+     *
+     * 7. Преобразование undefined:
+     *
+     *    ```js
+     *    const result = Convert.toAssoc(undefined);
+     *    // Результат: {}
+     *    ```
+     *
+     * @param {any} value Значение, которое необходимо преобразовать.
+     * @returns {Object} Возвращает объект, представляющий ассоциативный массив.
+     */
+    static toAssoc(value) {
+        return to_assoc(value);
+    }
+
+    /**
+     * Преобразует значение в логическое значение.
+     *
+     * ### Описание
+     *
+     * Метод `Convert.toBool` используется для преобразования различных типов данных в логическое значение.
+     * Если значение является примитивом типа `boolean`, возвращается оно же. Для всех других типов данных
+     * метод возвращает `true` для истинных значений и `false` для ложных значений.
+     *
+     * ### Параметры
+     *
+     * - `value` (any)
+     *      Значение, которое необходимо преобразовать в логическое значение.
+     *
+     * ### Возвращаемое значение
+     *
+     * Возвращает логическое значение, соответствующее переданному значению.
+     *
+     * ### Примеры использования
+     *
+     * 1. Преобразование строки в логическое значение:
+     *
+     *    ```js
+     *    const result = Convert.toBool('example');
+     *    // Результат: true
+     *    ```
+     *
+     * 2. Преобразование числа в логическое значение:
+     *
+     *    ```js
+     *    const result = Convert.toBool(123);
+     *    // Результат: true
+     *    ```
+     *
+     * 3. Преобразование булевых значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toBool(true);
+     *    // Результат: true
+     *
+     *    const result2 = Convert.toBool(false);
+     *    // Результат: false
+     *    ```
+     *
+     * 4. Преобразование других значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toBool(null);
+     *    // Результат: false
+     *
+     *    const result2 = Convert.toBool(undefined);
+     *    // Результат: false
+     *
+     *    const result3 = Convert.toBool([]);
+     *    // Результат: false
+     *
+     *    const result4 = Convert.toBool({});
+     *    // Результат: false
+     *    ```
+     *
+     * @param {any} value Значение, которое необходимо преобразовать.
+     * @returns {boolean} Возвращает логическое значение, соответствующее переданному значению.
+     */
+    static toBool(value) {
+        return to_bool(value);
+    }
+
+    /**
+     * Преобразует значение в логическое значение.
+     *
+     * ### Описание
+     *
+     * Метод `Convert.toBoolean` используется для преобразования различных типов данных в логическое значение.
+     * Если значение является примитивом типа `boolean`, возвращается оно же. Для всех других типов данных
+     * метод возвращает `true` для истинных значений и `false` для ложных значений.
+     *
+     * ### Параметры
+     *
+     * - `value` (any)
+     *      Значение, которое необходимо преобразовать в логическое значение.
+     *
+     * ### Возвращаемое значение
+     *
+     * Возвращает логическое значение, соответствующее переданному значению.
+     *
+     * ### Примеры использования
+     *
+     * 1. Преобразование строки в логическое значение:
+     *
+     *    ```js
+     *    const result = Convert.toBoolean('example');
+     *    // Результат: true
+     *    ```
+     *
+     * 2. Преобразование числа в логическое значение:
+     *
+     *    ```js
+     *    const result = Convert.toBoolean(123);
+     *    // Результат: true
+     *    ```
+     *
+     * 3. Преобразование булевых значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toBoolean(true);
+     *    // Результат: true
+     *
+     *    const result2 = Convert.toBoolean(false);
+     *    // Результат: false
+     *    ```
+     *
+     * 4. Преобразование других значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toBoolean(null);
+     *    // Результат: false
+     *
+     *    const result2 = Convert.toBoolean(undefined);
+     *    // Результат: false
+     *
+     *    const result3 = Convert.toBoolean([]);
+     *    // Результат: false
+     *
+     *    const result4 = Convert.toBoolean({});
+     *    // Результат: false
+     *    ```
+     *
+     * @param {any} value Значение, которое необходимо преобразовать.
+     * @returns {boolean} Возвращает логическое значение, соответствующее переданному значению.
+     */
+    static toBoolean(value) {
+        return to_bool(value);
+    }
+
+    /**
+     * Приводит значение переменной к числу с плавающей точкой.
+     *
+     * ### Описание
+     *
+     * Метод `Convert.toFloat` используется для преобразования различных типов данных в число с плавающей точкой. Если значение не является числом или строкой, метод возвращает `1` для истинных значений и `0` для ложных значений.
+     *
+     * ### Параметры
+     *
+     * - `value` (any)
+     *      Переменная, значение которой необходимо привести к числу с плавающей точкой.
+     *
+     * ### Возвращаемое значение
+     *
+     * Возвращает число с плавающей точкой, соответствующее переданному значению.
+     *
+     * ### Примеры использования
+     *
+     * 1. Преобразование строки в число с плавающей точкой:
+     *
+     *    ```js
+     *    const result = Convert.toFloat('123.45');
+     *    // Результат: 123.45
+     *    ```
+     *
+     * 2. Преобразование целого числа в число с плавающей точкой:
+     *
+     *    ```js
+     *    const result = Convert.toFloat(123);
+     *    // Результат: 123.0
+     *    ```
+     *
+     * 3. Преобразование булевых значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toFloat(true);
+     *    // Результат: 1.0
+     *
+     *    const result2 = Convert.toFloat(false);
+     *    // Результат: 0.0
+     *    ```
+     *
+     * 4. Преобразование других значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toFloat(null);
+     *    // Результат: 0.0
+     *
+     *    const result2 = Convert.toFloat(undefined);
+     *    // Результат: 0.0
+     *
+     *    const result3 = Convert.toFloat('example');
+     *    // Результат: 0.0
+     *    ```
+     *
+     * @param {any} value Переменная, значение которой необходимо привести к числу с плавающей точкой.
+     * @returns {number} Возвращает приведенное к числу с плавающей точкой значение переменной `value`.
+     */
+    static toFloat(value) {
+        return to_float(value);
+    }
+
+    /**
+     * Приводит значение переменной к целому числу.
+     *
+     * ### Описание
+     *
+     * Метод `Convert.toInt` используется для преобразования различных типов данных в целое число. Если значение не является числом или строкой, метод возвращает `1` для истинных значений и `0` для ложных значений.
+     *
+     * ### Параметры
+     *
+     * - `value` (any)
+     *      Переменная, значение которой необходимо привести к целому числу.
+     *
+     * - `base` (number)
+     *      Основание системы счисления для преобразования строки в число. По умолчанию `10`.
+     *
+     * ### Возвращаемое значение
+     *
+     * Возвращает целое число, соответствующее переданному значению.
+     *
+     * ### Примеры использования
+     *
+     * 1. Преобразование строки в целое число:
+     *
+     *    ```js
+     *    const result = Convert.toInt('123');
+     *    // Результат: 123
+     *    ```
+     *
+     * 2. Преобразование числа с плавающей точкой в целое число:
+     *
+     *    ```js
+     *    const result = Convert.toInt(123.45);
+     *    // Результат: 123
+     *    ```
+     *
+     * 3. Преобразование булевых значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toInt(true);
+     *    // Результат: 1
+     *
+     *    const result2 = Convert.toInt(false);
+     *    // Результат: 0
+     *    ```
+     *
+     * 4. Преобразование других значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toInt(null);
+     *    // Результат: 0
+     *
+     *    const result2 = Convert.toInt(undefined);
+     *    // Результат: 0
+     *
+     *    const result3 = Convert.toInt('example');
+     *    // Результат: 0
+     *    ```
+     *
+     * 5. Преобразование строки с основанием системы счисления:
+     *
+     *    ```js
+     *    const result1 = Convert.toInt('10', 2);
+     *    // Результат: 2
+     *
+     *    const result2 = Convert.toInt('A', 16);
+     *    // Результат: 10
+     *
+     *    const result3 = Convert.toInt('7', 8);
+     *    // Результат: 7
+     *    ```
+     *
+     * @param {any} value Переменная, значение которой необходимо привести к целому числу.
+     * @param {number} [base=10] Основание системы счисления для преобразования строки в число.
+     * @returns {number} Возвращает приведенное к целому числу значение переменной `value`.
+     */
+    static toInt(value, base = 10) {
+        return to_int(value, base);
+    }
+
+    /**
+     * Приводит значение переменной к целому числу.
+     *
+     * ### Описание
+     *
+     * Метод `Convert.toInteger` используется для преобразования различных типов данных в целое число. Если значение не является числом или строкой, метод возвращает `1` для истинных значений и `0` для ложных значений.
+     *
+     * ### Параметры
+     *
+     * - `value` (any)
+     *      Переменная, значение которой необходимо привести к целому числу.
+     *
+     * - `base` (number)
+     *      Основание системы счисления для преобразования строки в число. По умолчанию `10`.
+     *
+     * ### Возвращаемое значение
+     *
+     * Возвращает целое число, соответствующее переданному значению.
+     *
+     * ### Примеры использования
+     *
+     * 1. Преобразование строки в целое число:
+     *
+     *    ```js
+     *    const result = Convert.toInteger('123');
+     *    // Результат: 123
+     *    ```
+     *
+     * 2. Преобразование числа с плавающей точкой в целое число:
+     *
+     *    ```js
+     *    const result = Convert.toInteger(123.45);
+     *    // Результат: 123
+     *    ```
+     *
+     * 3. Преобразование булевых значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toInteger(true);
+     *    // Результат: 1
+     *
+     *    const result2 = Convert.toInteger(false);
+     *    // Результат: 0
+     *    ```
+     *
+     * 4. Преобразование других значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toInteger(null);
+     *    // Результат: 0
+     *
+     *    const result2 = Convert.toInteger(undefined);
+     *    // Результат: 0
+     *
+     *    const result3 = Convert.toInteger('example');
+     *    // Результат: 0
+     *    ```
+     *
+     * 5. Преобразование строки с основанием системы счисления:
+     *
+     *    ```js
+     *    const result1 = Convert.toInteger('10', 2);
+     *    // Результат: 2
+     *
+     *    const result2 = Convert.toInteger('A', 16);
+     *    // Результат: 10
+     *
+     *    const result3 = Convert.toInteger('7', 8);
+     *    // Результат: 7
+     *    ```
+     *
+     * @param {any} value Переменная, значение которой необходимо привести к целому числу.
+     * @param {number} [base=10] Основание системы счисления для преобразования строки в число.
+     * @returns {number} Возвращает приведенное к целому числу значение переменной `value`.
+     */
+    static toInteger(value, base = 10) {
+        return to_int(value, base);
+    }
+
+    /**
+     * Преобразует значение в список.
+     *
+     * ### Параметры
+     *
+     * - `value` (any)
+     *      Значение, которое необходимо преобразовать.
+     *
+     * ### Описание
+     *
+     * Метод `Convert.toList` преобразует переданное значение в список.
+     *
+     * Она выполняет следующие проверки:
+     *
+     * 1. **Null и Undefined**: Возвращает пустой массив для значений `null` и `undefined`.
+     * 2. **Array**: Возвращает исходный массив, если он передан.
+     * 3. **Object**: Возвращает массив значений объекта, если передан ассоциативный массив.
+     * 4. **Примитивы и другие типы**: Возвращает массив, содержащий переданное значение.
+     *
+     * ### Возвращаемое значение
+     *
+     * Возвращает массив, представляющий список значений.
+     *
+     * ### Примеры использования
+     *
+     * ```js
+     * Convert.toList(null); // []
+     * Convert.toList(undefined); // []
+     * Convert.toList([1, 2, 3]); // [1, 2, 3]
+     * Convert.toList({ key: 'value' }); // ['value']
+     * Convert.toList('example'); // ['example']
+     * Convert.toList(123); // [123]
+     * ```
+     *
+     * @param {any} value Значение, которое необходимо преобразовать.
+     * @returns {Array} Возвращает массив, представляющий список значений.
+     */
+    static toList(value) {
+        return to_list(value);
+    }
+
+    /**
+     * Приводит значение переменной к объекту.
+     *
+     * ### Описание
+     *
+     * Метод `Convert.toObject` используется для преобразования различных типов данных в объект. Если значение уже является объектом, оно возвращается без изменений. Если значение является классом, возвращается новый экземпляр этого класса. Если значение является массивом, элементы массива копируются в новый объект. Для других значений создается объект с полем `value`, содержащим это значение.
+     *
+     * ### Параметры
+     *
+     * - `value` (any)
+     *      Переменная, значение которой необходимо привести к объекту.
+     *
+     * ### Возвращаемое значение
+     *
+     * Возвращает объект, соответствующий переданному значению.
+     *
+     * ### Примеры использования
+     *
+     * 1. Преобразование объекта:
+     *
+     *    ```js
+     *    class MyClass {}
+     *    const obj = new MyClass();
+     *    const result = Convert.toObject(obj);
+     *    // Результат: obj
+     *    ```
+     *
+     * 2. Преобразование класса:
+     *
+     *    ```js
+     *    class MyClass {}
+     *    const result = Convert.toObject(MyClass);
+     *    // Результат: экземпляр MyClass
+     *    ```
+     *
+     * 3. Преобразование null и undefined:
+     *
+     *    ```js
+     *    const result1 = Convert.toObject(null);
+     *    // Результат: экземпляр анонимного класса
+     *
+     *    const result2 = Convert.toObject(undefined);
+     *    // Результат: экземпляр анонимного класса
+     *    ```
+     *
+     * 4. Преобразование массива:
+     *
+     *    ```js
+     *    const arr = [1, 2, 3];
+     *    const result = Convert.toObject(arr);
+     *    // Результат: объект с элементами массива
+     *    ```
+     *
+     * 5. Преобразование других значений:
+     *
+     *    ```js
+     *    const result = Convert.toObject('example');
+     *    // Результат: объект с полем value, содержащим 'example'
+     *    ```
+     *
+     * @param {any} value Переменная, значение которой необходимо привести к объекту.
+     * @returns {object} Возвращает приведенное к объекту значение переменной `value`.
+     */
+    static toObject(value) {
+        return to_object(value);
+    }
+
+    /**
+     * Приводит значение переменной к строке.
+     *
+     * ### Описание
+     *
+     * Метод `Convert.toString` используется для преобразования различных типов данных в строку. Он обрабатывает массивы, объекты, классы, функции, символы и другие типы данных, возвращая их строковое представление.
+     *
+     * ### Параметры
+     *
+     * - `value` (any)
+     *      Переменная, значение которой необходимо привести к строке.
+     *
+     * ### Возвращаемое значение
+     *
+     * Возвращает строку, соответствующую переданному значению.
+     *
+     * ### Примеры использования
+     *
+     * 1. Преобразование строки:
+     *
+     *    ```js
+     *    const result = Convert.toString('example');
+     *    // Результат: 'example'
+     *    ```
+     *
+     * 2. Преобразование числа:
+     *
+     *    ```js
+     *    const result = Convert.toString(123);
+     *    // Результат: '123'
+     *    ```
+     *
+     * 3. Преобразование булевых значений:
+     *
+     *    ```js
+     *    const result1 = Convert.toString(true);
+     *    // Результат: 'true'
+     *
+     *    const result2 = Convert.toString(false);
+     *    // Результат: 'false'
+     *    ```
+     *
+     * 4. Преобразование null и undefined:
+     *
+     *    ```js
+     *    const result1 = Convert.toString(null);
+     *    // Результат: 'null'
+     *
+     *    const result2 = Convert.toString(undefined);
+     *    // Результат: 'undefined'
+     *    ```
+     *
+     * 5. Преобразование массива:
+     *
+     *    ```js
+     *    const arr = [1, 2, 3];
+     *    const result = Convert.toString(arr);
+     *    // Результат: '[\n    1,\n    2,\n    3,\n]'
+     *    ```
+     *
+     * 6. Преобразование объекта:
+     *
+     *    ```js
+     *    const obj = { key: 'value' };
+     *    const result = Convert.toString(obj);
+     *    // Результат: '{\n    key: 'value',\n}'
+     *    ```
+     *
+     * 7. Преобразование функции:
+     *
+     *    ```js
+     *    const func = function() {};
+     *    const result = Convert.toString(func);
+     *    // Результат: 'function func() {}'
+     *    ```
+     *
+     * 8. Преобразование символа:
+     *
+     *    ```js
+     *    const symbol = Symbol('example');
+     *    const result = Convert.toString(symbol);
+     *    // Результат: 'Symbol(example)'
+     *    ```
+     *
+     * 9. Преобразование BigInt:
+     *
+     *    ```js
+     *    const bigInt = BigInt(123);
+     *    const result = Convert.toString(bigInt);
+     *    // Результат: '123'
+     *    ```
+     *
+     * 10. Преобразование класса:
+     *
+     *    ```js
+     *    class MyClass {
+     *        static test = 'test';
+     *    }
+     *    const result = Convert.toString(MyClass);
+     *    // Результат: 'class MyClass {}'
+     *    ```
+     *
+     * 11. Преобразование экземпляра класса:
+     *
+     *    ```js
+     *    class MyClass {}
+     *    const instance = new MyClass();
+     *    const result = Convert.toString(instance);
+     *    // Результат: 'object MyClass'
+     *    ```
+     *
+     * @param {any} value Переменная, значение которой необходимо привести к строке.
+     * @returns {string} Возвращает приведенное к строке значение переменной `value`.
+     */
+    static toString(value) {
+        return to_string(value);
+    }
+}
+
+export default Convert;
+