Skip to content
v3.4.0

SimpleRangeValue

A class that represents a range of data.

+ new SimpleRangeValue(_data?: InternalScalarValue[][], range?: AbsoluteCellRange, dependencyGraph?: DependencyGraph, _hasOnlyNumbers?: undefined | false | true): SimpleRangeValue

Defined in src/SimpleRangeValue.ts:21

In most cases, it’s more convenient to create a SimpleRangeValue object by calling one of the static factory methods.

Parameters:

NameType
_data?InternalScalarValue[][]
range?AbsoluteCellRange
dependencyGraph?DependencyGraph
_hasOnlyNumbers?undefined | false | true

Returns: SimpleRangeValue

• range? : AbsoluteCellRange

Defined in src/SimpleRangeValue.ts:33

A property that represents the address of the range.


• size: ArraySize

Defined in src/SimpleRangeValue.ts:21

A property that represents the size of the range.

• get data(): InternalScalarValue[][]

Defined in src/SimpleRangeValue.ts:45

Returns the range data as a 2D array.

Returns: InternalScalarValue[][]

▸ effectiveAddressesFromData(leftCorner: SimpleCellAddress): IterableIterator‹SimpleCellAddress›

Defined in src/SimpleRangeValue.ts:125

Generates the addresses of the cells contained in the range assuming the provided address is the left corner of the range.

Parameters:

NameType
leftCornerSimpleCellAddress

Returns: IterableIterator‹SimpleCellAddress›


▸ entriesFromTopLeftCorner(leftCorner: SimpleCellAddress): IterableIterator‹[InternalScalarValue, SimpleCellAddress]›

Defined in src/SimpleRangeValue.ts:139

Generates values and addresses of the cells contained in the range assuming the provided address is the left corner of the range.

This method combines the functionalities of iterateValuesFromTopLeftCorner() and effectiveAddressesFromData().

Parameters:

NameType
leftCornerSimpleCellAddress

Returns: IterableIterator‹[InternalScalarValue, SimpleCellAddress]›


▸ hasOnlyNumbers(): boolean

Defined in src/SimpleRangeValue.ts:165

Returns true if and only if the range contains only numeric values.

Returns: boolean


▸ height(): number

Defined in src/SimpleRangeValue.ts:102

Returns the number of rows contained in the range.

Returns: number


▸ isAdHoc(): boolean

Defined in src/SimpleRangeValue.ts:88

Returns true if and only if the SimpleRangeValue has no address set.

Returns: boolean


▸ iterateValuesFromTopLeftCorner(): IterableIterator‹InternalScalarValue›

Defined in src/SimpleRangeValue.ts:151

Generates the values of the cells contained in the range assuming the provided address is the left corner of the range.

Returns: IterableIterator‹InternalScalarValue›


▸ numberOfElements(): number

Defined in src/SimpleRangeValue.ts:158

Returns the number of cells contained in the range.

Returns: number


▸ rawData(): InternalScalarValue[][]

Defined in src/SimpleRangeValue.ts:196

Returns the range data as a 2D array.

Internal use only.

Returns: InternalScalarValue[][]


▸ rawNumbers(): number[][]

Defined in src/SimpleRangeValue.ts:186

Returns the range data as a 2D array of numbers.

Internal use only.

Returns: number[][]


▸ sameDimensionsAs(other: SimpleRangeValue): boolean

Defined in src/SimpleRangeValue.ts:204

Returns true if and only if the range has the same width and height as the other range object.

Parameters:

NameType
otherSimpleRangeValue

Returns: boolean


▸ valuesFromTopLeftCorner(): InternalScalarValue[]

Defined in src/SimpleRangeValue.ts:109

Returns the range data as a 1D array.

Returns: InternalScalarValue[]


▸ width(): number

Defined in src/SimpleRangeValue.ts:95

Returns the number of columns contained in the range.

Returns: number


▸ fromRange(data: InternalScalarValue[][], range: AbsoluteCellRange, dependencyGraph: DependencyGraph): SimpleRangeValue

Defined in src/SimpleRangeValue.ts:53

A factory method. Returns a SimpleRangeValue object with the provided range address and the provided data.

Parameters:

NameType
dataInternalScalarValue[][]
rangeAbsoluteCellRange
dependencyGraphDependencyGraph

Returns: SimpleRangeValue


▸ fromScalar(scalar: InternalScalarValue): SimpleRangeValue

Defined in src/SimpleRangeValue.ts:81

A factory method. Returns a SimpleRangeValue object that contains a single value.

Parameters:

NameType
scalarInternalScalarValue

Returns: SimpleRangeValue


▸ onlyNumbers(data: number[][]): SimpleRangeValue

Defined in src/SimpleRangeValue.ts:60

A factory method. Returns a SimpleRangeValue object with the provided numeric data.

Parameters:

NameType
datanumber[][]

Returns: SimpleRangeValue


▸ onlyRange(range: AbsoluteCellRange, dependencyGraph: DependencyGraph): SimpleRangeValue

Defined in src/SimpleRangeValue.ts:74

A factory method. Returns a SimpleRangeValue object with the provided range address.

Parameters:

NameType
rangeAbsoluteCellRange
dependencyGraphDependencyGraph

Returns: SimpleRangeValue


▸ onlyValues(data: InternalScalarValue[][]): SimpleRangeValue

Defined in src/SimpleRangeValue.ts:67

A factory method. Returns a SimpleRangeValue object with the provided data.

Parameters:

NameType
dataInternalScalarValue[][]

Returns: SimpleRangeValue