@rogolev/value 0.0.1 → 0.0.2

package/docs/helpers/gettype.md

@@ -1,69 +1,69 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / gettype
-
-[Исходный код](../../src/helpers/gettype.mjs)
-
-# `gettype`
-
-`gettype` — Определяет тип переданного значения.
-
-## Сигнатура функции
-
-```ts
-function gettype(value: any): string;
-```
-
-## Параметры
-
-- `value` (any)
-
-    Значение, тип которого необходимо определить.
-
-## Описание
-
-Функция `gettype` определяет тип переданного значения, используя различные проверки.
-
-Она выполняет следующие проверки:
-
-1. **Null**: Проверяет, является ли значение `null`.
-2. **NaN**: Проверяет, является ли значение `NaN`.
-3. **Undefined**: Проверяет, является ли значение `undefined`.
-4. **Infinity**: Проверяет, является ли значение бесконечностью.
-5. **Boolean**: Проверяет, является ли значение логическим.
-6. **Integer**: Проверяет, является ли значение целым числом.
-7. **BigInt**: Проверяет, является ли значение типом BigInt.
-8. **Float**: Проверяет, является ли значение числом с плавающей точкой.
-9. **String**: Проверяет, является ли значение строкой.
-10. **Symbol**: Проверяет, является ли значение символом.
-11. **Class**: Проверяет, является ли значение классом.
-12. **Function**: Проверяет, является ли значение функцией.
-13. **Array**: Проверяет, является ли значение массивом.
-14. **Object**: Проверяет, является ли значение объектом.
-
-Если значение не соответствует ни одному из этих типов, функция возвращает результат `typeof value`.
-
-## Возвращаемое значение
-
-Функция возвращает строку, представляющую тип значения.
-
-## Примеры использования
-
-### Пример 1: Проверка различных типов значений
-
-```js
-class MyClass {}
-
-gettype(null); // "null"
-gettype(NaN); // "NaN"
-gettype(undefined); // "undefined"
-gettype(Infinity); // "infinity"
-gettype(true); // "boolean"
-gettype(42); // "integer"
-gettype(BigInt(123456)); // "bigint"
-gettype(3.14); // "float"
-gettype('hello'); // "string"
-gettype(Symbol('symbol')); // "symbol"
-gettype(MyClass); // "class"
-gettype(() => {}); // "function"
-gettype([]); // "array"
-gettype(new MyClass()); // "object"
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / gettype
+
+[Исходный код](../../src/helpers/gettype.mjs)
+
+# `gettype`
+
+`gettype` — Определяет тип переданного значения.
+
+## Сигнатура функции
+
+```ts
+function gettype(value: any): string;
+```
+
+## Параметры
+
+- `value` (any)
+
+    Значение, тип которого необходимо определить.
+
+## Описание
+
+Функция `gettype` определяет тип переданного значения, используя различные проверки.
+
+Она выполняет следующие проверки:
+
+1. **Null**: Проверяет, является ли значение `null`.
+2. **NaN**: Проверяет, является ли значение `NaN`.
+3. **Undefined**: Проверяет, является ли значение `undefined`.
+4. **Infinity**: Проверяет, является ли значение бесконечностью.
+5. **Boolean**: Проверяет, является ли значение логическим.
+6. **Integer**: Проверяет, является ли значение целым числом.
+7. **BigInt**: Проверяет, является ли значение типом BigInt.
+8. **Float**: Проверяет, является ли значение числом с плавающей точкой.
+9. **String**: Проверяет, является ли значение строкой.
+10. **Symbol**: Проверяет, является ли значение символом.
+11. **Class**: Проверяет, является ли значение классом.
+12. **Function**: Проверяет, является ли значение функцией.
+13. **Array**: Проверяет, является ли значение массивом.
+14. **Object**: Проверяет, является ли значение объектом.
+
+Если значение не соответствует ни одному из этих типов, функция возвращает результат `typeof value`.
+
+## Возвращаемое значение
+
+Функция возвращает строку, представляющую тип значения.
+
+## Примеры использования
+
+### Пример 1: Проверка различных типов значений
+
+```js
+class MyClass {}
+
+gettype(null); // "null"
+gettype(NaN); // "NaN"
+gettype(undefined); // "undefined"
+gettype(Infinity); // "infinity"
+gettype(true); // "boolean"
+gettype(42); // "integer"
+gettype(BigInt(123456)); // "bigint"
+gettype(3.14); // "float"
+gettype('hello'); // "string"
+gettype(Symbol('symbol')); // "symbol"
+gettype(MyClass); // "class"
+gettype(() => {}); // "function"
+gettype([]); // "array"
+gettype(new MyClass()); // "object"
+```

package/docs/helpers/is_array.md

@@ -1,105 +1,105 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / is_array
-
-[Исходный код](../../src/helpers/is_array.mjs)
-
-# is_array
-
-`is_array` — Проверяет, является ли переданное значение массивом или ассоциативным массивом
-(объектом с ключами и значениями).
-
-## Сигнатура функции
-
-```ts
-function is_array(value: any): boolean;
-```
-
-## Описание
-
-В JavaScript массивы и объекты имеют разные структуры и предназначения:
-
-- Массивы (`Array`) являются упорядоченными коллекциями элементов, которые могут быть индексированы.
-- Объекты (`Object`) содержат пары "ключ-значение", которые могут быть неупорядоченными.
-
-Эта функция проверяет, является ли переданное значение обычным массивом (например, `[1, 2, 3]`),
-либо ассоциативным массивом (объектом с парами "ключ-значение", например, `{foo: 'bar'}`).
-
-## Алгоритм работы функции
-
-1. Сначала проверяется, является ли переданное значение обычным массивом с помощью встроенного
-   метода `Array.isArray(value)`. Если это массив, функция сразу возвращает `true`.
-
-2. Если переменная не является массивом, то выполняются дополнительные проверки:
-
-    - Проверяется, что значение не равно `null` (так как `null` в JavaScript также является
-      объектом, но не является ни массивом, ни объектом с парами "ключ-значение").
-    - Проверяется, что значение является объектом JavaScript (с помощью
-      `typeof value === 'object'`).
-    - Проверяется, что прототип объекта совпадает с `Object.prototype` (это объект, от которого
-      наследуются все объекты в JavaScript) или является `null` (это означает, что объект был создан
-      с помощью `Object.create(null)` и не имеет прототипа).
-    - Исключаются массивоподобные объекты (например, `arguments`, `NodeList`), путем проверки, что
-      свойство `length` не является собственным свойством объекта.
-    - Дополнительно проверяется, что объект является простым (его конструктор равен `Object`), а
-      также исключаются встроенные объекты (`Math`, `JSON`, `Reflect`, `Intl`), для которых функция
-      возвращает `true`.
-
-## Параметры
-
-- `value` (any)
-
-    Проверяемая переменная.
-
-## Возвращаемое значение
-
-Возвращает `true`, если переменная является обычным массивом (`Array`), ассоциативным массивом
-(объектом с парами "ключ-значение"), ассоциативным массивом, созданным с помощью
-`Object.create(null)`. В остальных случаях функция возвращает `false`.
-
-## Примеры использования
-
-1. Простые массивы:
-
-    ```js
-    is_array([1, 2, 3]); // true
-    is_array([]); // true
-    ```
-
-2. Ассоциативные массивы (объекты с ключами и значениями):
-
-    ```js
-    is_array({ foo: 'bar', baz: 42 }); // true
-    is_array({ 0: 'a', 1: 'b' }); // true
-    ```
-
-3. Объекты, созданные без прототипа:
-
-    ```js
-    const noProtoObject = Object.create(null);
-    noProtoObject.foo = 'bar';
-    is_array(noProtoObject); // true
-    ```
-
-4. Примитивы и невалидные значения:
-
-    ```js
-    is_array(null); // false
-    is_array(undefined); // false
-    is_array(42); // false
-    is_array('hello'); // false
-    ```
-
-5. Специальные объекты:
-
-    ```js
-    is_array(new Map()); // false
-    is_array(new Set()); // false
-    is_array(() => {}); // false
-    ```
-
-6. Классы и их экземпляры:
-
-    ```js
-    class MyClass {}
-    const instance = new MyClass();
-    is_array(instance); // false
-    ```
+[Главная](../../README.md) / [Помощники](../helpers.md) / is_array
+
+[Исходный код](../../src/helpers/is_array.mjs)
+
+# is_array
+
+`is_array` — Проверяет, является ли переданное значение массивом или ассоциативным массивом
+(объектом с ключами и значениями).
+
+## Сигнатура функции
+
+```ts
+function is_array(value: any): boolean;
+```
+
+## Описание
+
+В JavaScript массивы и объекты имеют разные структуры и предназначения:
+
+- Массивы (`Array`) являются упорядоченными коллекциями элементов, которые могут быть индексированы.
+- Объекты (`Object`) содержат пары "ключ-значение", которые могут быть неупорядоченными.
+
+Эта функция проверяет, является ли переданное значение обычным массивом (например, `[1, 2, 3]`),
+либо ассоциативным массивом (объектом с парами "ключ-значение", например, `{foo: 'bar'}`).
+
+## Алгоритм работы функции
+
+1. Сначала проверяется, является ли переданное значение обычным массивом с помощью встроенного
+   метода `Array.isArray(value)`. Если это массив, функция сразу возвращает `true`.
+
+2. Если переменная не является массивом, то выполняются дополнительные проверки:
+
+    - Проверяется, что значение не равно `null` (так как `null` в JavaScript также является
+      объектом, но не является ни массивом, ни объектом с парами "ключ-значение").
+    - Проверяется, что значение является объектом JavaScript (с помощью
+      `typeof value === 'object'`).
+    - Проверяется, что прототип объекта совпадает с `Object.prototype` (это объект, от которого
+      наследуются все объекты в JavaScript) или является `null` (это означает, что объект был создан
+      с помощью `Object.create(null)` и не имеет прототипа).
+    - Исключаются массивоподобные объекты (например, `arguments`, `NodeList`), путем проверки, что
+      свойство `length` не является собственным свойством объекта.
+    - Дополнительно проверяется, что объект является простым (его конструктор равен `Object`), а
+      также исключаются встроенные объекты (`Math`, `JSON`, `Reflect`, `Intl`), для которых функция
+      возвращает `true`.
+
+## Параметры
+
+- `value` (any)
+
+    Проверяемая переменная.
+
+## Возвращаемое значение
+
+Возвращает `true`, если переменная является обычным массивом (`Array`), ассоциативным массивом
+(объектом с парами "ключ-значение"), ассоциативным массивом, созданным с помощью
+`Object.create(null)`. В остальных случаях функция возвращает `false`.
+
+## Примеры использования
+
+1. Простые массивы:
+
+    ```js
+    is_array([1, 2, 3]); // true
+    is_array([]); // true
+    ```
+
+2. Ассоциативные массивы (объекты с ключами и значениями):
+
+    ```js
+    is_array({ foo: 'bar', baz: 42 }); // true
+    is_array({ 0: 'a', 1: 'b' }); // true
+    ```
+
+3. Объекты, созданные без прототипа:
+
+    ```js
+    const noProtoObject = Object.create(null);
+    noProtoObject.foo = 'bar';
+    is_array(noProtoObject); // true
+    ```
+
+4. Примитивы и невалидные значения:
+
+    ```js
+    is_array(null); // false
+    is_array(undefined); // false
+    is_array(42); // false
+    is_array('hello'); // false
+    ```
+
+5. Специальные объекты:
+
+    ```js
+    is_array(new Map()); // false
+    is_array(new Set()); // false
+    is_array(() => {}); // false
+    ```
+
+6. Классы и их экземпляры:
+
+    ```js
+    class MyClass {}
+    const instance = new MyClass();
+    is_array(instance); // false
+    ```

package/docs/helpers/is_assoc.md

@@ -1,59 +1,59 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / is_assoc
-
-[Исходный код](../../src/helpers/is_assoc.mjs)
-
-# `is_assoc`
-
-`is_assoc` — Проверяет, является ли значение ассоциативным массивом.
-
-## Сигнатура функции
-
-```ts
-function is_assoc(value: any): boolean;
-```
-
-## Параметры
-
-- `value` (any)
-
-    Значение, которое необходимо проверить на принадлежность к ассоциативному массиву.
-
-## Описание
-
-Функция `is_assoc` предназначена для проверки, является ли переданное значение ассоциативным
-массивом.
-
-Она использует метод `is_array` для проверки значения и убеждается, что значение не является обычным
-массивом.
-
-## Возвращаемое значение
-
-Функция возвращает:
-
-- `true`, если значение является ассоциативным массивом.
-- `false` в противном случае.
-
-## Примеры использования
-
-### Пример 1: Проверка ассоциативных массивов
-
-```js
-is_assoc({ foo: 'bar' }); // true
-is_assoc({}); // true
-```
-
-### Пример 2: Проверка обычных массивов
-
-```js
-is_assoc([]); // false
-is_assoc([1, 2, 3]); // false
-```
-
-### Пример 3: Проверка значений других типов
-
-```js
-is_assoc('string'); // false (строка)
-is_assoc(42); // false (число)
-is_assoc(null); // false
-is_assoc(undefined); // false
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / is_assoc
+
+[Исходный код](../../src/helpers/is_assoc.mjs)
+
+# `is_assoc`
+
+`is_assoc` — Проверяет, является ли значение ассоциативным массивом.
+
+## Сигнатура функции
+
+```ts
+function is_assoc(value: any): boolean;
+```
+
+## Параметры
+
+- `value` (any)
+
+    Значение, которое необходимо проверить на принадлежность к ассоциативному массиву.
+
+## Описание
+
+Функция `is_assoc` предназначена для проверки, является ли переданное значение ассоциативным
+массивом.
+
+Она использует метод `is_array` для проверки значения и убеждается, что значение не является обычным
+массивом.
+
+## Возвращаемое значение
+
+Функция возвращает:
+
+- `true`, если значение является ассоциативным массивом.
+- `false` в противном случае.
+
+## Примеры использования
+
+### Пример 1: Проверка ассоциативных массивов
+
+```js
+is_assoc({ foo: 'bar' }); // true
+is_assoc({}); // true
+```
+
+### Пример 2: Проверка обычных массивов
+
+```js
+is_assoc([]); // false
+is_assoc([1, 2, 3]); // false
+```
+
+### Пример 3: Проверка значений других типов
+
+```js
+is_assoc('string'); // false (строка)
+is_assoc(42); // false (число)
+is_assoc(null); // false
+is_assoc(undefined); // false
+```

