@rogolev/value 0.0.2 → 0.0.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (133) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +19 -1
  3. package/docs/classes/Value/constructor.md +48 -0
  4. package/docs/classes/Value/get.md +51 -0
  5. package/docs/classes/Value/getType.md +71 -0
  6. package/docs/classes/Value/isArray.md +67 -0
  7. package/docs/classes/Value/isAssoc.md +68 -0
  8. package/docs/classes/Value/isBigInt.md +52 -0
  9. package/docs/classes/Value/isBool.md +60 -0
  10. package/docs/classes/Value/isBoolean.md +60 -0
  11. package/docs/classes/Value/isClass.md +55 -0
  12. package/docs/classes/Value/isEmpty.md +84 -0
  13. package/docs/classes/Value/isFloat.md +52 -0
  14. package/docs/classes/Value/isFunction.md +60 -0
  15. package/docs/classes/Value/isInfinity.md +60 -0
  16. package/docs/classes/Value/isInt.md +52 -0
  17. package/docs/classes/Value/isInteger.md +52 -0
  18. package/docs/classes/Value/isList.md +59 -0
  19. package/docs/classes/Value/isNaN.md +79 -0
  20. package/docs/classes/Value/isNull.md +59 -0
  21. package/docs/classes/Value/isNumber.md +80 -0
  22. package/docs/classes/Value/isNumeric.md +79 -0
  23. package/docs/classes/Value/isObject.md +68 -0
  24. package/docs/classes/Value/isScalar.md +72 -0
  25. package/docs/classes/Value/isString.md +67 -0
  26. package/docs/classes/Value/isSymbol.md +75 -0
  27. package/docs/classes/Value/isUndefined.md +67 -0
  28. package/docs/classes/Value/print.md +164 -0
  29. package/docs/classes/Value/printType.md +158 -0
  30. package/docs/classes/Value/setType.md +79 -0
  31. package/docs/classes/Value/toArray.md +85 -0
  32. package/docs/classes/Value/toAssoc.md +85 -0
  33. package/docs/classes/Value/toBool.md +71 -0
  34. package/docs/classes/Value/toBoolean.md +71 -0
  35. package/docs/classes/Value/toFloat.md +72 -0
  36. package/docs/classes/Value/toInt.md +72 -0
  37. package/docs/classes/Value/toInteger.md +72 -0
  38. package/docs/classes/Value/toList.md +77 -0
  39. package/docs/classes/Value/toObject.md +78 -0
  40. package/docs/classes/Value/toPrint.md +115 -0
  41. package/docs/classes/Value/toPrintType.md +110 -0
  42. package/docs/classes/Value/toString.md +134 -0
  43. package/docs/classes/Value.md +113 -0
  44. package/docs/classes.md +2 -0
  45. package/docs/constants.md +47 -0
  46. package/docs/helpers/value.md +95 -0
  47. package/docs/helpers.md +2 -0
  48. package/index.mjs +3 -0
  49. package/package.json +2 -2
  50. package/src/classes/Convert.mjs +818 -819
  51. package/src/classes/Type.mjs +1284 -1285
  52. package/src/classes/Value.mjs +2846 -0
  53. package/src/constants.mjs +14 -0
  54. package/src/helpers/array.mjs +107 -107
  55. package/src/helpers/empty.mjs +70 -70
  56. package/src/helpers/gettype.mjs +149 -133
  57. package/src/helpers/is_array.mjs +128 -128
  58. package/src/helpers/is_assoc.mjs +51 -51
  59. package/src/helpers/is_bigint.mjs +47 -47
  60. package/src/helpers/is_bool.mjs +43 -43
  61. package/src/helpers/is_boolean.mjs +43 -43
  62. package/src/helpers/is_class.mjs +87 -87
  63. package/src/helpers/is_float.mjs +67 -67
  64. package/src/helpers/is_function.mjs +74 -74
  65. package/src/helpers/is_infinity.mjs +52 -52
  66. package/src/helpers/is_int.mjs +57 -57
  67. package/src/helpers/is_integer.mjs +74 -74
  68. package/src/helpers/is_list.mjs +43 -43
  69. package/src/helpers/is_nan.mjs +51 -51
  70. package/src/helpers/is_null.mjs +37 -37
  71. package/src/helpers/is_number.mjs +49 -49
  72. package/src/helpers/is_numeric.mjs +64 -64
  73. package/src/helpers/is_object.mjs +72 -72
  74. package/src/helpers/is_scalar.mjs +45 -45
  75. package/src/helpers/is_string.mjs +46 -46
  76. package/src/helpers/is_symbol.mjs +46 -46
  77. package/src/helpers/is_undefined.mjs +44 -44
  78. package/src/helpers/print.mjs +245 -245
  79. package/src/helpers/print_type.mjs +261 -261
  80. package/src/helpers/settype.mjs +101 -101
  81. package/src/helpers/to_array.mjs +118 -118
  82. package/src/helpers/to_assoc.mjs +98 -98
  83. package/src/helpers/to_bool.mjs +68 -68
  84. package/src/helpers/to_boolean.mjs +64 -64
  85. package/src/helpers/to_float.mjs +72 -72
  86. package/src/helpers/to_int.mjs +93 -93
  87. package/src/helpers/to_integer.mjs +81 -81
  88. package/src/helpers/to_list.mjs +56 -56
  89. package/src/helpers/to_object.mjs +94 -94
  90. package/src/helpers/to_string.mjs +157 -157
  91. package/src/helpers/value.mjs +92 -0
  92. package/tests/classes/Convert.test.mjs +398 -399
  93. package/tests/classes/Type.test.mjs +1262 -1263
  94. package/tests/classes/Value.test.mjs +423 -0
  95. package/tests/constants.test.mjs +75 -0
  96. package/tests/helpers/array.test.mjs +58 -58
  97. package/tests/helpers/empty.test.mjs +22 -22
  98. package/tests/helpers/gettype.test.mjs +74 -74
  99. package/tests/helpers/is_array.test.mjs +404 -404
  100. package/tests/helpers/is_assoc.test.mjs +42 -42
  101. package/tests/helpers/is_bigint.test.mjs +51 -51
  102. package/tests/helpers/is_bool.test.mjs +43 -43
  103. package/tests/helpers/is_boolean.test.mjs +43 -43
  104. package/tests/helpers/is_class.test.mjs +84 -84
  105. package/tests/helpers/is_float.test.mjs +87 -87
  106. package/tests/helpers/is_function.test.mjs +83 -83
  107. package/tests/helpers/is_infinity.test.mjs +46 -46
  108. package/tests/helpers/is_int.test.mjs +45 -45
  109. package/tests/helpers/is_integer.test.mjs +64 -64
  110. package/tests/helpers/is_list.test.mjs +42 -42
  111. package/tests/helpers/is_nan.test.mjs +43 -43
  112. package/tests/helpers/is_null.test.mjs +17 -17
  113. package/tests/helpers/is_number.test.mjs +25 -25
  114. package/tests/helpers/is_numeric.test.mjs +30 -30
  115. package/tests/helpers/is_object.test.mjs +52 -52
  116. package/tests/helpers/is_scalar.test.mjs +21 -21
  117. package/tests/helpers/is_string.test.mjs +20 -20
  118. package/tests/helpers/is_symbol.test.mjs +20 -20
  119. package/tests/helpers/is_undefined.test.mjs +18 -18
  120. package/tests/helpers/print.test.mjs +62 -62
  121. package/tests/helpers/print_type.test.mjs +62 -62
  122. package/tests/helpers/settype.test.mjs +34 -34
  123. package/tests/helpers/to_array.test.mjs +38 -38
  124. package/tests/helpers/to_assoc.test.mjs +33 -33
  125. package/tests/helpers/to_bool.test.mjs +51 -51
  126. package/tests/helpers/to_boolean.test.mjs +51 -51
  127. package/tests/helpers/to_float.test.mjs +26 -26
  128. package/tests/helpers/to_int.test.mjs +48 -48
  129. package/tests/helpers/to_integer.test.mjs +48 -48
  130. package/tests/helpers/to_list.test.mjs +32 -32
  131. package/tests/helpers/to_object.test.mjs +36 -36
  132. package/tests/helpers/to_string.test.mjs +71 -71
  133. package/tests/helpers/value.test.mjs +68 -0
