Skip to content

Map Object

Represents an RVL Map object and all its operations. The same operations are used by the RVL runtime implicitly to read the cell value or iterate through the Map.

Actions

DoMoveToRow

DoMoveToRow(/**number*/ rowInd)

Moves to the row with a given index. Zero-based. If map type is Rows then row with index 0 is the row with column names.

  • rowInd: Row index (or name) to set active.

DoSequential

DoSequential()

Advances to the next row in the range. The range is either set by SetRange or it is the default range that includes all rows on the sheet except first row which is considered to contain column names. When the end of the range is reached, DoSequential rewinds back to the first row in the range and returns false.

Returns false if being called when active row is the last row or the spreadsheet is not attached, true - otherwise.

DoMoveToColumn

DoMoveToColumn(/**number|string*/ colInd)

Moves to the column with a given index or name. Index is zero-based. If map type is Columns then column with index 0 is the column with row names.

  • colInd: Column index (or name) to set active.

DoMoveToFirstColumn

DoMoveToFirstColumn()

Moves to a first column with data in the map. If map type is Columns then first column index is 1, if map type is Rows then first column index is 0.

DoMoveToFirstRow

DoMoveToFirstRow()

Moves to a first row with data in the map. If map type is Rows then first row index is 1, if map type is Columns then first row index is 0.

DoMoveToLastColumn

DoMoveToLastColumn()

Moves to a last column in the map.

DoMoveToLastRow

DoMoveToLastRow()

Moves to a last row in the map.

Properties

Cell

GetCell(/**number|string*/ columnId, /**number*/ rowId)

Gets a cell value by its coordinates. It returns the current cell value after DoSequential or DoRandom if the parameters are not set.

  • [columnId]: Column index or name. If not set ActiveColumn is used.
  • [rowId]: Row index. If not set ActiveRow is used.

ColumnCell

GetColumnCell(/**number*/ rowId)

Gets cell value by its coordinates. Returns current cell value after DoSequential. If not set ActiveColumn is used.

  • [rowId]: Row index. If not set ActiveRow is used.

ColumnCount

GetColumnCount()

Returns number of columns in the spreadsheet.

ColumnIndexByName

GetColumnIndexByName(/**string*/ name)

Gets index of a column with the given name.

  • name: Column name.

Returns column index if found, or -1.

ColumnName

GetColumnName(/**number*/ ind)

Gets column name.

  • ind: Column index.

Returns name of column in the spreadsheet.

RowCount

GetRowCount()

Returns number of rows in the spreadsheet.

RowIndexByName

GetRowIndexByName(/**string*/ name)

Gets row name.

  • name: Row name.

Returns row index if found, or -1.

CurrentRowIndex

GetCurrentRowIndex()

Gets zero based current row index.

EOF

GetEOF()

Returns true if current position is beyond the map boundaries range.

RowCell

GetRowCell(/**number|string*/ columnId)

Gets cell value for current row. Returns current cell value after DoSequential. ActiveRow is used.

  • [columnId]: Column index or name. If not set ActiveColumn is used.

RowName

GetRowName(/**number*/ ind)

Gets row name.

  • ind: Row index.

Returns name of row in the map.

Value

GetValue(/**number|string*/ rowOrColumnNameOrId)

Gets cell value by its name or id. Returns current cell value after DoSequential. If it is Rows or Table map then the parameter needs to be a column name or index, and ActiveRow is used. If it is Columns map then the parameter needs to be a row name or index, and ActiveRow is used.

  • [rowOrColumnNameOrId]: Row or Column index or Name.