Go-Excelize API源码阅读（三十六）——SetSheetRow、InsertPageBreak

Go-Excelize API源码阅读（三十六）——SetSheetRow、InsertPageBreak

开源摘星计划（WeOpen Star） 是由腾源会 2022 年推出的全新项目，旨在为开源人提供成长激励，为开源项目提供成长支持，助力开发者更好地了解开源，更快地跨越鸿沟，参与到开源的具体贡献与实践中。

不管你是开源萌新，还是希望更深度参与开源贡献的老兵，跟随“开源摘星计划”开启你的开源之旅，从一篇学习笔记、到一段代码的提交，不断挖掘自己的潜能，最终成长为开源社区的“闪亮之星”。

我们将同你一起，探索更多的可能性！

项目地址： WeOpen-Star：https://github.com/weopenprojects/WeOpen-Star

一、Go-Excelize简介

Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库，基于 ECMA-376，ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式，高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档，并提供流式读写 API，用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。使用本类库要求使用的 Go 语言为 1.15 或更高版本。

二、SetSheetRow

func (f *File) SetSheetRow(sheet, cell string, slice interface{}) error
1

根据给定的工作表名称、起始坐标和 slice 类型引用按行赋值。此功能是并发安全的。例如，在名为 Sheet1 的工作表第 6 行上，以 B6 单元格作为起始坐标按行赋值：

err := f.SetSheetRow("Sheet1", "B6", &[]interface{}{"1", nil, 2})
1

废话少说，直接展示代码：

func (f *File) SetSheetRow(sheet, cell string, slice interface{}) error {
	return f.setSheetCells(sheet, cell, slice, rows)
}
1
2
3

和上一篇的SetSheetCol一样，不过是将参数columns改为了rows。

三、InsertPageBreak

func (f *File) InsertPageBreak(sheet, cell string) error
1

根据给定的工作表名称和单元格坐标插入分页符。分页符是将工作表分成单独的页面以便打印的分隔线。
废话少说，直接上代码：

func (f *File) InsertPageBreak(sheet, cell string) error {
	ws, err := f.workSheetReader(sheet)
	if err != nil {
		return err
	}
	return ws.insertPageBreak(cell)
}
1
2
3
4
5
6
7

根据工作表名获取工作表对象，然后调用工作表对象的insertPageBreak方法。

看第一部分：

	var (
		row, col       int
		err            error
		rowBrk, colBrk = -1, -1
	)
	if col, row, err = CellNameToCoordinates(cell); err != nil {
		return err
	}
	col--
	row--
	if col == row && col == 0 {
		return err
	}
1
2
3
4
5
6
7
8
9
10
11
12
13

先获取单元格的行序号和列序号，然后把它们都减一，然后判断col和row是不是都为0。

如果都为0，就返回err。这是不是说明如果单元格是A1调用此函数就返回err？

	if ws.RowBreaks == nil {
		ws.RowBreaks = &xlsxRowBreaks{}
	}
	if ws.ColBreaks == nil {
		ws.ColBreaks = &xlsxColBreaks{}
	}

	for idx, brk := range ws.RowBreaks.Brk {
		if brk.ID == row {
			rowBrk = idx
		}
	}
	for idx, brk := range ws.ColBreaks.Brk {
		if brk.ID == col {
			colBrk = idx
		}
	}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

如果工作表对象的RowBreaks 或者 ColBreaks 为空，我们就创建一个xlsxColBreaks{}对象，并赋值给它们。

然后遍历中断切片，将中断的行或列序号保存。

	if row != 0 && rowBrk == -1 {
		ws.RowBreaks.Brk = append(ws.RowBreaks.Brk, &xlsxBrk{
			ID:  row,
			Max: MaxColumns - 1,
			Man: true,
		})
		ws.RowBreaks.ManualBreakCount++
	}
	if col != 0 && colBrk == -1 {
		ws.ColBreaks.Brk = append(ws.ColBreaks.Brk, &xlsxBrk{
			ID:  col,
			Max: TotalRows - 1,
			Man: true,
		})
		ws.ColBreaks.ManualBreakCount++
	}
	ws.RowBreaks.Count = len(ws.RowBreaks.Brk)
	ws.ColBreaks.Count = len(ws.ColBreaks.Brk)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

如果row序号不为0，但是rowBrk 还为初始值-1.或者col序号不为0，但是colBrk 为-1，我们就新建一个xlsxBrk对象加入。

结语

这是Excelize API阅读的第三十六篇，鉴于本人技术水平有限，如有错误，烦请指出斧正！感谢！