Read data from Excel in AutoIt

I am not much good with Excel, but I encounter it a lot as data source. AutoIt is not too shabby for fast for-the-task programs that handle arrays.

So I had looked into automated way to read data from Excel sheet into AutoIt array.

Native way

AutoIt has bundled UDF for work with Excel. It is very easy to use and gets work done in just a few lines of code. Reading sheet of data into array would be like:

#include <Excel.au3>
$oExcel = _ExcelBookOpen("fileName.xls")

Open book, open sheet, get data. Straightforward but in reality it can be very slow. For sheets with tens of thousands rows it can take well over minute (or few).


I had tried to work around it and turns out simply copying sheet into clipboard and processing from there into array takes much less time (at the price of writing some code).

It is broken into several functions.

Func _StringCount($string, $substring)
Local $i, $count = 0
For $i = 1 To StringLen($string)
If StringMid($string, $i, StringLen($substring)) = $substring Then
	$count = $count + 1
Return $count

This one I had simply looked up on AutoIt forums. It counts number of string occurrences in another string. Used later to determine number columns by counting delimiter (TAB) that Excel inserts into table when it is copied to clipboard.

Func ExcelSheetToClip($excel, $sheet)
_ExcelSheetActivate($excel, $sheet)
Until ClipGet()
Return ClipGet()

Function automates getting sheet into clipboard. Takes Excel object and sheet name for parameters and then:

  • switches to sheet;
  • clears clipboard (I had Excel throwing up occasional error otherwise);
  • sends series of hotkeys:
    • Ctrl+Home to go on first cell and clear selection;
    • Ctrl+A to select all, Excel will ignore whitespace;
    • Ctrl+C to copy it;
  • waits for data to properly get in clipboard;
  • returns that data.
Func String2DSplit($string,$rowDelimiter=@CRLF,$columnDelimiter="	")
$lines = StringSplit(StringStripWS($string, 3), $rowDelimiter, 1)
$columnsNum = _StringCount($lines[1], $columnDelimiter) + 1
Dim $result[$lines[0]][$columnsNum] = [[0]]
For $i = 1 To $lines[0]
	$columns = StringSplit($lines[$i], $columnDelimiter)
	For $j = 1 To $columns[0]
		$result[$i - 1][$j - 1] = $columns[$j]
Return $result

This one I had also picked up from forums, but reworked. It turns giant string into actual two-dimensional array:

  • splits string into array of lines;
  • counts number of delimiter occurrence in first line to determine number of columns;
  • defines empty array with dimension equal to amount of lines and columns;
  • loops through each line, splits it into values and fills large array;
  • returns array when done.

And just a simple wrapper function to bring two main pieces together:

Func ReadSheet($excel, $sheet)
	Return String2DSplit(ExcelSheetToClip($excel, $sheet))

Required some additional code and plenty of polish, but resulting usage is hardly complicated:

#include <Excel.au3>
$oExcel = _ExcelBookOpen("fileName.xls")
$result = ReadSheet($oExcel, "sheetName")

And about 50-60 times faster for sheets I tried it on.


Using native Windows paths is often more convenient and bulletproof. But for specific cases bit of specialized code can give program excellent speed boost.

Script https://www.rarst.net/script/excelclip.au3

PS method also turned out useful to get data out of spoiled file Excel file (overflowing with weird embedded objects for some reason).

Related Posts


  • Rodney #

    Great post. Your AutoIt forum searching ability is inspirational because you found some great code fragments. Thank you for putting the time and effort into making this post. It has helped me a lot in working with AutoIt strings... and Excel :-)
  • Rarst #

    @Rodney You are welcome. :) I am not using AutoIt much lately, but documentation and forums has always been very helpful.
  • mobin #

    hi, very nice function. saved me 5mins a day :) big thanks
  • AJ #

    Thank you, it helped me do a summary report from Excel. I used your sample code in the link. It was a learning experience to realise that the Excel file has to be opened and closed. I didn't need the Excel file elsewhere so I modified the ExcelSheetToClip function: Func ExcelSheetToClip($excel, $sheet) ; following statement added to open Excel $oExcel = _ExcelBookOpen($excel, 1) _ExcelSheetActivate($excel, $sheet) ClipPut("") Send("^{HOME}^a^c") Do Sleep(100) Until ClipGet() ; following statement added to close Excel _ExcelBookClose($oExcel, 0) Return ClipGet() EndFunc ;==>ExcelSheetToClip