package/docs/helpers/is_bigint.md

@@ -1,57 +1,57 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / is_bigint
-
-[Исходный код](../../src/helpers/is_bigint.mjs)
-
-# `is_bigint`
-
-`is_bigint` — Проверяет, является ли значение типом `bigint`.
-
-## Сигнатура функции
-
-```ts
-function is_bigint(value: any): boolean;
-```
-
-## Параметры
-
-- `value` (any)
-
-    Значение, которое необходимо проверить на принадлежность к типу `bigint`.
-
-## Описание
-
-Функция `is_bigint` предназначена для проверки, является ли переданное значение типом `bigint`.
-
-Она проверяет:
-
-1. Что значение имеет тип `bigint`.
-
-Функция возвращает `false` для значений других типов, таких как числа, строки, объекты или массивы.
-
-## Возвращаемое значение
-
-Функция возвращает:
-
-- `true`, если значение является типом `bigint`.
-- `false` в противном случае.
-
-## Примеры использования
-
-### Пример 1: Проверка значений типа bigint
-
-```js
-is_bigint(BigInt(123456)); // true
-is_bigint(BigInt(-123456)); // true
-```
-
-### Пример 2: Проверка значений других типов
-
-```js
-is_bigint(42); // false (число)
-is_bigint('42'); // false (строка)
-is_bigint(true); // false (логическое значение)
-is_bigint(null); // false
-is_bigint(undefined); // false
-is_bigint({}); // false (объект)
-is_bigint([]); // false (массив)
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / is_bigint
+
+[Исходный код](../../src/helpers/is_bigint.mjs)
+
+# `is_bigint`
+
+`is_bigint` — Проверяет, является ли значение типом `bigint`.
+
+## Сигнатура функции
+
+```ts
+function is_bigint(value: any): boolean;
+```
+
+## Параметры
+
+- `value` (any)
+
+    Значение, которое необходимо проверить на принадлежность к типу `bigint`.
+
+## Описание
+
+Функция `is_bigint` предназначена для проверки, является ли переданное значение типом `bigint`.
+
+Она проверяет:
+
+1. Что значение имеет тип `bigint`.
+
+Функция возвращает `false` для значений других типов, таких как числа, строки, объекты или массивы.
+
+## Возвращаемое значение
+
+Функция возвращает:
+
+- `true`, если значение является типом `bigint`.
+- `false` в противном случае.
+
+## Примеры использования
+
+### Пример 1: Проверка значений типа bigint
+
+```js
+is_bigint(BigInt(123456)); // true
+is_bigint(BigInt(-123456)); // true
+```
+
+### Пример 2: Проверка значений других типов
+
+```js
+is_bigint(42); // false (число)
+is_bigint('42'); // false (строка)
+is_bigint(true); // false (логическое значение)
+is_bigint(null); // false
+is_bigint(undefined); // false
+is_bigint({}); // false (объект)
+is_bigint([]); // false (массив)
+```