首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Go-Excelize API源码阅读(三十六)——SetSheetRow、InsertPageBreak

Go-Excelize API源码阅读(三十六)——SetSheetRow、InsertPageBreak

作者头像
Regan Yue
发布2022-12-01 16:52:08
2710
发布2022-12-01 16:52:08
举报
文章被收录于专栏:ReganYue's BlogReganYue's Blog

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

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

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

废话少说,直接展示代码:

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

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

在这里插入图片描述
在这里插入图片描述
三、InsertPageBreak
func (f *File) InsertPageBreak(sheet, cell string) error

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

func (f *File) InsertPageBreak(sheet, cell string) error {
	ws, err := f.workSheetReader(sheet)
	if err != nil {
		return err
	}
	return ws.insertPageBreak(cell)
}

根据工作表名获取工作表对象,然后调用工作表对象的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
	}

先获取单元格的行序号和列序号,然后把它们都减一,然后判断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
		}
	}

如果工作表对象的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)

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

结语

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

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2022-11-27 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • Go-Excelize API源码阅读(三十六)——SetSheetRow、InsertPageBreak
    • 一、Go-Excelize简介
      • 二、SetSheetRow
        • 三、InsertPageBreak
          • 结语
          相关产品与服务
          边缘可用区
          腾讯云边缘可用区(TencentCloud Edge Zone,TEZ)是腾讯云的本地扩展,适用于解决计算、存储和服务可用性问题。腾讯云边缘可用区可为您带来云的诸多优势,例如弹性、可扩展性和安全性。借助腾讯云边缘可用区,您可以在靠近最终用户的地理位置运行对延迟敏感的应用程序,基本消除延迟问题。腾讯云边缘可用区提供与中心节点一致的体验,助力业务下沉,具备更低延时、更广覆盖、更少成本等特点。
          领券
          问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档