import { Meta, Source } from '@storybook/addon-docs/blocks'

<Meta title='@dxtmisha/ru/functional-basic/Functions/toNumber - Преобразование значения в число'/>

# `toNumber`

Преобразует строку или число в конечное число с плавающей точкой. Функция разработана для обработки различных стилей форматирования, включая разделители тысяч и различные десятичные маркеры.

**Параметры:**
- `value?: NumberOrString` — Входное значение для преобразования.

**Возвращает:**
`number` — Распарсенное число float или `0`, если преобразование не удалось или значение не является конечным числом.

## Примеры

<Source
  language='typescript'
  code={`
import { toNumber } from '@dxtmisha/functional-basic'

// 1. Обработка различных разделителей
toNumber('1 250,50')       // 1250.5
toNumber('1,000,000.99')   // 1000000.99
toNumber('1.250,50')       // 1250.5

// 2. Очистка от нечисловых символов
toNumber('abc-12.5')       // -12.5
toNumber('$1,234.56')      // 1234.56

// 3. Числа и специальные значения
toNumber(123.45)           // 123.45
toNumber(-0)               // 0 (нормализовано)
toNumber(Infinity)         // 0
toNumber(undefined)        // 0
  `}
/>
