XL.Sheet.CellReadNumbers
------------------------

Reads all the numbers from cells in an area.

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

MBS( "XL.Sheet.CellReadNumbers"; BookRef; SheetIndex; First row; Last row; First column; Last column { ; Row Delimiter; Column Delimiter } ) 

**MBS**( **"XL.Sheet.CellReadNumbers";** /\* Reads all the numbers from cells in an area. \*/  
**$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 \*/   
**$First row**; /\* The first row to process. First row has index 0.e.g. 3 \*/   
**$Last row**; /\* The last row to process. First row has index 0.e.g. 6 \*/   
**$First column**; /\* The first column to process. First column has index 0.e.g. 2 \*/   
**$Last column**; /\* The last column to process. First column has index 0.e.g. 4 \*/   
**$Row Delimiter**; /\* Optional; The row delimiter for the result.  
Default is new line character.e.g. "¶" \*/   
**$Column Delimiter**) /\* Optional; The column delimiter for the result.  
Default is tab character.e.g. char(9) \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| 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 |  |
| First row | The first row to process. First row has index 0. | 3 |  |
| Last row | The last row to process. First row has index 0. | 6 |  |
| First column | The first column to process. First column has index 0. | 2 |  |
| Last column | The last column to process. First column has index 0. | 4 |  |
| Row Delimiter | The row delimiter for the result.   Default is new line character. | "¶" | Optional |
| Column Delimiter | The column delimiter for the result.   Default is tab character. | char(9) | Optional |

### Result

Returns list of values or error.

### Description

Reads all the numbers from cells in an area.  
If one cell can’t be read as number, the value in the result will be empty.  
### See also

- [XL.Book.SheetCount](XLBookSheetCount.md)
- [XL.Sheet.CellReadDates](XLSheetCellReadDates.md)
- [XL.Sheet.CellReadFormula](XLSheetCellReadFormula.md)
- [XL.Sheet.CellReadFormulas](XLSheetCellReadFormulas.md)
- [XL.Sheet.CellReadNumber](XLSheetCellReadNumber.md)
- [XL.Sheet.CellReadTexts](XLSheetCellReadTexts.md)
- [XL.Sheet.CellReadValue](XLSheetCellReadValue.md)
- [XL.Sheet.CellReadValues](XLSheetCellReadValues.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).

### Blog Entries

- [LibXL for FileMaker with extras](https://www.mbsplugins.de/archive/2021-03-02/LibXL_for_FileMaker_with_extra/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 8.0pr8](https://www.mbsplugins.de/archive/2018-01-15/MBS_FileMaker_Plugin_version_8/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 15th January 2018 , last changed 29th January 2023

  
[XL.Sheet.CellReadNumber](XLSheetCellReadNumber.md) - [XL.Sheet.CellReadStyledText](XLSheetCellReadStyledText.md)

[HTML Version](XLSheetCellReadNumbers.shtml)