Skip to content

useToNumber

Category
Export Size
213 B
Last Changed
2 weeks ago

Reactively convert a string ref to number.

Usage

ts
import { 
useToNumber
} from '@vueuse/core'
import {
shallowRef
} from 'vue'
const
str
=
shallowRef
('123')
const
number
=
useToNumber
(
str
)
number
.
value
// 123

Type Declarations

ts
export interface UseToNumberOptions {
  /**
   * Method to use to convert the value to a number.
   *
   * Or a custom function for the conversion.
   *
   * @default 'parseFloat'
   */
  
method
?: "parseFloat" | "parseInt" | ((
value
: string | number) => number)
/** * The base in mathematical numeral systems passed to `parseInt`. * Only works with `method: 'parseInt'` */
radix
?: number
/** * Replace NaN with zero * * @default false */
nanToZero
?: boolean
} /** * Reactively convert a string ref to number. * * @__NO_SIDE_EFFECTS__ */ export declare function
useToNumber
(
value
:
MaybeRefOrGetter
<number | string>,
options
?: UseToNumberOptions,
):
ComputedRef
<number>

Source

SourceDocs

Contributors

Anthony Fu
Anthony Fu
IlyaL
SerKo
btea
_Ghosteye

Changelog

v13.6.0 on
d32f8 - refactor: add @__NO_SIDE_EFFECTS__ annotations to all pure functions (#4907)
v12.8.0 on
7432f - feat(types): deprecate MaybeRef and MaybeRefOrGetter in favor of Vue's native (#4636)
v12.3.0 on
635bb - feat: method support custom function (#4441)
59f75 - feat(toValue): deprecate toValue from @vueuse/shared in favor of Vue's native
v12.0.0-beta.1 on
0a9ed - feat!: drop Vue 2 support, optimize bundles and clean up (#4349)
v10.0.0-beta.4 on
4d757 - feat(types)!: rename MaybeComputedRef to MaybeRefOrGetter
0a72b - feat(toValue): rename resolveUnref to toValue

Released under the MIT License.

FREE WEEKEND
48 Hours of Unlimited Official Vue.js Certification Training
Reserve Your Spot
23-24 August