Components | All | New | MacOS | Windows | Linux | iOS | ||||
Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old |
XL.Sheet.CellReadNumber
Reads a number value from a cell.
Component | Version | macOS | Windows | Linux | Server | iOS SDK |
XL | 3.5 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
Parameters
Parameter | Description | Example |
---|---|---|
bookRef | The reference to the workbook. Please use XL.LoadBook to load a file. | $ref |
sheetIndex | The index of the sheet. This number ranges from 0 to XL.Book.SheetCount-1. | 0 |
Row | The row for the cell. First row has index 0. | $row |
Column | The column for the cell. First column has index 0. | $column |
Result
Returns number or error message.
Description
Reads a number value from a cell.Examples
Write a formula with result:
# calculate the address like A1 and B1
Set Variable [$a1; Value: MBS( "XL.Sheet.RowColToAddr"; $book; $sheet; $row; 1; 0; 0)]
Set Variable [$a2; Value: MBS( "XL.Sheet.RowColToAddr"; $book; $sheet; $row; 2; 0; 0)]
# build the formula
Set Variable [$formula; Value: "=" & $a1 & "+" & $a2 ]
# and we calculate in result based on our data
Set Variable [$result; Value: MBS( "XL.Sheet.CellReadNumber"; $book; $sheet; $row; 1 ) + MBS( "XL.Sheet.CellReadNumber"; $book; $sheet; $row; 2 ) ]
# write it to the new cell
Set Variable [$r; Value: MBS( "XL.Sheet.CellWriteFormulaBoolean"; $book; $sheet; $Row; $Column; $formula; $result; $format ]
See also
- XL.Book.SheetCount
- XL.Sheet.CellReadDate
- XL.Sheet.CellReadDates
- XL.Sheet.CellReadFormula
- XL.Sheet.CellReadText
- XL.Sheet.CellReadValue
- XL.Sheet.CellWriteFormulaBoolean
- XL.Sheet.CellWriteNumber
- XL.Sheet.CellWriteNumbers
- XL.Sheet.RowColToAddr
Release notes
- Version 8.0
- Added XL.Sheet.CellReadBooleans, XL.Sheet.CellReadComments, XL.Sheet.CellReadDates, XL.Sheet.CellReadFormulas, XL.Sheet.CellReadNumbers, XL.Sheet.CellReadTexts, XL.Sheet.CellWriteBlanks, XL.Sheet.CellWriteBooleans, XL.Sheet.CellWriteComments, XL.Sheet.CellWriteDates, XL.Sheet.CellWriteFormulas, XL.Sheet.CellWriteNumbers, XL.Sheet.CellWriteTexts, XL.Sheet.GetCellErrors, XL.Sheet.GetCellFormats, XL.Sheet.RemoveComments and XL.Sheet.SetCellFormats.
Blog Entries
This function checks for a license.
Created 18th August 2014, last changed 17th February 2023