@@ -1,819 +1,818 @@
1
- import to_array from '../helpers/to_array.mjs';
2
- import to_assoc from '../helpers/to_assoc.mjs';
3
- import to_bool from '../helpers/to_bool.mjs';
4
- import to_float from '../helpers/to_float.mjs';
5
- import to_int from '../helpers/to_int.mjs';
6
- import to_list from '../helpers/to_list.mjs';
7
- import to_object from '../helpers/to_object.mjs';
8
- import to_string from '../helpers/to_string.mjs';
9
-
10
- /**
11
- * Класс `Convert` предоставляет методы для преобразования различных типов данных.
12
- *
13
- * ### Описание
14
- *
15
- * Класс `Convert` включает в себя статические методы, которые позволяют преобразовывать значения различных типов данных в другие типы.
16
- *
17
- * ### Методы
18
- *
19
- * - `Convert.toArray(value)` - Преобразует значение в массив.
20
- * - `Convert.toAssoc(value)` - Преобразует значение в ассоциативный массив.
21
- * - `Convert.toBool(value)` - Преобразует значение в логическое значение.
22
- * - `Convert.toBoolean(value)` - Преобразует значение в логическое значение.
23
- * - `Convert.toFloat(value)` - Преобразует значение в число с плавающей точкой.
24
- * - `Convert.toInt(value, base)` - Преобразует значение в целое число.
25
- * - `Convert.toInteger(value, base)` - Преобразует значение в целое число.
26
- * - `Convert.toList(value)` - Преобразует значение в список.
27
- * - `Convert.toObject(value)` - Преобразует значение в объект.
28
- * - `Convert.toString(value)` - Преобразует значение в строку.
29
- *
30
- * ### Примеры использования
31
- *
32
- * ```js
33
- * // Преобразование строки в массив
34
- * Convert.toArray('example'); // ["example"]
35
- *
36
- * // Преобразование числа в ассоциативный массив
37
- * Convert.toAssoc(123); // { 0: 123 }
38
- *
39
- * // Преобразование значения в логическое
40
- * Convert.toBool('example'); // true
41
- *
42
- * // Преобразование значения в число с плавающей точкой
43
- * Convert.toFloat('123.45'); // 123.45
44
- *
45
- * // Преобразование значения в целое число
46
- * Convert.toInt('123'); // 123
47
- *
48
- * // Преобразование значения в список
49
- * Convert.toList({ key: 'value' }); // ['value']
50
- *
51
- * // Преобразование значения в объект
52
- * Convert.toObject('example'); // { value: 'example' }
53
- *
54
- * // Преобразование значения в строку
55
- * Convert.toString(123); // '123'
56
- * ```
57
- */
58
- class Convert {
59
- /**
60
- * Приводит значение переменной к массиву.
61
- *
62
- * ### Описание
63
- *
64
- * Метод `Convert.toArray` используется для преобразования различных типов данных в массив. Если значение
65
- * уже является массивом (тип `Array` или ассоциативный массив), возвращается оно же. Объекты
66
- * (экземпляры классов) преобразуются в массив с одним элементом.
67
- *
68
- * #### Примечание
69
- *
70
- * Метод `Convert.toArray` для объектов (ассоциативных массивов) возвращает результат
71
- * работы функции `array`, которая создает объект-контейнер пар ключ-значение
72
- * (ассоциативный массив) с помощью конструкции `Object.create(null)`,
73
- * копирует все видимые пары в этот контейнер, а также добавляет итератор
74
- * `Symbol.iterator` для перебора контейнера в цикле `for-of`.
75
- *
76
- * ### Параметры
77
- *
78
- * - `value` (any)
79
- * Переменная, значение которой необходимо привести к массиву.
80
- *
81
- * ### Возвращаемое значение
82
- *
83
- * Возвращает массив, содержащий переданное значение. Если значение уже является массивом, возвращается оно же.
84
- *
85
- * ### Примеры использования
86
- *
87
- * 1. Преобразование строки в массив:
88
- *
89
- * ```js
90
- * const result = Convert.toArray('example');
91
- * // Результат: ["example"]
92
- * ```
93
- *
94
- * 2. Преобразование числа в массив:
95
- *
96
- * ```js
97
- * const result = Convert.toArray(123);
98
- * // Результат: [123]
99
- * ```
100
- *
101
- * 3. Преобразование массива (без изменений):
102
- *
103
- * ```js
104
- * const result = Convert.toArray([1, 2, 3]);
105
- * // Результат: [1, 2, 3]
106
- * ```
107
- *
108
- * 4. Преобразование объекта в массив:
109
- *
110
- * ```js
111
- * const result = Convert.toArray({ key: 'value' });
112
- * // Результат: { key: "value" }
113
- *
114
- * const proto = Object.getPrototypeOf(result);
115
- * // Результат: null
116
- *
117
- * for (const [key, value] of result) {
118
- * console.log(key, value);
119
- * }
120
- * // Результат: 'key', 'value'
121
- * ```
122
- *
123
- * 5. Преобразование экземпляра класса в массив:
124
- *
125
- * ```js
126
- * class MyClass {}
127
- *
128
- * const instance = new MyClass();
129
- * const result = Convert.toArray(instance);
130
- * // Результат: [instance]
131
- * ```
132
- *
133
- * 6. Преобразование null:
134
- *
135
- * ```js
136
- * const result = Convert.toArray(null);
137
- * // Результат: []
138
- * ```
139
- *
140
- * 7. Преобразование undefined:
141
- *
142
- * ```js
143
- * const result = Convert.toArray(undefined);
144
- * // Результат: []
145
- * ```
146
- *
147
- * @param {any} value Переменная, значение которой необходимо привести к массиву.
148
- * @returns {Array|Object} Возвращает приведенное к массиву значение переменной `value`.
149
- */
150
- static toArray(value) {
151
- return to_array(value);
152
- }
153
-
154
- /**
155
- * Преобразует значение в ассоциативный массив.
156
- *
157
- * ### Описание
158
- *
159
- * Метод `Convert.toAssoc` используется для преобразования различных типов данных в ассоциативный массив.
160
- * Если значение уже является объектом, возвращается оно же. Массивы преобразуются в объекты с
161
- * индексами в качестве ключей.
162
- *
163
- * #### Примечание
164
- *
165
- * Метод `Convert.toAssoc` для массивов возвращает объект, где ключами являются индексы элементов массива.
166
- *
167
- * ### Параметры
168
- *
169
- * - `value` (any)
170
- * Значение, которое необходимо преобразовать в ассоциативный массив.
171
- *
172
- * ### Возвращаемое значение
173
- *
174
- * Возвращает объект, представляющий ассоциативный массив. Если значение уже является объектом, возвращается оно же.
175
- *
176
- * ### Примеры использования
177
- *
178
- * 1. Преобразование строки в ассоциативный массив:
179
- *
180
- * ```js
181
- * const result = Convert.toAssoc('example');
182
- * // Результат: { 0: 'example' }
183
- * ```
184
- *
185
- * 2. Преобразование числа в ассоциативный массив:
186
- *
187
- * ```js
188
- * const result = Convert.toAssoc(123);
189
- * // Результат: { 0: 123 }
190
- * ```
191
- *
192
- * 3. Преобразование массива в ассоциативный массив:
193
- *
194
- * ```js
195
- * const result = Convert.toAssoc([1, 2, 3]);
196
- * // Результат: { 0: 1, 1: 2, 2: 3 }
197
- * ```
198
- *
199
- * 4. Преобразование ассоциативного массива (без изменений):
200
- *
201
- * ```js
202
- * const result = Convert.toAssoc({ key: 'value' });
203
- * // Результат: { key: 'value' }
204
- * ```
205
- *
206
- * 5. Преобразование экземпляра класса в ассоциативный массив:
207
- *
208
- * ```js
209
- * class MyClass {}
210
- *
211
- * const instance = new MyClass();
212
- * const result = Convert.toAssoc(instance);
213
- * // Результат: { 0: instance }
214
- * ```
215
- *
216
- * 6. Преобразование null:
217
- *
218
- * ```js
219
- * const result = Convert.toAssoc(null);
220
- * // Результат: {}
221
- * ```
222
- *
223
- * 7. Преобразование undefined:
224
- *
225
- * ```js
226
- * const result = Convert.toAssoc(undefined);
227
- * // Результат: {}
228
- * ```
229
- *
230
- * @param {any} value Значение, которое необходимо преобразовать.
231
- * @returns {Object} Возвращает объект, представляющий ассоциативный массив.
232
- */
233
- static toAssoc(value) {
234
- return to_assoc(value);
235
- }
236
-
237
- /**
238
- * Преобразует значение в логическое значение.
239
- *
240
- * ### Описание
241
- *
242
- * Метод `Convert.toBool` используется для преобразования различных типов данных в логическое значение.
243
- * Если значение является примитивом типа `boolean`, возвращается оно же. Для всех других типов данных
244
- * метод возвращает `true` для истинных значений и `false` для ложных значений.
245
- *
246
- * ### Параметры
247
- *
248
- * - `value` (any)
249
- * Значение, которое необходимо преобразовать в логическое значение.
250
- *
251
- * ### Возвращаемое значение
252
- *
253
- * Возвращает логическое значение, соответствующее переданному значению.
254
- *
255
- * ### Примеры использования
256
- *
257
- * 1. Преобразование строки в логическое значение:
258
- *
259
- * ```js
260
- * const result = Convert.toBool('example');
261
- * // Результат: true
262
- * ```
263
- *
264
- * 2. Преобразование числа в логическое значение:
265
- *
266
- * ```js
267
- * const result = Convert.toBool(123);
268
- * // Результат: true
269
- * ```
270
- *
271
- * 3. Преобразование булевых значений:
272
- *
273
- * ```js
274
- * const result1 = Convert.toBool(true);
275
- * // Результат: true
276
- *
277
- * const result2 = Convert.toBool(false);
278
- * // Результат: false
279
- * ```
280
- *
281
- * 4. Преобразование других значений:
282
- *
283
- * ```js
284
- * const result1 = Convert.toBool(null);
285
- * // Результат: false
286
- *
287
- * const result2 = Convert.toBool(undefined);
288
- * // Результат: false
289
- *
290
- * const result3 = Convert.toBool([]);
291
- * // Результат: false
292
- *
293
- * const result4 = Convert.toBool({});
294
- * // Результат: false
295
- * ```
296
- *
297
- * @param {any} value Значение, которое необходимо преобразовать.
298
- * @returns {boolean} Возвращает логическое значение, соответствующее переданному значению.
299
- */
300
- static toBool(value) {
301
- return to_bool(value);
302
- }
303
-
304
- /**
305
- * Преобразует значение в логическое значение.
306
- *
307
- * ### Описание
308
- *
309
- * Метод `Convert.toBoolean` используется для преобразования различных типов данных в логическое значение.
310
- * Если значение является примитивом типа `boolean`, возвращается оно же. Для всех других типов данных
311
- * метод возвращает `true` для истинных значений и `false` для ложных значений.
312
- *
313
- * ### Параметры
314
- *
315
- * - `value` (any)
316
- * Значение, которое необходимо преобразовать в логическое значение.
317
- *
318
- * ### Возвращаемое значение
319
- *
320
- * Возвращает логическое значение, соответствующее переданному значению.
321
- *
322
- * ### Примеры использования
323
- *
324
- * 1. Преобразование строки в логическое значение:
325
- *
326
- * ```js
327
- * const result = Convert.toBoolean('example');
328
- * // Результат: true
329
- * ```
330
- *
331
- * 2. Преобразование числа в логическое значение:
332
- *
333
- * ```js
334
- * const result = Convert.toBoolean(123);
335
- * // Результат: true
336
- * ```
337
- *
338
- * 3. Преобразование булевых значений:
339
- *
340
- * ```js
341
- * const result1 = Convert.toBoolean(true);
342
- * // Результат: true
343
- *
344
- * const result2 = Convert.toBoolean(false);
345
- * // Результат: false
346
- * ```
347
- *
348
- * 4. Преобразование других значений:
349
- *
350
- * ```js
351
- * const result1 = Convert.toBoolean(null);
352
- * // Результат: false
353
- *
354
- * const result2 = Convert.toBoolean(undefined);
355
- * // Результат: false
356
- *
357
- * const result3 = Convert.toBoolean([]);
358
- * // Результат: false
359
- *
360
- * const result4 = Convert.toBoolean({});
361
- * // Результат: false
362
- * ```
363
- *
364
- * @param {any} value Значение, которое необходимо преобразовать.
365
- * @returns {boolean} Возвращает логическое значение, соответствующее переданному значению.
366
- */
367
- static toBoolean(value) {
368
- return to_bool(value);
369
- }
370
-
371
- /**
372
- * Приводит значение переменной к числу с плавающей точкой.
373
- *
374
- * ### Описание
375
- *
376
- * Метод `Convert.toFloat` используется для преобразования различных типов данных в число с плавающей точкой. Если значение не является числом или строкой, метод возвращает `1` для истинных значений и `0` для ложных значений.
377
- *
378
- * ### Параметры
379
- *
380
- * - `value` (any)
381
- * Переменная, значение которой необходимо привести к числу с плавающей точкой.
382
- *
383
- * ### Возвращаемое значение
384
- *
385
- * Возвращает число с плавающей точкой, соответствующее переданному значению.
386
- *
387
- * ### Примеры использования
388
- *
389
- * 1. Преобразование строки в число с плавающей точкой:
390
- *
391
- * ```js
392
- * const result = Convert.toFloat('123.45');
393
- * // Результат: 123.45
394
- * ```
395
- *
396
- * 2. Преобразование целого числа в число с плавающей точкой:
397
- *
398
- * ```js
399
- * const result = Convert.toFloat(123);
400
- * // Результат: 123.0
401
- * ```
402
- *
403
- * 3. Преобразование булевых значений:
404
- *
405
- * ```js
406
- * const result1 = Convert.toFloat(true);
407
- * // Результат: 1.0
408
- *
409
- * const result2 = Convert.toFloat(false);
410
- * // Результат: 0.0
411
- * ```
412
- *
413
- * 4. Преобразование других значений:
414
- *
415
- * ```js
416
- * const result1 = Convert.toFloat(null);
417
- * // Результат: 0.0
418
- *
419
- * const result2 = Convert.toFloat(undefined);
420
- * // Результат: 0.0
421
- *
422
- * const result3 = Convert.toFloat('example');
423
- * // Результат: 0.0
424
- * ```
425
- *
426
- * @param {any} value Переменная, значение которой необходимо привести к числу с плавающей точкой.
427
- * @returns {number} Возвращает приведенное к числу с плавающей точкой значение переменной `value`.
428
- */
429
- static toFloat(value) {
430
- return to_float(value);
431
- }
432
-
433
- /**
434
- * Приводит значение переменной к целому числу.
435
- *
436
- * ### Описание
437
- *
438
- * Метод `Convert.toInt` используется для преобразования различных типов данных в целое число. Если значение не является числом или строкой, метод возвращает `1` для истинных значений и `0` для ложных значений.
439
- *
440
- * ### Параметры
441
- *
442
- * - `value` (any)
443
- * Переменная, значение которой необходимо привести к целому числу.
444
- *
445
- * - `base` (number)
446
- * Основание системы счисления для преобразования строки в число. По умолчанию `10`.
447
- *
448
- * ### Возвращаемое значение
449
- *
450
- * Возвращает целое число, соответствующее переданному значению.
451
- *
452
- * ### Примеры использования
453
- *
454
- * 1. Преобразование строки в целое число:
455
- *
456
- * ```js
457
- * const result = Convert.toInt('123');
458
- * // Результат: 123
459
- * ```
460
- *
461
- * 2. Преобразование числа с плавающей точкой в целое число:
462
- *
463
- * ```js
464
- * const result = Convert.toInt(123.45);
465
- * // Результат: 123
466
- * ```
467
- *
468
- * 3. Преобразование булевых значений:
469
- *
470
- * ```js
471
- * const result1 = Convert.toInt(true);
472
- * // Результат: 1
473
- *
474
- * const result2 = Convert.toInt(false);
475
- * // Результат: 0
476
- * ```
477
- *
478
- * 4. Преобразование других значений:
479
- *
480
- * ```js
481
- * const result1 = Convert.toInt(null);
482
- * // Результат: 0
483
- *
484
- * const result2 = Convert.toInt(undefined);
485
- * // Результат: 0
486
- *
487
- * const result3 = Convert.toInt('example');
488
- * // Результат: 0
489
- * ```
490
- *
491
- * 5. Преобразование строки с основанием системы счисления:
492
- *
493
- * ```js
494
- * const result1 = Convert.toInt('10', 2);
495
- * // Результат: 2
496
- *
497
- * const result2 = Convert.toInt('A', 16);
498
- * // Результат: 10
499
- *
500
- * const result3 = Convert.toInt('7', 8);
501
- * // Результат: 7
502
- * ```
503
- *
504
- * @param {any} value Переменная, значение которой необходимо привести к целому числу.
505
- * @param {number} [base=10] Основание системы счисления для преобразования строки в число.
506
- * @returns {number} Возвращает приведенное к целому числу значение переменной `value`.
507
- */
508
- static toInt(value, base = 10) {
509
- return to_int(value, base);
510
- }
511
-
512
- /**
513
- * Приводит значение переменной к целому числу.
514
- *
515
- * ### Описание
516
- *
517
- * Метод `Convert.toInteger` используется для преобразования различных типов данных в целое число. Если значение не является числом или строкой, метод возвращает `1` для истинных значений и `0` для ложных значений.
518
- *
519
- * ### Параметры
520
- *
521
- * - `value` (any)
522
- * Переменная, значение которой необходимо привести к целому числу.
523
- *
524
- * - `base` (number)
525
- * Основание системы счисления для преобразования строки в число. По умолчанию `10`.
526
- *
527
- * ### Возвращаемое значение
528
- *
529
- * Возвращает целое число, соответствующее переданному значению.
530
- *
531
- * ### Примеры использования
532
- *
533
- * 1. Преобразование строки в целое число:
534
- *
535
- * ```js
536
- * const result = Convert.toInteger('123');
537
- * // Результат: 123
538
- * ```
539
- *
540
- * 2. Преобразование числа с плавающей точкой в целое число:
541
- *
542
- * ```js
543
- * const result = Convert.toInteger(123.45);
544
- * // Результат: 123
545
- * ```
546
- *
547
- * 3. Преобразование булевых значений:
548
- *
549
- * ```js
550
- * const result1 = Convert.toInteger(true);
551
- * // Результат: 1
552
- *
553
- * const result2 = Convert.toInteger(false);
554
- * // Результат: 0
555
- * ```
556
- *
557
- * 4. Преобразование других значений:
558
- *
559
- * ```js
560
- * const result1 = Convert.toInteger(null);
561
- * // Результат: 0
562
- *
563
- * const result2 = Convert.toInteger(undefined);
564
- * // Результат: 0
565
- *
566
- * const result3 = Convert.toInteger('example');
567
- * // Результат: 0
568
- * ```
569
- *
570
- * 5. Преобразование строки с основанием системы счисления:
571
- *
572
- * ```js
573
- * const result1 = Convert.toInteger('10', 2);
574
- * // Результат: 2
575
- *
576
- * const result2 = Convert.toInteger('A', 16);
577
- * // Результат: 10
578
- *
579
- * const result3 = Convert.toInteger('7', 8);
580
- * // Результат: 7
581
- * ```
582
- *
583
- * @param {any} value Переменная, значение которой необходимо привести к целому числу.
584
- * @param {number} [base=10] Основание системы счисления для преобразования строки в число.
585
- * @returns {number} Возвращает приведенное к целому числу значение переменной `value`.
586
- */
587
- static toInteger(value, base = 10) {
588
- return to_int(value, base);
589
- }
590
-
591
- /**
592
- * Преобразует значение в список.
593
- *
594
- * ### Параметры
595
- *
596
- * - `value` (any)
597
- * Значение, которое необходимо преобразовать.
598
- *
599
- * ### Описание
600
- *
601
- * Метод `Convert.toList` преобразует переданное значение в список.
602
- *
603
- * Она выполняет следующие проверки:
604
- *
605
- * 1. **Null и Undefined**: Возвращает пустой массив для значений `null` и `undefined`.
606
- * 2. **Array**: Возвращает исходный массив, если он передан.
607
- * 3. **Object**: Возвращает массив значений объекта, если передан ассоциативный массив.
608
- * 4. **Примитивы и другие типы**: Возвращает массив, содержащий переданное значение.
609
- *
610
- * ### Возвращаемое значение
611
- *
612
- * Возвращает массив, представляющий список значений.
613
- *
614
- * ### Примеры использования
615
- *
616
- * ```js
617
- * Convert.toList(null); // []
618
- * Convert.toList(undefined); // []
619
- * Convert.toList([1, 2, 3]); // [1, 2, 3]
620
- * Convert.toList({ key: 'value' }); // ['value']
621
- * Convert.toList('example'); // ['example']
622
- * Convert.toList(123); // [123]
623
- * ```
624
- *
625
- * @param {any} value Значение, которое необходимо преобразовать.
626
- * @returns {Array} Возвращает массив, представляющий список значений.
627
- */
628
- static toList(value) {
629
- return to_list(value);
630
- }
631
-
632
- /**
633
- * Приводит значение переменной к объекту.
634
- *
635
- * ### Описание
636
- *
637
- * Метод `Convert.toObject` используется для преобразования различных типов данных в объект. Если значение уже является объектом, оно возвращается без изменений. Если значение является классом, возвращается новый экземпляр этого класса. Если значение является массивом, элементы массива копируются в новый объект. Для других значений создается объект с полем `value`, содержащим это значение.
638
- *
639
- * ### Параметры
640
- *
641
- * - `value` (any)
642
- * Переменная, значение которой необходимо привести к объекту.
643
- *
644
- * ### Возвращаемое значение
645
- *
646
- * Возвращает объект, соответствующий переданному значению.
647
- *
648
- * ### Примеры использования
649
- *
650
- * 1. Преобразование объекта:
651
- *
652
- * ```js
653
- * class MyClass {}
654
- * const obj = new MyClass();
655
- * const result = Convert.toObject(obj);
656
- * // Результат: obj
657
- * ```
658
- *
659
- * 2. Преобразование класса:
660
- *
661
- * ```js
662
- * class MyClass {}
663
- * const result = Convert.toObject(MyClass);
664
- * // Результат: экземпляр MyClass
665
- * ```
666
- *
667
- * 3. Преобразование null и undefined:
668
- *
669
- * ```js
670
- * const result1 = Convert.toObject(null);
671
- * // Результат: экземпляр анонимного класса
672
- *
673
- * const result2 = Convert.toObject(undefined);
674
- * // Результат: экземпляр анонимного класса
675
- * ```
676
- *
677
- * 4. Преобразование массива:
678
- *
679
- * ```js
680
- * const arr = [1, 2, 3];
681
- * const result = Convert.toObject(arr);
682
- * // Результат: объект с элементами массива
683
- * ```
684
- *
685
- * 5. Преобразование других значений:
686
- *
687
- * ```js
688
- * const result = Convert.toObject('example');
689
- * // Результат: объект с полем value, содержащим 'example'
690
- * ```
691
- *
692
- * @param {any} value Переменная, значение которой необходимо привести к объекту.
693
- * @returns {object} Возвращает приведенное к объекту значение переменной `value`.
694
- */
695
- static toObject(value) {
696
- return to_object(value);
697
- }
698
-
699
- /**
700
- * Приводит значение переменной к строке.
701
- *
702
- * ### Описание
703
- *
704
- * Метод `Convert.toString` используется для преобразования различных типов данных в строку. Он обрабатывает массивы, объекты, классы, функции, символы и другие типы данных, возвращая их строковое представление.
705
- *
706
- * ### Параметры
707
- *
708
- * - `value` (any)
709
- * Переменная, значение которой необходимо привести к строке.
710
- *
711
- * ### Возвращаемое значение
712
- *
713
- * Возвращает строку, соответствующую переданному значению.
714
- *
715
- * ### Примеры использования
716
- *
717
- * 1. Преобразование строки:
718
- *
719
- * ```js
720
- * const result = Convert.toString('example');
721
- * // Результат: 'example'
722
- * ```
723
- *
724
- * 2. Преобразование числа:
725
- *
726
- * ```js
727
- * const result = Convert.toString(123);
728
- * // Результат: '123'
729
- * ```
730
- *
731
- * 3. Преобразование булевых значений:
732
- *
733
- * ```js
734
- * const result1 = Convert.toString(true);
735
- * // Результат: 'true'
736
- *
737
- * const result2 = Convert.toString(false);
738
- * // Результат: 'false'
739
- * ```
740
- *
741
- * 4. Преобразование null и undefined:
742
- *
743
- * ```js
744
- * const result1 = Convert.toString(null);
745
- * // Результат: 'null'
746
- *
747
- * const result2 = Convert.toString(undefined);
748
- * // Результат: 'undefined'
749
- * ```
750
- *
751
- * 5. Преобразование массива:
752
- *
753
- * ```js
754
- * const arr = [1, 2, 3];
755
- * const result = Convert.toString(arr);
756
- * // Результат: '[\n 1,\n 2,\n 3,\n]'
757
- * ```
758
- *
759
- * 6. Преобразование объекта:
760
- *
761
- * ```js
762
- * const obj = { key: 'value' };
763
- * const result = Convert.toString(obj);
764
- * // Результат: '{\n key: 'value',\n}'
765
- * ```
766
- *
767
- * 7. Преобразование функции:
768
- *
769
- * ```js
770
- * const func = function() {};
771
- * const result = Convert.toString(func);
772
- * // Результат: 'function func() {}'
773
- * ```
774
- *
775
- * 8. Преобразование символа:
776
- *
777
- * ```js
778
- * const symbol = Symbol('example');
779
- * const result = Convert.toString(symbol);
780
- * // Результат: 'Symbol(example)'
781
- * ```
782
- *
783
- * 9. Преобразование BigInt:
784
- *
785
- * ```js
786
- * const bigInt = BigInt(123);
787
- * const result = Convert.toString(bigInt);
788
- * // Результат: '123'
789
- * ```
790
- *
791
- * 10. Преобразование класса:
792
- *
793
- * ```js
794
- * class MyClass {
795
- * static test = 'test';
796
- * }
797
- * const result = Convert.toString(MyClass);
798
- * // Результат: 'class MyClass {}'
799
- * ```
800
- *
801
- * 11. Преобразование экземпляра класса:
802
- *
803
- * ```js
804
- * class MyClass {}
805
- * const instance = new MyClass();
806
- * const result = Convert.toString(instance);
807
- * // Результат: 'object MyClass'
808
- * ```
809
- *
810
- * @param {any} value Переменная, значение которой необходимо привести к строке.
811
- * @returns {string} Возвращает приведенное к строке значение переменной `value`.
812
- */
813
- static toString(value) {
814
- return to_string(value);
815
- }
816
- }
817
-
818
- export default Convert;
819
-
1
+ import to_array from '../helpers/to_array.mjs';
2
+ import to_assoc from '../helpers/to_assoc.mjs';
3
+ import to_bool from '../helpers/to_bool.mjs';
4
+ import to_float from '../helpers/to_float.mjs';
5
+ import to_int from '../helpers/to_int.mjs';
6
+ import to_list from '../helpers/to_list.mjs';
7
+ import to_object from '../helpers/to_object.mjs';
8
+ import to_string from '../helpers/to_string.mjs';
9
+
10
+ /**
11
+ * Класс `Convert` предоставляет методы для преобразования различных типов данных.
12
+ *
13
+ * ### Описание
14
+ *
15
+ * Класс `Convert` включает в себя статические методы, которые позволяют преобразовывать значения различных типов данных в другие типы.
16
+ *
17
+ * ### Методы
18
+ *
19
+ * - `Convert.toArray(value)` - Преобразует значение в массив.
20
+ * - `Convert.toAssoc(value)` - Преобразует значение в ассоциативный массив.
21
+ * - `Convert.toBool(value)` - Преобразует значение в логическое значение.
22
+ * - `Convert.toBoolean(value)` - Преобразует значение в логическое значение.
23
+ * - `Convert.toFloat(value)` - Преобразует значение в число с плавающей точкой.
24
+ * - `Convert.toInt(value, base)` - Преобразует значение в целое число.
25
+ * - `Convert.toInteger(value, base)` - Преобразует значение в целое число.
26
+ * - `Convert.toList(value)` - Преобразует значение в список.
27
+ * - `Convert.toObject(value)` - Преобразует значение в объект.
28
+ * - `Convert.toString(value)` - Преобразует значение в строку.
29
+ *
30
+ * ### Примеры использования
31
+ *
32
+ * ```js
33
+ * // Преобразование строки в массив
34
+ * Convert.toArray('example'); // ["example"]
35
+ *
36
+ * // Преобразование числа в ассоциативный массив
37
+ * Convert.toAssoc(123); // { 0: 123 }
38
+ *
39
+ * // Преобразование значения в логическое
40
+ * Convert.toBool('example'); // true
41
+ *
42
+ * // Преобразование значения в число с плавающей точкой
43
+ * Convert.toFloat('123.45'); // 123.45
44
+ *
45
+ * // Преобразование значения в целое число
46
+ * Convert.toInt('123'); // 123
47
+ *
48
+ * // Преобразование значения в список
49
+ * Convert.toList({ key: 'value' }); // ['value']
50
+ *
51
+ * // Преобразование значения в объект
52
+ * Convert.toObject('example'); // { value: 'example' }
53
+ *
54
+ * // Преобразование значения в строку
55
+ * Convert.toString(123); // '123'
56
+ * ```
57
+ */
58
+ class Convert {
59
+ /**
60
+ * Приводит значение переменной к массиву.
61
+ *
62
+ * ### Описание
63
+ *
64
+ * Метод `Convert.toArray` используется для преобразования различных типов данных в массив. Если значение
65
+ * уже является массивом (тип `Array` или ассоциативный массив), возвращается оно же. Объекты
66
+ * (экземпляры классов) преобразуются в массив с одним элементом.
67
+ *
68
+ * #### Примечание
69
+ *
70
+ * Метод `Convert.toArray` для объектов (ассоциативных массивов) возвращает результат
71
+ * работы функции `array`, которая создает объект-контейнер пар ключ-значение
72
+ * (ассоциативный массив) с помощью конструкции `Object.create(null)`,
73
+ * копирует все видимые пары в этот контейнер, а также добавляет итератор
74
+ * `Symbol.iterator` для перебора контейнера в цикле `for-of`.
75
+ *
76
+ * ### Параметры
77
+ *
78
+ * - `value` (any)
79
+ * Переменная, значение которой необходимо привести к массиву.
80
+ *
81
+ * ### Возвращаемое значение
82
+ *
83
+ * Возвращает массив, содержащий переданное значение. Если значение уже является массивом, возвращается оно же.
84
+ *
85
+ * ### Примеры использования
86
+ *
87
+ * 1. Преобразование строки в массив:
88
+ *
89
+ * ```js
90
+ * const result = Convert.toArray('example');
91
+ * // Результат: ["example"]
92
+ * ```
93
+ *
94
+ * 2. Преобразование числа в массив:
95
+ *
96
+ * ```js
97
+ * const result = Convert.toArray(123);
98
+ * // Результат: [123]
99
+ * ```
100
+ *
101
+ * 3. Преобразование массива (без изменений):
102
+ *
103
+ * ```js
104
+ * const result = Convert.toArray([1, 2, 3]);
105
+ * // Результат: [1, 2, 3]
106
+ * ```
107
+ *
108
+ * 4. Преобразование объекта в массив:
109
+ *
110
+ * ```js
111
+ * const result = Convert.toArray({ key: 'value' });
112
+ * // Результат: { key: "value" }
113
+ *
114
+ * const proto = Object.getPrototypeOf(result);
115
+ * // Результат: null
116
+ *
117
+ * for (const [key, value] of result) {
118
+ * console.log(key, value);
119
+ * }
120
+ * // Результат: 'key', 'value'
121
+ * ```
122
+ *
123
+ * 5. Преобразование экземпляра класса в массив:
124
+ *
125
+ * ```js
126
+ * class MyClass {}
127
+ *
128
+ * const instance = new MyClass();
129
+ * const result = Convert.toArray(instance);
130
+ * // Результат: [instance]
131
+ * ```
132
+ *
133
+ * 6. Преобразование null:
134
+ *
135
+ * ```js
136
+ * const result = Convert.toArray(null);
137
+ * // Результат: []
138
+ * ```
139
+ *
140
+ * 7. Преобразование undefined:
141
+ *
142
+ * ```js
143
+ * const result = Convert.toArray(undefined);
144
+ * // Результат: []
145
+ * ```
146
+ *
147
+ * @param {any} value Переменная, значение которой необходимо привести к массиву.
148
+ * @returns {Array|Object} Возвращает приведенное к массиву значение переменной `value`.
149
+ */
150
+ static toArray(value) {
151
+ return to_array(value);
152
+ }
153
+
154
+ /**
155
+ * Преобразует значение в ассоциативный массив.
156
+ *
157
+ * ### Описание
158
+ *
159
+ * Метод `Convert.toAssoc` используется для преобразования различных типов данных в ассоциативный массив.
160
+ * Если значение уже является объектом, возвращается оно же. Массивы преобразуются в объекты с
161
+ * индексами в качестве ключей.
162
+ *
163
+ * #### Примечание
164
+ *
165
+ * Метод `Convert.toAssoc` для массивов возвращает объект, где ключами являются индексы элементов массива.
166
+ *
167
+ * ### Параметры
168
+ *
169
+ * - `value` (any)
170
+ * Значение, которое необходимо преобразовать в ассоциативный массив.
171
+ *
172
+ * ### Возвращаемое значение
173
+ *
174
+ * Возвращает объект, представляющий ассоциативный массив. Если значение уже является объектом, возвращается оно же.
175
+ *
176
+ * ### Примеры использования
177
+ *
178
+ * 1. Преобразование строки в ассоциативный массив:
179
+ *
180
+ * ```js
181
+ * const result = Convert.toAssoc('example');
182
+ * // Результат: { 0: 'example' }
183
+ * ```
184
+ *
185
+ * 2. Преобразование числа в ассоциативный массив:
186
+ *
187
+ * ```js
188
+ * const result = Convert.toAssoc(123);
189
+ * // Результат: { 0: 123 }
190
+ * ```
191
+ *
192
+ * 3. Преобразование массива в ассоциативный массив:
193
+ *
194
+ * ```js
195
+ * const result = Convert.toAssoc([1, 2, 3]);
196
+ * // Результат: { 0: 1, 1: 2, 2: 3 }
197
+ * ```
198
+ *
199
+ * 4. Преобразование ассоциативного массива (без изменений):
200
+ *
201
+ * ```js
202
+ * const result = Convert.toAssoc({ key: 'value' });
203
+ * // Результат: { key: 'value' }
204
+ * ```
205
+ *
206
+ * 5. Преобразование экземпляра класса в ассоциативный массив:
207
+ *
208
+ * ```js
209
+ * class MyClass {}
210
+ *
211
+ * const instance = new MyClass();
212
+ * const result = Convert.toAssoc(instance);
213
+ * // Результат: { 0: instance }
214
+ * ```
215
+ *
216
+ * 6. Преобразование null:
217
+ *
218
+ * ```js
219
+ * const result = Convert.toAssoc(null);
220
+ * // Результат: {}
221
+ * ```
222
+ *
223
+ * 7. Преобразование undefined:
224
+ *
225
+ * ```js
226
+ * const result = Convert.toAssoc(undefined);
227
+ * // Результат: {}
228
+ * ```
229
+ *
230
+ * @param {any} value Значение, которое необходимо преобразовать.
231
+ * @returns {Object} Возвращает объект, представляющий ассоциативный массив.
232
+ */
233
+ static toAssoc(value) {
234
+ return to_assoc(value);
235
+ }
236
+
237
+ /**
238
+ * Преобразует значение в логическое значение.
239
+ *
240
+ * ### Описание
241
+ *
242
+ * Метод `Convert.toBool` используется для преобразования различных типов данных в логическое значение.
243
+ * Если значение является примитивом типа `boolean`, возвращается оно же. Для всех других типов данных
244
+ * метод возвращает `true` для истинных значений и `false` для ложных значений.
245
+ *
246
+ * ### Параметры
247
+ *
248
+ * - `value` (any)
249
+ * Значение, которое необходимо преобразовать в логическое значение.
250
+ *
251
+ * ### Возвращаемое значение
252
+ *
253
+ * Возвращает логическое значение, соответствующее переданному значению.
254
+ *
255
+ * ### Примеры использования
256
+ *
257
+ * 1. Преобразование строки в логическое значение:
258
+ *
259
+ * ```js
260
+ * const result = Convert.toBool('example');
261
+ * // Результат: true
262
+ * ```
263
+ *
264
+ * 2. Преобразование числа в логическое значение:
265
+ *
266
+ * ```js
267
+ * const result = Convert.toBool(123);
268
+ * // Результат: true
269
+ * ```
270
+ *
271
+ * 3. Преобразование булевых значений:
272
+ *
273
+ * ```js
274
+ * const result1 = Convert.toBool(true);
275
+ * // Результат: true
276
+ *
277
+ * const result2 = Convert.toBool(false);
278
+ * // Результат: false
279
+ * ```
280
+ *
281
+ * 4. Преобразование других значений:
282
+ *
283
+ * ```js
284
+ * const result1 = Convert.toBool(null);
285
+ * // Результат: false
286
+ *
287
+ * const result2 = Convert.toBool(undefined);
288
+ * // Результат: false
289
+ *
290
+ * const result3 = Convert.toBool([]);
291
+ * // Результат: false
292
+ *
293
+ * const result4 = Convert.toBool({});
294
+ * // Результат: false
295
+ * ```
296
+ *
297
+ * @param {any} value Значение, которое необходимо преобразовать.
298
+ * @returns {boolean} Возвращает логическое значение, соответствующее переданному значению.
299
+ */
300
+ static toBool(value) {
301
+ return to_bool(value);
302
+ }
303
+
304
+ /**
305
+ * Преобразует значение в логическое значение.
306
+ *
307
+ * ### Описание
308
+ *
309
+ * Метод `Convert.toBoolean` используется для преобразования различных типов данных в логическое значение.
310
+ * Если значение является примитивом типа `boolean`, возвращается оно же. Для всех других типов данных
311
+ * метод возвращает `true` для истинных значений и `false` для ложных значений.
312
+ *
313
+ * ### Параметры
314
+ *
315
+ * - `value` (any)
316
+ * Значение, которое необходимо преобразовать в логическое значение.
317
+ *
318
+ * ### Возвращаемое значение
319
+ *
320
+ * Возвращает логическое значение, соответствующее переданному значению.
321
+ *
322
+ * ### Примеры использования
323
+ *
324
+ * 1. Преобразование строки в логическое значение:
325
+ *
326
+ * ```js
327
+ * const result = Convert.toBoolean('example');
328
+ * // Результат: true
329
+ * ```
330
+ *
331
+ * 2. Преобразование числа в логическое значение:
332
+ *
333
+ * ```js
334
+ * const result = Convert.toBoolean(123);
335
+ * // Результат: true
336
+ * ```
337
+ *
338
+ * 3. Преобразование булевых значений:
339
+ *
340
+ * ```js
341
+ * const result1 = Convert.toBoolean(true);
342
+ * // Результат: true
343
+ *
344
+ * const result2 = Convert.toBoolean(false);
345
+ * // Результат: false
346
+ * ```
347
+ *
348
+ * 4. Преобразование других значений:
349
+ *
350
+ * ```js
351
+ * const result1 = Convert.toBoolean(null);
352
+ * // Результат: false
353
+ *
354
+ * const result2 = Convert.toBoolean(undefined);
355
+ * // Результат: false
356
+ *
357
+ * const result3 = Convert.toBoolean([]);
358
+ * // Результат: false
359
+ *
360
+ * const result4 = Convert.toBoolean({});
361
+ * // Результат: false
362
+ * ```
363
+ *
364
+ * @param {any} value Значение, которое необходимо преобразовать.
365
+ * @returns {boolean} Возвращает логическое значение, соответствующее переданному значению.
366
+ */
367
+ static toBoolean(value) {
368
+ return to_bool(value);
369
+ }
370
+
371
+ /**
372
+ * Приводит значение переменной к числу с плавающей точкой.
373
+ *
374
+ * ### Описание
375
+ *
376
+ * Метод `Convert.toFloat` используется для преобразования различных типов данных в число с плавающей точкой. Если значение не является числом или строкой, метод возвращает `1` для истинных значений и `0` для ложных значений.
377
+ *
378
+ * ### Параметры
379
+ *
380
+ * - `value` (any)
381
+ * Переменная, значение которой необходимо привести к числу с плавающей точкой.
382
+ *
383
+ * ### Возвращаемое значение
384
+ *
385
+ * Возвращает число с плавающей точкой, соответствующее переданному значению.
386
+ *
387
+ * ### Примеры использования
388
+ *
389
+ * 1. Преобразование строки в число с плавающей точкой:
390
+ *
391
+ * ```js
392
+ * const result = Convert.toFloat('123.45');
393
+ * // Результат: 123.45
394
+ * ```
395
+ *
396
+ * 2. Преобразование целого числа в число с плавающей точкой:
397
+ *
398
+ * ```js
399
+ * const result = Convert.toFloat(123);
400
+ * // Результат: 123.0
401
+ * ```
402
+ *
403
+ * 3. Преобразование булевых значений:
404
+ *
405
+ * ```js
406
+ * const result1 = Convert.toFloat(true);
407
+ * // Результат: 1.0
408
+ *
409
+ * const result2 = Convert.toFloat(false);
410
+ * // Результат: 0.0
411
+ * ```
412
+ *
413
+ * 4. Преобразование других значений:
414
+ *
415
+ * ```js
416
+ * const result1 = Convert.toFloat(null);
417
+ * // Результат: 0.0
418
+ *
419
+ * const result2 = Convert.toFloat(undefined);
420
+ * // Результат: 0.0
421
+ *
422
+ * const result3 = Convert.toFloat('example');
423
+ * // Результат: 0.0
424
+ * ```
425
+ *
426
+ * @param {any} value Переменная, значение которой необходимо привести к числу с плавающей точкой.
427
+ * @returns {number} Возвращает приведенное к числу с плавающей точкой значение переменной `value`.
428
+ */
429
+ static toFloat(value) {
430
+ return to_float(value);
431
+ }
432
+
433
+ /**
434
+ * Приводит значение переменной к целому числу.
435
+ *
436
+ * ### Описание
437
+ *
438
+ * Метод `Convert.toInt` используется для преобразования различных типов данных в целое число. Если значение не является числом или строкой, метод возвращает `1` для истинных значений и `0` для ложных значений.
439
+ *
440
+ * ### Параметры
441
+ *
442
+ * - `value` (any)
443
+ * Переменная, значение которой необходимо привести к целому числу.
444
+ *
445
+ * - `base` (number)
446
+ * Основание системы счисления для преобразования строки в число. По умолчанию `10`.
447
+ *
448
+ * ### Возвращаемое значение
449
+ *
450
+ * Возвращает целое число, соответствующее переданному значению.
451
+ *
452
+ * ### Примеры использования
453
+ *
454
+ * 1. Преобразование строки в целое число:
455
+ *
456
+ * ```js
457
+ * const result = Convert.toInt('123');
458
+ * // Результат: 123
459
+ * ```
460
+ *
461
+ * 2. Преобразование числа с плавающей точкой в целое число:
462
+ *
463
+ * ```js
464
+ * const result = Convert.toInt(123.45);
465
+ * // Результат: 123
466
+ * ```
467
+ *
468
+ * 3. Преобразование булевых значений:
469
+ *
470
+ * ```js
471
+ * const result1 = Convert.toInt(true);
472
+ * // Результат: 1
473
+ *
474
+ * const result2 = Convert.toInt(false);
475
+ * // Результат: 0
476
+ * ```
477
+ *
478
+ * 4. Преобразование других значений:
479
+ *
480
+ * ```js
481
+ * const result1 = Convert.toInt(null);
482
+ * // Результат: 0
483
+ *
484
+ * const result2 = Convert.toInt(undefined);
485
+ * // Результат: 0
486
+ *
487
+ * const result3 = Convert.toInt('example');
488
+ * // Результат: 0
489
+ * ```
490
+ *
491
+ * 5. Преобразование строки с основанием системы счисления:
492
+ *
493
+ * ```js
494
+ * const result1 = Convert.toInt('10', 2);
495
+ * // Результат: 2
496
+ *
497
+ * const result2 = Convert.toInt('A', 16);
498
+ * // Результат: 10
499
+ *
500
+ * const result3 = Convert.toInt('7', 8);
501
+ * // Результат: 7
502
+ * ```
503
+ *
504
+ * @param {any} value Переменная, значение которой необходимо привести к целому числу.
505
+ * @param {number} [base=10] Основание системы счисления для преобразования строки в число.
506
+ * @returns {number} Возвращает приведенное к целому числу значение переменной `value`.
507
+ */
508
+ static toInt(value, base = 10) {
509
+ return to_int(value, base);
510
+ }
511
+
512
+ /**
513
+ * Приводит значение переменной к целому числу.
514
+ *
515
+ * ### Описание
516
+ *
517
+ * Метод `Convert.toInteger` используется для преобразования различных типов данных в целое число. Если значение не является числом или строкой, метод возвращает `1` для истинных значений и `0` для ложных значений.
518
+ *
519
+ * ### Параметры
520
+ *
521
+ * - `value` (any)
522
+ * Переменная, значение которой необходимо привести к целому числу.
523
+ *
524
+ * - `base` (number)
525
+ * Основание системы счисления для преобразования строки в число. По умолчанию `10`.
526
+ *
527
+ * ### Возвращаемое значение
528
+ *
529
+ * Возвращает целое число, соответствующее переданному значению.
530
+ *
531
+ * ### Примеры использования
532
+ *
533
+ * 1. Преобразование строки в целое число:
534
+ *
535
+ * ```js
536
+ * const result = Convert.toInteger('123');
537
+ * // Результат: 123
538
+ * ```
539
+ *
540
+ * 2. Преобразование числа с плавающей точкой в целое число:
541
+ *
542
+ * ```js
543
+ * const result = Convert.toInteger(123.45);
544
+ * // Результат: 123
545
+ * ```
546
+ *
547
+ * 3. Преобразование булевых значений:
548
+ *
549
+ * ```js
550
+ * const result1 = Convert.toInteger(true);
551
+ * // Результат: 1
552
+ *
553
+ * const result2 = Convert.toInteger(false);
554
+ * // Результат: 0
555
+ * ```
556
+ *
557
+ * 4. Преобразование других значений:
558
+ *
559
+ * ```js
560
+ * const result1 = Convert.toInteger(null);
561
+ * // Результат: 0
562
+ *
563
+ * const result2 = Convert.toInteger(undefined);
564
+ * // Результат: 0
565
+ *
566
+ * const result3 = Convert.toInteger('example');
567
+ * // Результат: 0
568
+ * ```
569
+ *
570
+ * 5. Преобразование строки с основанием системы счисления:
571
+ *
572
+ * ```js
573
+ * const result1 = Convert.toInteger('10', 2);
574
+ * // Результат: 2
575
+ *
576
+ * const result2 = Convert.toInteger('A', 16);
577
+ * // Результат: 10
578
+ *
579
+ * const result3 = Convert.toInteger('7', 8);
580
+ * // Результат: 7
581
+ * ```
582
+ *
583
+ * @param {any} value Переменная, значение которой необходимо привести к целому числу.
584
+ * @param {number} [base=10] Основание системы счисления для преобразования строки в число.
585
+ * @returns {number} Возвращает приведенное к целому числу значение переменной `value`.
586
+ */
587
+ static toInteger(value, base = 10) {
588
+ return to_int(value, base);
589
+ }
590
+
591
+ /**
592
+ * Преобразует значение в список.
593
+ *
594
+ * ### Параметры
595
+ *
596
+ * - `value` (any)
597
+ * Значение, которое необходимо преобразовать.
598
+ *
599
+ * ### Описание
600
+ *
601
+ * Метод `Convert.toList` преобразует переданное значение в список.
602
+ *
603
+ * Она выполняет следующие проверки:
604
+ *
605
+ * 1. **Null и Undefined**: Возвращает пустой массив для значений `null` и `undefined`.
606
+ * 2. **Array**: Возвращает исходный массив, если он передан.
607
+ * 3. **Object**: Возвращает массив значений объекта, если передан ассоциативный массив.
608
+ * 4. **Примитивы и другие типы**: Возвращает массив, содержащий переданное значение.
609
+ *
610
+ * ### Возвращаемое значение
611
+ *
612
+ * Возвращает массив, представляющий список значений.
613
+ *
614
+ * ### Примеры использования
615
+ *
616
+ * ```js
617
+ * Convert.toList(null); // []
618
+ * Convert.toList(undefined); // []
619
+ * Convert.toList([1, 2, 3]); // [1, 2, 3]
620
+ * Convert.toList({ key: 'value' }); // ['value']
621
+ * Convert.toList('example'); // ['example']
622
+ * Convert.toList(123); // [123]
623
+ * ```
624
+ *
625
+ * @param {any} value Значение, которое необходимо преобразовать.
626
+ * @returns {Array} Возвращает массив, представляющий список значений.
627
+ */
628
+ static toList(value) {
629
+ return to_list(value);
630
+ }
631
+
632
+ /**
633
+ * Приводит значение переменной к объекту.
634
+ *
635
+ * ### Описание
636
+ *
637
+ * Метод `Convert.toObject` используется для преобразования различных типов данных в объект. Если значение уже является объектом, оно возвращается без изменений. Если значение является классом, возвращается новый экземпляр этого класса. Если значение является массивом, элементы массива копируются в новый объект. Для других значений создается объект с полем `value`, содержащим это значение.
638
+ *
639
+ * ### Параметры
640
+ *
641
+ * - `value` (any)
642
+ * Переменная, значение которой необходимо привести к объекту.
643
+ *
644
+ * ### Возвращаемое значение
645
+ *
646
+ * Возвращает объект, соответствующий переданному значению.
647
+ *
648
+ * ### Примеры использования
649
+ *
650
+ * 1. Преобразование объекта:
651
+ *
652
+ * ```js
653
+ * class MyClass {}
654
+ * const obj = new MyClass();
655
+ * const result = Convert.toObject(obj);
656
+ * // Результат: obj
657
+ * ```
658
+ *
659
+ * 2. Преобразование класса:
660
+ *
661
+ * ```js
662
+ * class MyClass {}
663
+ * const result = Convert.toObject(MyClass);
664
+ * // Результат: экземпляр MyClass
665
+ * ```
666
+ *
667
+ * 3. Преобразование null и undefined:
668
+ *
669
+ * ```js
670
+ * const result1 = Convert.toObject(null);
671
+ * // Результат: экземпляр анонимного класса
672
+ *
673
+ * const result2 = Convert.toObject(undefined);
674
+ * // Результат: экземпляр анонимного класса
675
+ * ```
676
+ *
677
+ * 4. Преобразование массива:
678
+ *
679
+ * ```js
680
+ * const arr = [1, 2, 3];
681
+ * const result = Convert.toObject(arr);
682
+ * // Результат: объект с элементами массива
683
+ * ```
684
+ *
685
+ * 5. Преобразование других значений:
686
+ *
687
+ * ```js
688
+ * const result = Convert.toObject('example');
689
+ * // Результат: объект с полем value, содержащим 'example'
690
+ * ```
691
+ *
692
+ * @param {any} value Переменная, значение которой необходимо привести к объекту.
693
+ * @returns {object} Возвращает приведенное к объекту значение переменной `value`.
694
+ */
695
+ static toObject(value) {
696
+ return to_object(value);
697
+ }
698
+
699
+ /**
700
+ * Приводит значение переменной к строке.
701
+ *
702
+ * ### Описание
703
+ *
704
+ * Метод `Convert.toString` используется для преобразования различных типов данных в строку. Он обрабатывает массивы, объекты, классы, функции, символы и другие типы данных, возвращая их строковое представление.
705
+ *
706
+ * ### Параметры
707
+ *
708
+ * - `value` (any)
709
+ * Переменная, значение которой необходимо привести к строке.
710
+ *
711
+ * ### Возвращаемое значение
712
+ *
713
+ * Возвращает строку, соответствующую переданному значению.
714
+ *
715
+ * ### Примеры использования
716
+ *
717
+ * 1. Преобразование строки:
718
+ *
719
+ * ```js
720
+ * const result = Convert.toString('example');
721
+ * // Результат: 'example'
722
+ * ```
723
+ *
724
+ * 2. Преобразование числа:
725
+ *
726
+ * ```js
727
+ * const result = Convert.toString(123);
728
+ * // Результат: '123'
729
+ * ```
730
+ *
731
+ * 3. Преобразование булевых значений:
732
+ *
733
+ * ```js
734
+ * const result1 = Convert.toString(true);
735
+ * // Результат: 'true'
736
+ *
737
+ * const result2 = Convert.toString(false);
738
+ * // Результат: 'false'
739
+ * ```
740
+ *
741
+ * 4. Преобразование null и undefined:
742
+ *
743
+ * ```js
744
+ * const result1 = Convert.toString(null);
745
+ * // Результат: 'null'
746
+ *
747
+ * const result2 = Convert.toString(undefined);
748
+ * // Результат: 'undefined'
749
+ * ```
750
+ *
751
+ * 5. Преобразование массива:
752
+ *
753
+ * ```js
754
+ * const arr = [1, 2, 3];
755
+ * const result = Convert.toString(arr);
756
+ * // Результат: '[\n 1,\n 2,\n 3,\n]'
757
+ * ```
758
+ *
759
+ * 6. Преобразование объекта:
760
+ *
761
+ * ```js
762
+ * const obj = { key: 'value' };
763
+ * const result = Convert.toString(obj);
764
+ * // Результат: '{\n key: 'value',\n}'
765
+ * ```
766
+ *
767
+ * 7. Преобразование функции:
768
+ *
769
+ * ```js
770
+ * const func = function() {};
771
+ * const result = Convert.toString(func);
772
+ * // Результат: 'function func() {}'
773
+ * ```
774
+ *
775
+ * 8. Преобразование символа:
776
+ *
777
+ * ```js
778
+ * const symbol = Symbol('example');
779
+ * const result = Convert.toString(symbol);
780
+ * // Результат: 'Symbol(example)'
781
+ * ```
782
+ *
783
+ * 9. Преобразование BigInt:
784
+ *
785
+ * ```js
786
+ * const bigInt = BigInt(123);
787
+ * const result = Convert.toString(bigInt);
788
+ * // Результат: '123'
789
+ * ```
790
+ *
791
+ * 10. Преобразование класса:
792
+ *
793
+ * ```js
794
+ * class MyClass {
795
+ * static test = 'test';
796
+ * }
797
+ * const result = Convert.toString(MyClass);
798
+ * // Результат: 'class MyClass {}'
799
+ * ```
800
+ *
801
+ * 11. Преобразование экземпляра класса:
802
+ *
803
+ * ```js
804
+ * class MyClass {}
805
+ * const instance = new MyClass();
806
+ * const result = Convert.toString(instance);
807
+ * // Результат: 'object MyClass'
808
+ * ```
809
+ *
810
+ * @param {any} value Переменная, значение которой необходимо привести к строке.
811
+ * @returns {string} Возвращает приведенное к строке значение переменной `value`.
812
+ */
813
+ static toString(value) {
814
+ return to_string(value);
815
+ }
816
+ }
817
+
818
+ export default Convert;