humanemulator.net — справка. Продукт, демо и покупка — на хуманэмулятор.рф | Демо | Купить | API | Changelog

get_range

get_range($path,$sheet,$range,$timeout=3000); - Получить содержимое заданного диапазона Листа как массив строк

Функция на вход принимает параметры:

  • $path – путь к исходному файлу Excel
  • $sheet – Номер Листа
  • $range – Адрес диапазона. Пример: "E1:E5"
  • $timeout – Таймаут ожидания выполнения операции, сек

    После выполнения функции возвращаемое значение будет равно одному из двух :
  • результат – array|null
  • пусто / null – ошибка

    Пример использования
    <?php

// Scenario: Get cell ranges from Excel file

$xhe_host = getenv("RPABOT_HOST_URL");

// Connect functional objects if not already connected
if (!isset($path)){
    // Path to the init.php file for connecting to the XHE API
    $path = "../../../Templates/init.php";
    // Including init.php grants access to all classes and functionality for working with the XHE API
    require($path);
}

echo "\n<span >excelfile->" . basename(__FILE__) . "</span>\n";

// Initialize Excel and prepare file path
$filePath = "test/test.xlsx";
SYSTEM::$excel->kill();

// Example 1: Get range contents as array '0!A1:C3'
echo("Example 1: Get range contents as array '0!A1:C3' : ");
// Extract method arguments into variables
$sheetIndex = 0;
$range1 = "A1:C3";
var_export(SYSTEM::$excelfile->get_range($filePath, $sheetIndex, $range1));

// Example 2: Get range contents as array '0!A1:A10'
echo("\nExample 2: Get range contents as array '0!A1:A10' : ");
// Extract method arguments into variables
$range2 = "A1:A10";
var_export(SYSTEM::$excelfile->get_range($filePath, $sheetIndex, $range2));

// End of script
echo "\n";

// Quit application
WINDOW::$app->quit();
?>
    # Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')

xhe_host = "127.0.0.1:7010"
from xweb_human_emulator import *

# начало
echo("<hr><font color=blue>excelfile.get_range</font><hr>")

path = "test/test.xlsx"

# 1
echo("1. Получить диапазон листа как массив: ")
echo(excelfile.get_range(path, 0, "A1:D5"))

# конец
echo("<hr><br>")

# Quit
app.quit()
    #region using

using System;
using System.Diagnostics;
using System.Collections.Generic;
using System.Linq;
using System.IO;
using System.Text;
using System.Threading;

using XHE;
using XHE.XHE_DOM;
using XHE.XHE_System;
using XHE.XHE_Window;
using XHE.XHE_Web;

#endregion

 class Program:XHEScript
 {
	  static void Main(string[] args)
	  {
			// init XHE
			server = Environment.GetEnvironmentVariable("RPABOT_HOST_URL");
			InitXHE();

			var path = "test/test.xlsx";
			excel.kill();

			// начало
			echo("<hr><font color=blue>excelfile.get_range</font><hr>");

			// 1
			echo("1. Получить диапазон листа как массив: ");
			echo(excelfile.get_range(path, 0, "A5:B10").Count);

			// конец
			echo("\n\n");

			app.quit();            
	  }
}
    xhe_host="127.0.0.1:7010";
echo=require("../../../Templates JS/init.js");

// начало
echo("<hr><font color=blue>excelfile.get_range</font><hr>");

const path = "test/test.xlsx";

// 1 
echo("\n1. Получим содержимое диапазона листа как массив: ");
console.log(excelfile.get_range(path,0,"B2:D10"));

// конец
echo("\n");

// Quit
app.quit();

    =============================================
    excelfile    Объекты    DOM  System  Vision  Web  Window        
    =============================================
    если что-то непонятно или необходимо узнать или считаете что надо добавить по работе этой функции, пишите в комментарии или на наш форум
    .