toFloat

将值转换为浮点数，如果转换失败则返回默认值。

基础用法

import { toFloat } from 'radash'

console.log(toFloat('3.14'))        // 3.14
console.log(toFloat('123'))         // 123.0
console.log(toFloat('abc', 0))      // 0
console.log(toFloat(null, 1.5))     // 1.5

语法

function toFloat(
  value: any,
  fallback?: number
): number

参数

• value (any): 要转换的值
• fallback (number, 可选): 转换失败时的默认值，默认为0

返回值

返回转换后的浮点数，如果转换失败则返回fallback值。

示例

转换字符串

import { toFloat } from 'radash'

console.log(toFloat('3.14'))        // 3.14
console.log(toFloat('123'))         // 123.0
console.log(toFloat('0.5'))         // 0.5
console.log(toFloat('-2.5'))        // -2.5
console.log(toFloat('3.14e2'))      // 314.0

转换数字

import { toFloat } from 'radash'

console.log(toFloat(3.14))          // 3.14
console.log(toFloat(123))           // 123.0
console.log(toFloat(0))             // 0.0
console.log(toFloat(-2.5))          // -2.5
console.log(toFloat(Infinity))      // Infinity
console.log(toFloat(-Infinity))     // -Infinity

处理无效值

import { toFloat } from 'radash'

console.log(toFloat('abc'))         // 0 (默认fallback)
console.log(toFloat('abc', 1.5))    // 1.5
console.log(toFloat(null))          // 0
console.log(toFloat(null, 2.5))     // 2.5
console.log(toFloat(undefined))     // 0
console.log(toFloat(undefined, 3.5)) // 3.5
console.log(toFloat(NaN))           // 0
console.log(toFloat(NaN, 4.5))      // 4.5

处理特殊字符串

import { toFloat } from 'radash'

console.log(toFloat(''))            // 0
console.log(toFloat(' ', 1.0))      // 1.0
console.log(toFloat('  3.14  '))    // 3.14 (自动去除空格)
console.log(toFloat('3.14abc'))     // 0 (无法解析)
console.log(toFloat('abc3.14'))     // 0 (无法解析)

处理布尔值

import { toFloat } from 'radash'

console.log(toFloat(true))          // 1.0
console.log(toFloat(false))         // 0.0

处理数组和对象

import { toFloat } from 'radash'

console.log(toFloat([]))            // 0
console.log(toFloat({}))            // 0
console.log(toFloat([1, 2, 3]))    // 0
console.log(toFloat({ key: 'value' })) // 0

处理函数

import { toFloat } from 'radash'

console.log(toFloat(() => {}))      // 0
console.log(toFloat(() => 42))      // 0

在表单处理中使用

import { toFloat } from 'radash'

function processFormData(formData: any) {
  return {
    price: toFloat(formData.price, 0),
    quantity: toFloat(formData.quantity, 1),
    discount: toFloat(formData.discount, 0)
  }
}

const formData = {
  price: '29.99',
  quantity: '3',
  discount: 'invalid'
}

const processed = processFormData(formData)
console.log(processed)
// { price: 29.99, quantity: 3.0, discount: 0 }

在API响应处理中使用

import { toFloat } from 'radash'

function processApiResponse(response: any) {
  return {
    id: response.id,
    score: toFloat(response.score, 0),
    rating: toFloat(response.rating, 5.0),
    price: toFloat(response.price, 0)
  }
}

const apiResponse = {
  id: 1,
  score: '8.5',
  rating: null,
  price: 'invalid'
}

const processed = processApiResponse(apiResponse)
console.log(processed)
// { id: 1, score: 8.5, rating: 5.0, price: 0 }

在计算中使用

import { toFloat } from 'radash'

function calculateTotal(items: any[]) {
  return items.reduce((total, item) => {
    const price = toFloat(item.price, 0)
    const quantity = toFloat(item.quantity, 1)
    return total + (price * quantity)
  }, 0)
}

const items = [
  { price: '10.50', quantity: '2' },
  { price: '5.25', quantity: '3' },
  { price: 'invalid', quantity: '1' }
]

const total = calculateTotal(items)
console.log(total) // 36.75 (10.5*2 + 5.25*3 + 0*1)

处理科学计数法

import { toFloat } from 'radash'

console.log(toFloat('1.23e4'))      // 12300.0
console.log(toFloat('1.23E-2'))     // 0.0123
console.log(toFloat('1e6'))         // 1000000.0
console.log(toFloat('1.5e-3'))      // 0.0015

处理十六进制和八进制

import { toFloat } from 'radash'

console.log(toFloat('0xFF'))        // 0 (无法解析十六进制)
console.log(toFloat('0o77'))        // 0 (无法解析八进制)
console.log(toFloat('0b1010'))      // 0 (无法解析二进制)

注意事项

1. 字符串解析: 只解析标准的十进制数字格式
2. 空格处理: 自动去除字符串前后的空格
3. 无效值: 对于无法解析的值，返回fallback值
4. 布尔值: true转换为1.0，false转换为0.0
5. 特殊值: null、undefined、NaN等返回fallback值

与其他方法的区别

• parseFloat(): 类似功能，但不会处理null/undefined
• Number(): 更严格的转换，NaN会返回NaN
• toFloat(): radash提供的更安全的转换方法
• +value: 快速转换，但不够安全

实际应用场景

1. 表单处理: 安全地转换用户输入的数字
2. API处理: 处理可能包含无效数据的API响应
3. 计算: 在数学计算中安全地转换数值
4. 数据验证: 验证和转换数值类型的数据
5. 配置处理: 处理配置文件中的数值设置