XL.Sheet.CellReadNumber
-----------------------

Reads a number value from a cell.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [XL](component_XL.md) | [3.5](newinversion35.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "XL.Sheet.CellReadNumber"; BookRef; SheetIndex; Row; Column ) 

**MBS**( **"XL.Sheet.CellReadNumber";** /\* Reads a number value from a cell. \*/  
**$BookRef**; /\* The reference number for the workbook.e.g. $ref \*/   
**$SheetIndex**; /\* The index of the sheet. This number ranges from 0 to [XL.Book.SheetCount](XLBookSheetCount.md)-1.e.g. 0 \*/   
**$Row**; /\* The row for the cell. First row has index 0. \*/   
**$Column**) /\* The column for the cell. First column has index 0. \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| BookRef | The reference number for the workbook. | $ref |
| SheetIndex | The index of the sheet. This number ranges from 0 to [XL.Book.SheetCount](XLBookSheetCount.md)-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](XLSheetRowColToAddr.md)"; $book ; $sheet ; $row ; 1; 0; 0)\]  
Set Variable \[$a2 ; Value: MBS ( "[XL.Sheet.RowColToAddr](XLSheetRowColToAddr.md)"; $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](XLSheetCellWriteFormulaBoolean.md)"; $book ; $sheet ; $Row ; $Column ; $formula ; $result ; $format \]  
### See also

- [XL.Sheet.CellReadDate](XLSheetCellReadDate.md)
- [XL.Sheet.CellReadDates](XLSheetCellReadDates.md)
- [XL.Sheet.CellReadFormula](XLSheetCellReadFormula.md)
- [XL.Sheet.CellReadNumbers](XLSheetCellReadNumbers.md)
- [XL.Sheet.CellReadText](XLSheetCellReadText.md)
- [XL.Sheet.CellReadValue](XLSheetCellReadValue.md)
- [XL.Sheet.CellReadValues](XLSheetCellReadValues.md)
- [XL.Sheet.CellWriteFormula](XLSheetCellWriteFormula.md)
- [XL.Sheet.CellWriteNumber](XLSheetCellWriteNumber.md)
- [XL.Sheet.CellWriteNumbers](XLSheetCellWriteNumbers.md)

### Release notes

- **Version 8.0**
    - Added [XL.Sheet.CellReadBooleans](http://www.mbsplugins.eu/XLSheetCellReadBooleans.shtml), [XL.Sheet.CellReadComments](http://www.mbsplugins.eu/XLSheetCellReadComments.shtml), [XL.Sheet.CellReadDates](http://www.mbsplugins.eu/XLSheetCellReadDates.shtml), [XL.Sheet.CellReadFormulas](http://www.mbsplugins.eu/XLSheetCellReadFormulas.shtml), [XL.Sheet.CellReadNumbers](http://www.mbsplugins.eu/XLSheetCellReadNumbers.shtml), [XL.Sheet.CellReadTexts](http://www.mbsplugins.eu/XLSheetCellReadTexts.shtml), [XL.Sheet.CellWriteBlanks](http://www.mbsplugins.eu/XLSheetCellWriteBlanks.shtml), [XL.Sheet.CellWriteBooleans](http://www.mbsplugins.eu/XLSheetCellWriteBooleans.shtml), [XL.Sheet.CellWriteComments](http://www.mbsplugins.eu/XLSheetCellWriteComments.shtml), [XL.Sheet.CellWriteDates](http://www.mbsplugins.eu/XLSheetCellWriteDates.shtml), [XL.Sheet.CellWriteFormulas](http://www.mbsplugins.eu/XLSheetCellWriteFormulas.shtml), [XL.Sheet.CellWriteNumbers](http://www.mbsplugins.eu/XLSheetCellWriteNumbers.shtml), [XL.Sheet.CellWriteTexts](http://www.mbsplugins.eu/XLSheetCellWriteTexts.shtml), [XL.Sheet.GetCellErrors](http://www.mbsplugins.eu/XLSheetGetCellErrors.shtml), [XL.Sheet.GetCellFormats](http://www.mbsplugins.eu/XLSheetGetCellFormats.shtml), [XL.Sheet.RemoveComments](http://www.mbsplugins.eu/XLSheetRemoveComments.shtml) and [XL.Sheet.SetCellFormats](http://www.mbsplugins.eu/XLSheetSetCellFormats.shtml).

### Example Databases

- [XL/XL Import and Export](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/XL/XL%20Import%20and%20Export.shtml#7ScriptAnchor_)

### Blog Entries

- [MBS Plugin Advent calendar: 13 - XL](https://www.mbsplugins.de/archive/2023-12-13/MBS_Plugin_Advent_calendar_13_/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 17th February 2023

  
[XL.Sheet.CellReadFormulas](XLSheetCellReadFormulas.md) - [XL.Sheet.CellReadNumbers](XLSheetCellReadNumbers.md)

[HTML Version](XLSheetCellReadNumber.shtml)