OpenXLSX库中检测Excel单元格是否为空的正确方法-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_07511/article/details/148624788

OpenXLSX库中检测Excel单元格是否为空的正确方法

OpenXLSX A C++ library for reading, writing, creating and modifying Microsoft Excel® (.xlsx) files. 项目地址: https://gitcode.com/gh_mirrors/op/OpenXLSX

背景介绍

在使用OpenXLSX这个C++ Excel操作库时，开发者经常需要判断一个单元格是否为空。库中提供了XLCell类的empty()方法，但这个方法的行为可能与开发者的预期有所不同。本文将深入探讨OpenXLSX中检测单元格空值的正确方法。

empty()方法的误解

许多开发者会自然地认为XLCell::empty()方法就是用来检测单元格内容是否为空的。根据头文件中的注释，这个方法被描述为"测试单元格对象是否没有(有效)内容"。然而在实际使用中，这个方法的行为与预期不符。

问题重现

通过以下代码可以重现这个问题：

XLDocument doc;
doc.create("./Demo01.xlsx", XLForceOverwrite);
auto wks = doc.workbook().worksheet("Sheet1");

wks.cell(1,1).value() = "Hello";
wks.cell(1,2).value() = "World";
wks.cell(2,2).value() = "Cruel World";

doc.save();
doc.close();

doc.open("./Demo01.xlsx");
wks = doc.workbook().worksheet("Sheet1");

if (wks.cell(2,1).empty())
    printf("Cell 2,1是空的\n");
else
    printf("Cell 2,1不是空的\n");

尽管单元格(2,1)确实没有被赋值，但empty()方法却返回false，表示它不是空的。

empty()方法的真实用途

实际上，XLCell::empty()方法的设计初衷并不是用来检测单元格内容是否为空的。它的主要作用是：

测试类实例是否链接到有效的底层XML文档
防止在调用需要有效链接的成员函数时触发异常

也就是说，这个方法检查的是单元格对象本身的有效性，而不是单元格内容的空值状态。

检测单元格空值的正确方法

OpenXLSX提供了两种正确检测单元格是否为空的方法：

方法一：检查值类型

if (wks.cell(2,1).value().type() == OpenXLSX::XLValueType::Empty)
    printf("单元格是空的\n");

这种方法直接检查单元格值的类型是否为Empty，是最直接的检测方式。

方法二：使用XLCellIterator

XLWorksheet wks = doc.workbook().worksheet(1);
XLCellRange testRange = wks.range("A1:F100");

for(XLCellIterator it = testRange.begin(); it != testRange.end(); ++it) {
    if(it.cellExists() && it->getString() != "")
        printf("单元格%s不是空的\n", it.address());
    else
        printf("单元格%s是空的\n", it.address());
}

这种方法特别适合批量检测多个单元格，它不会在检测过程中自动创建不存在的单元格。