fsys.openXml.xlsx 库模块帮助文档

fsys.openXml.xlsx 成员列表 #

SpreadsheetML 保存值、结构、日期解释与有界查询；无 Office/WPS/.NET 依赖。
支持 XLSX/XLSM/XLTX/XLTM/XLAM 的 XML 工作表，不解析 XLS/XLSB。
不重算公式、不模拟 Excel 显示/布局引擎、不执行宏/外链、不修改源包。

fsys.openXml.xlsx.extractMedia(path,outputDir,options) #

媒体平铺导出，默认不覆盖；可选 overwrite,maxMedia 及包限额。
返回 outputDir,files,skipped；失败 null,err,partial。
同名预检，校验 CRC 后逐文件提交，不是整批事务。

fsys.openXml.xlsx.extractText(path,options) #

在 readWorkbook 结果及各成功页增加 text；TAB 分列、CRLF 分行，保留稀疏空格位。
强制 includeRows=true，不重算公式或应用显示格式。
maxTextBytes 默认16777216、最高134217728，按展开后的 UTF-8 文本含分隔符计数，超限返回错误。

fsys.openXml.xlsx.findCells(path,sheet,options) #

target=value/formula，op=eq/ne/gt/ge/lt/le/contains/in/isNull/isEmpty，value为标量或in数组。
range限定选区，maxScanCells=1000000/offset=0/limit=100；返回cells及扫描/匹配/截取信息。
只查已存储c节点；公式正文不展开共享公式，无缓存也能查公式。

fsys.openXml.xlsx.inspectWorkbook(path,options) #

有界预览与结构摘要，默认 maxSheets=20,maxRows=20,maxColumns=20。
附加 summary（整页已存储c节点的公式/错误等计数）及 headerCandidates（预览中候选，不自动认定标题）。
自动启用结构、样式、日期解释；结构元信息仍为全页，不受预览行列限额限制。

fsys.openXml.xlsx.listEntries(path,pattern,options) #

识别工作簿后列真实 ZIP 条目；pattern 为可选 aardio 模式。
只返回清单，不校验所有内容的 CRC。

fsys.openXml.xlsx.listMedia(path,options) #

列出 xl/media/ 与主部件同级 media/ 中的文件，包含子目录和未引用项。
返回 partName,name,ext,size,compressedSize,contentType；不追踪所有资源关系。

fsys.openXml.xlsx.listSheets(path,options) #

按工作簿关系顺序返回 index,name,sheetId,rid,state,path,partName,kind 等。
图表/其他非 worksheet 页也列出，但不读取其单元格。

fsys.openXml.xlsx.parseRange(ref) #

解析本页 A1 单格或有限矩形，支持 $/小写；返回规范 ref 与起止行列/尺寸。
拒绝整行整列、多区域、工作表前缀或反向区域；失败 null,err。

fsys.openXml.xlsx.querySheet(path,sheet,options) #

原生结构化查询：range、header=true、columns、where、orderBy、offset=0、limit=100、aggregates。
条件为 {column,op,value}，组合 all/any；不用 SQL/eval/回调。
maxScanRows=100000,maxScanCells=1000000 与结果limit分开；聚合仅已扫描匹配行。
rows项含 row,values,refs；扫描/匹配数量、scanTruncated/resultTruncated、scanComplete及范围可审计。
visibleOnly 仅反映保存的隐藏状态；DOM 解析仍扫描整个XML。

fsys.openXml.xlsx.read(path,options) #

readWorkbook 的别名。

fsys.openXml.xlsx.readSheet(path,sheet,options) #

按 1 起始序号、精确名称/部件名或 listSheets 返回项读取。
返回 rows,cells,summary,actualRange,selectedRange,dimension,warnings,truncated 等；原值不变。
range=A1矩形（不能同时指定起点）；maxRows/maxColumns进一步限制。
includeStructure=true 返回合并/行列/表/名称；includeStyles=true 返回保存样式；parseDates=true 附加日期/时间/时长解释。
旧 startRow/row,startColumn/column,includeRows/includeCells,maxMatrixCells 及包限额仍有效；0不取。失败null,err；不是流式读取。

fsys.openXml.xlsx.readWorkbook(path,options) #

一次打开包读取工作簿，共享字符串只加载一次。
返回 path,mainPart,date1904,sheetCount,sheets,warnings,truncated,errorCount,complete；sheets 项同 readSheet。
maxSheets=0 不取；默认任一表失败返回 null,err,partial；keepErrors=true 保留错误项。
maxMatrixCells 是本次调用所有矩形的累计格数，最高10000000；includeRows=false 不展开矩形。

Markdown 格式