Question

Ext.Number

Files
Number.js

一组处理数字的实用静态方法集合。

Defined By

Methods

Ext.Number

constrain( Number number, Number min, Number max ) : Number

检查给定的数值是否在约束的范围内。 If the number is already within the 如果再范围内就返回此数值。否则，如果大于最大值则返回最大值，如果小于最小值则返回最小值。, otherwise the min or max value is returned depending on which side of the range is 注意本方法不改变给定的数值本身。 Note that this method returns the constrained value but does not change the current number.

Parameters

• number : Number

  要检查的数值

• min : Number

  范围的最小值

• max : Number

  范围的最大值

Returns

• Number

  The constrained value if outside the range, otherwise the current value

Ext.Number

from( Object value, Number defaultValue ) : Number

Validate that a value is numeric and convert it to a number if necessary. Returns the specified default value if it is not.

Ext.Number.from('1.23', 1); // returns 1.23
Ext.Number.from('abc', 1); // returns 1

Parameters

• value : Object
• defaultValue : Number

  The value to return if the original value is non-numeric

Returns

• Number

  value, if numeric, defaultValue otherwise

Ext.Number

randomInt( Number from, Number to ) : Number

Returns a random integer between the specified range (inclusive)

Parameters

• from : Number

  Lowest value to return.

• to : Number

  Highst value to return.

Returns

• Number

  A random integer within the specified range.

Ext.Number

snap( Number value, Number increment, Number minValue, Number maxValue ) : Number

Snaps the passed number between stopping points based upon a passed increment value.

The difference between this and snapInRange is that snapInRange uses the minValue when calculating snap points:

r = Ext.Number.snap(56, 2, 55, 65);        // Returns 56 - snap points are zero based

r = Ext.Number.snapInRange(56, 2, 55, 65); // Returns 57 - snap points are based from minValue

Parameters

• value : Number

  The unsnapped value.

• increment : Number

  The increment by which the value must move.

• minValue : Number

  The minimum value to which the returned value must be constrained. Overrides the increment.

• maxValue : Number

  The maximum value to which the returned value must be constrained. Overrides the increment.

Returns

• Number

  The value of the nearest snap target.

Ext.Number

snapInRange( Number value, Number increment, [Number minValue], [Number maxValue] ) : Number

Snaps the passed number between stopping points based upon a passed increment value.

The difference between this and snap is that snap does not use the minValue when calculating snap points:

r = Ext.Number.snap(56, 2, 55, 65);        // Returns 56 - snap points are zero based

r = Ext.Number.snapInRange(56, 2, 55, 65); // Returns 57 - snap points are based from minValue

Parameters

• value : Number

  The unsnapped value.

• increment : Number

  The increment by which the value must move.

• minValue : Number (optional)

  The minimum value to which the returned value must be constrained.

  Defaults to: 0

• maxValue : Number (optional)

  The maximum value to which the returned value must be constrained.

  Defaults to: Infinity

Returns

• Number

  The value of the nearest snap target.

Ext.Number

toFixed( Number value, Number precision )

Formats a number using fixed-point notation

Parameters

• value : Number

  The number to format

• precision : Number

  The number of digits to show after the decimal point