Skip to content
v3.3.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