@rogolev/value 0.0.1 → 0.0.3

package/docs/helpers/to_array.md

@@ -1,106 +1,106 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / to_array
-
-[Исходный код](../../src/helpers/to_array.mjs)
-
-# `to_array`
-
-`to_array` — Преобразует значение в массив.
-
-## Сигнатура функции
-
-```ts
-function to_array(value: any): Array<any> | Object;
-```
-
-## Описание
-
-Функция `to_array` используется для преобразования различных типов данных в массив. Если значение
-уже является массивом (тип `Array` или ассоциативный массив), возвращается оно же. Объекты
-(экземпляры классов) преобразуются в массив с одним элементом.
-
-### Примечание
-
-Функция `to_array` для объектов (ассоциативных массивов) возвращает результат работы функции
-[array](../array/array.md), которая создает объект-контейнер пар ключ-значение (ассоциативный
-массив) с помощью конструкции `Object.create(null)`, копирует все видимые пары в этот контейнер, а
-также добавляет итератор `Symbol.iterator` для перебора контейнера в цикле `for-of`.
-
-## Параметры
-
-- `value` (any)
-
-    Значение, которое необходимо преобразовать в массив. Это может быть строка, число, объект или
-    другой массив.
-
-## Возвращаемое значение
-
-Функция возвращает:
-
-- Массив, содержащий переданное значение. Если значение уже является массивом, возвращается оно же.
-
-## Примеры использования
-
-### Пример 1: Преобразование строки в массив
-
-```js
-const result = to_array('example');
-// Результат: ["example"]
-```
-
-### Пример 2: Преобразование числа в массив
-
-```js
-const result = to_array(123);
-// Результат: [123]
-```
-
-### Пример 3: Преобразование массива (без изменений)
-
-```js
-const result = to_array([1, 2, 3]);
-// Результат: [1, 2, 3]
-```
-
-### Пример 4: Преобразование объекта в массив
-
-Функция `to_array` для объектов (ассоциативных массивов) возвращает результат работы функции
-[array](../array/array.md), которая создает объект-контейнер пар ключ-значение (ассоциативный
-массив) с помощью конструкции `Object.create(null)`, копирует все видимые пары в этот контейнер, а
-также добавляет итератор `Symbol.iterator` для перебора контейнера в цикле `for-of`.
-
-```js
-const result = to_array({ 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 = to_array(instance);
-// Результат: [instance]
-```
-
-### Пример 6: Преобразование null
-
-```js
-const result = to_array(null);
-// Результат: []
-```
-
-### Пример 7: Преобразование undefined
-
-```js
-const result = to_array(undefined);
-// Результат: []
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / to_array
+
+[Исходный код](../../src/helpers/to_array.mjs)
+
+# `to_array`
+
+`to_array` &mdash; Преобразует значение в массив.
+
+## Сигнатура функции
+
+```ts
+function to_array(value: any): Array<any> | Object;
+```
+
+## Описание
+
+Функция `to_array` используется для преобразования различных типов данных в массив. Если значение
+уже является массивом (тип `Array` или ассоциативный массив), возвращается оно же. Объекты
+(экземпляры классов) преобразуются в массив с одним элементом.
+
+### Примечание
+
+Функция `to_array` для объектов (ассоциативных массивов) возвращает результат работы функции
+[array](../array/array.md), которая создает объект-контейнер пар ключ-значение (ассоциативный
+массив) с помощью конструкции `Object.create(null)`, копирует все видимые пары в этот контейнер, а
+также добавляет итератор `Symbol.iterator` для перебора контейнера в цикле `for-of`.
+
+## Параметры
+
+- `value` (any)
+
+    Значение, которое необходимо преобразовать в массив. Это может быть строка, число, объект или
+    другой массив.
+
+## Возвращаемое значение
+
+Функция возвращает:
+
+- Массив, содержащий переданное значение. Если значение уже является массивом, возвращается оно же.
+
+## Примеры использования
+
+### Пример 1: Преобразование строки в массив
+
+```js
+const result = to_array('example');
+// Результат: ["example"]
+```
+
+### Пример 2: Преобразование числа в массив
+
+```js
+const result = to_array(123);
+// Результат: [123]
+```
+
+### Пример 3: Преобразование массива (без изменений)
+
+```js
+const result = to_array([1, 2, 3]);
+// Результат: [1, 2, 3]
+```
+
+### Пример 4: Преобразование объекта в массив
+
+Функция `to_array` для объектов (ассоциативных массивов) возвращает результат работы функции
+[array](../array/array.md), которая создает объект-контейнер пар ключ-значение (ассоциативный
+массив) с помощью конструкции `Object.create(null)`, копирует все видимые пары в этот контейнер, а
+также добавляет итератор `Symbol.iterator` для перебора контейнера в цикле `for-of`.
+
+```js
+const result = to_array({ 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 = to_array(instance);
+// Результат: [instance]
+```
+
+### Пример 6: Преобразование null
+
+```js
+const result = to_array(null);
+// Результат: []
+```
+
+### Пример 7: Преобразование undefined
+
+```js
+const result = to_array(undefined);
+// Результат: []
+```

package/docs/helpers/to_assoc.md

@@ -1,91 +1,91 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / to_assoc
-
-[Исходный код](../../src/helpers/to_assoc.mjs)
-
-# `to_assoc`
-
-`to_assoc` — Преобразует значение в ассоциативный массив.
-
-## Сигнатура функции
-
-```ts
-function to_assoc(value: any): Object;
-```
-
-## Описание
-
-Функция `to_assoc` используется для преобразования различных типов данных в ассоциативный массив.
-Если значение уже является ассоциативным массивом, возвращается он же. Списки преобразуются в
-ассоциативные массивы с индексами в качестве ключей.
-
-### Примечание
-
-Функция `to_assoc` для массивов возвращает объект, где ключами являются индексы элементов массива.
-
-## Параметры
-
-- `value` (any)
-
-    Значение, которое необходимо преобразовать в ассоциативный массив. Это может быть строка, число,
-    объект или массив.
-
-## Возвращаемое значение
-
-Функция возвращает:
-
-- Объект, представляющий ассоциативный массив. Если значение уже является объектом, возвращается оно
-  же.
-
-## Примеры использования
-
-### Пример 1: Преобразование строки в ассоциативный массив
-
-```js
-const result = to_assoc('example');
-// Результат: { 0: 'example' }
-```
-
-### Пример 2: Преобразование числа в ассоциативный массив
-
-```js
-const result = to_assoc(123);
-// Результат: { 0: 123 }
-```
-
-### Пример 3: Преобразование массива в ассоциативный массив
-
-```js
-const result = to_assoc([1, 2, 3]);
-// Результат: { 0: 1, 1: 2, 2: 3 }
-```
-
-### Пример 4: Преобразование ассоциативного массива (без изменений)
-
-```js
-const result = to_assoc({ key: 'value' });
-// Результат: { key: 'value' }
-```
-
-### Пример 5: Преобразование экземпляра класса в ассоциативный массив
-
-```js
-class MyClass {}
-
-const instance = new MyClass();
-const result = to_assoc(instance);
-// Результат: { 0: instance }
-```
-
-### Пример 6: Преобразование null
-
-```js
-const result = to_assoc(null);
-// Результат: {}
-```
-
-### Пример 7: Преобразование undefined
-
-```js
-const result = to_assoc(undefined);
-// Результат: {}
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / to_assoc
+
+[Исходный код](../../src/helpers/to_assoc.mjs)
+
+# `to_assoc`
+
+`to_assoc` — Преобразует значение в ассоциативный массив.
+
+## Сигнатура функции
+
+```ts
+function to_assoc(value: any): Object;
+```
+
+## Описание
+
+Функция `to_assoc` используется для преобразования различных типов данных в ассоциативный массив.
+Если значение уже является ассоциативным массивом, возвращается он же. Списки преобразуются в
+ассоциативные массивы с индексами в качестве ключей.
+
+### Примечание
+
+Функция `to_assoc` для массивов возвращает объект, где ключами являются индексы элементов массива.
+
+## Параметры
+
+- `value` (any)
+
+    Значение, которое необходимо преобразовать в ассоциативный массив. Это может быть строка, число,
+    объект или массив.
+
+## Возвращаемое значение
+
+Функция возвращает:
+
+- Объект, представляющий ассоциативный массив. Если значение уже является объектом, возвращается оно
+  же.
+
+## Примеры использования
+
+### Пример 1: Преобразование строки в ассоциативный массив
+
+```js
+const result = to_assoc('example');
+// Результат: { 0: 'example' }
+```
+
+### Пример 2: Преобразование числа в ассоциативный массив
+
+```js
+const result = to_assoc(123);
+// Результат: { 0: 123 }
+```
+
+### Пример 3: Преобразование массива в ассоциативный массив
+
+```js
+const result = to_assoc([1, 2, 3]);
+// Результат: { 0: 1, 1: 2, 2: 3 }
+```
+
+### Пример 4: Преобразование ассоциативного массива (без изменений)
+
+```js
+const result = to_assoc({ key: 'value' });
+// Результат: { key: 'value' }
+```
+
+### Пример 5: Преобразование экземпляра класса в ассоциативный массив
+
+```js
+class MyClass {}
+
+const instance = new MyClass();
+const result = to_assoc(instance);
+// Результат: { 0: instance }
+```
+
+### Пример 6: Преобразование null
+
+```js
+const result = to_assoc(null);
+// Результат: {}
+```
+
+### Пример 7: Преобразование undefined
+
+```js
+const result = to_assoc(undefined);
+// Результат: {}
+```

package/docs/helpers/to_bool.md

@@ -1,76 +1,76 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / to_bool
-
-[Исходный код](../../src/helpers/to_bool.mjs)
-
-# `to_bool`
-
-`to_bool` — Преобразует значение в логическое значение.
-
-## Сигнатура функции
-
-```ts
-function to_bool(value: any): boolean;
-```
-
-## Описание
-
-Функция `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
-```
-
-### Пример 3: Преобразование непустого ассоциативного массива в `true`
-
-```js
-const result = to_bool({ key: 'value' });
-// Результат: 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
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / to_bool
+
+[Исходный код](../../src/helpers/to_bool.mjs)
+
+# `to_bool`
+
+`to_bool` — Преобразует значение в логическое значение.
+
+## Сигнатура функции
+
+```ts
+function to_bool(value: any): boolean;
+```
+
+## Описание
+
+Функция `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
+```
+
+### Пример 3: Преобразование непустого ассоциативного массива в `true`
+
+```js
+const result = to_bool({ key: 'value' });
+// Результат: 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
+```