@rogolev/value 0.0.1 → 0.0.2

package/docs/classes/Convert/toAssoc.md

@@ -0,0 +1,90 @@
+[Главная](../../../README.md) / [Классы](../../classes.md) / [Convert](../Convert.md) / toAssoc
+
+[Исходный код](../../../src/classes/Convert.mjs)
+
+# Convert.toAssoc
+
+`Convert.toAssoc` — Преобразует значение в ассоциативный массив.
+
+## Сигнатура метода
+
+```ts
+static toAssoc(value: any): Object;
+```
+
+## Описание
+
+Метод `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);
+    // Результат: {}
+    ```
+

package/docs/classes/Convert/toBool.md

@@ -0,0 +1,72 @@
+[Главная](../../../README.md) / [Классы](../../classes.md) / [Convert](../Convert.md) / toBool
+
+[Исходный код](../../../src/classes/Convert.mjs)
+
+# Convert.toBool
+
+`Convert.toBool` — Преобразует значение в логическое значение.
+
+## Сигнатура метода
+
+```ts
+static toBool(value: any): boolean;
+```
+
+## Описание
+
+Метод `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
+    ```
+

package/docs/classes/Convert/toBoolean.md

@@ -0,0 +1,72 @@
+[Главная](../../../README.md) / [Классы](../../classes.md) / [Convert](../Convert.md) / toBoolean
+
+[Исходный код](../../../src/classes/Convert.mjs)
+
+# Convert.toBoolean
+
+`Convert.toBoolean` — Преобразует значение в логическое значение.
+
+## Сигнатура метода
+
+```ts
+static toBoolean(value: any): boolean;
+```
+
+## Описание
+
+Метод `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
+    ```
+

package/docs/classes/Convert/toFloat.md

@@ -0,0 +1,69 @@
+[Главная](../../../README.md) / [Классы](../../classes.md) / [Convert](../Convert.md) / toFloat
+
+[Исходный код](../../../src/classes/Convert.mjs)
+
+# Convert.toFloat
+
+`Convert.toFloat` — Преобразует значение в число с плавающей точкой.
+
+## Сигнатура метода
+
+```ts
+static toFloat(value: any): number;
+```
+
+## Описание
+
+Метод `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
+    ```
+

package/docs/classes/Convert/toInt.md

@@ -0,0 +1,86 @@
+[Главная](../../../README.md) / [Классы](../../classes.md) / [Convert](../Convert.md) / toInt
+
+[Исходный код](../../../src/classes/Convert.mjs)
+
+# Convert.toInt
+
+`Convert.toInt` — Преобразует значение в целое число.
+
+## Сигнатура метода
+
+```ts
+static toInt(value: any, base?: number): number;
+```
+
+## Описание
+
+Метод `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
+    ```
+

package/docs/classes/Convert/toInteger.md

@@ -0,0 +1,86 @@
+[Главная](../../../README.md) / [Классы](../../classes.md) / [Convert](../Convert.md) / toInteger
+
+[Исходный код](../../../src/classes/Convert.mjs)
+
+# Convert.toInteger
+
+`Convert.toInteger` — Преобразует значение в целое число.
+
+## Сигнатура метода
+
+```ts
+static toInteger(value: any, base?: number): number;
+```
+
+## Описание
+
+Метод `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
+    ```
+

package/docs/classes/Convert/toList.md

@@ -0,0 +1,73 @@
+[Главная](../../../README.md) / [Классы](../../classes.md) / [Convert](../Convert.md) / toList
+
+[Исходный код](../../../src/classes/Convert.mjs)
+
+# Convert.toList
+
+`Convert.toList` — Преобразует значение в список.
+
+## Сигнатура метода
+
+```ts
+static toList(value: any): Array<any>;
+```
+
+## Описание
+
+Метод `Convert.toList` преобразует переданное значение в список.
+
+## Параметры
+
+- `value` (any)
+
+    Значение, которое необходимо преобразовать.
+
+## Возвращаемое значение
+
+Возвращает массив, представляющий список значений.
+
+## Примеры использования
+
+1. Преобразование null и undefined:
+
+    ```js
+    const result1 = Convert.toList(null);
+    // Результат: []
+
+    const result2 = Convert.toList(undefined);
+    // Результат: []
+    ```
+
+2. Преобразование массива:
+
+    ```js
+    const result = Convert.toList([1, 2, 3]);
+    // Результат: [1, 2, 3]
+    ```
+
+3. Преобразование ассоциативного массива:
+
+    ```js
+    const result = Convert.toList({ key: 'value' });
+    // Результат: ['value']
+    ```
+
+4. Преобразование примитивов:
+
+    ```js
+    const result1 = Convert.toList('example');
+    // Результат: ['example']
+
+    const result2 = Convert.toList(123);
+    // Результат: [123]
+    ```
+
+5. Преобразование экземпляра класса:
+
+    ```js
+    class MyClass {}
+    const instance = new MyClass();
+    const result = Convert.toList(instance);
+    // Результат: [instance]
+    ```
+

package/docs/classes/Convert/toObject.md

@@ -0,0 +1,76 @@
+[Главная](../../../README.md) / [Классы](../../classes.md) / [Convert](../Convert.md) / toObject
+
+[Исходный код](../../../src/classes/Convert.mjs)
+
+# Convert.toObject
+
+`Convert.toObject` — Преобразует значение в объект.
+
+## Сигнатура метода
+
+```ts
+static toObject(value: any): Object;
+```
+
+## Описание
+
+Метод `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'
+    ```
+