rpa_excel_read

读取单元格数据

1. 函数

rpa_excel_read(excelId, row, column, sheet=0)

• excelId：Excel标识符，通过rpa_excel_open接口返回；
• row：整数类型，单元格的行索引；
• column：整数类型，单元格的列索引；
• sheet：整数或字符串类型，数据所在sheet,可传入sheet的索引或sheet的名称；

2. 返回值

字符串类型，若返回空字符串表示可能发生错误，可通过rpa_getLastErrorCode()获取错误码，rpa_getLastErrorMsg()获取错误信息。

3. 示例

#打开excel文件
excelTest = rpa_excel_open("d:/test.xlsx")

#打开失败结束流程
if not excelTest:
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())
    rpa_exit()

#新建一个sheet  若失败打印错误信息
if False == rpa_excel_addSheet(excelTest, "SheetTest"):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#从第一个sheet中读取单元格B2的数据
data = rpa_excel_read(excelTest, 1,1, 0)

#若字符串长度为0，则可能发生了错误，可获取错误码进行校验
if len(data) == 0:
    if  RpaError.code_success != rpa_getLastErrorCode():
        print(rpa_getLastErrorCode())
        print(rpa_getLastErrorMsg())

#向名称为“SheetTest”的sheet中的E3单元格写入数据 若失败打印错误信息
if False == rpa_excel_write(excelTest, data , 2, 4, 'SheetTest'):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#将第一个sheet的名称改为SheetRename  若失败打印错误信息
if False == rpa_excel_renameSheet(excelTest, 0, 'SheetRename'):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#打印第一个sheet中数据区域的行数
print(rpa_excel_rowCount(excelTest, 0))

#打印名称为“SheetTest”的sheet中数据区域的列数
print(rpa_excel_columnCount(excelTest, 'SheetTest'))

#打印sheet的总数
print(rpa_excel_sheetCount(excelTest))

#打印所有sheet名称的列表
print(rpa_excel_sheetNames(excelTest))

#将第一个sheet中A1至E5区域的数据复制到剪贴板中  若失败打印错误信息
if False == rpa_excel_copy(excelTest, 0, 0, 4, 4, 0):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#将剪贴板中数据写入名称为“SheetTest”的sheet中从D4开始的区域  若失败打印错误信息
if False == rpa_excel_paste(excelTest, 3, 3, "SheetTest"):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#保存Excel文件 若失败打印错误信息
if False == rpa_excel_save(excelTest):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#关闭Excel文件  若失败打印错误信息
if False == rpa_excel_close(excelTest):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())