Python酷库之旅-第三方库openpyxl(06)

# ['DEBUG', 'DEFUSEDXML', 'LXML', 'NUMPY', 'Workbook', '__author__', '__author_email__', '__builtins__', '__cached__', 
# '__doc__', '__file__', '__license__', '__loader__', '__maintainer_email__', '__name__', '__package__', '__path__',
# '__spec__', '__url__', '__version__', '_constants', 'cell', 'chart', 'chartsheet', 'comments', 'compat', 'constants',
# 'descriptors', 'drawing', 'formatting', 'formula', 'load_workbook', 'open', 'packaging', 'pivot', 'reader', 'styles',
# 'utils', 'workbook', 'worksheet', 'writer', 'xml']

2、获取openpyxl库的帮助信息

用help()函数获取openpyxl库的帮助信息

Help on package openpyxl:

NAME
    openpyxl - # Copyright (c) 2010-2024 openpyxl

PACKAGE CONTENTS
    _constants
    cell (package)
    chart (package)
    chartsheet (package)
    comments (package)
    compat (package)
    descriptors (package)
    drawing (package)
    formatting (package)
    formula (package)
    packaging (package)
    pivot (package)
    reader (package)
    styles (package)
    utils (package)
    workbook (package)
    worksheet (package)
    writer (package)
    xml (package)

SUBMODULES
    constants

DATA
    DEBUG = False
    DEFUSEDXML = False
    LXML = True
    NUMPY = True
    __author_email__ = 'charlie.clark@clark-consulting.eu'
    __license__ = 'MIT'
    __maintainer_email__ = 'openpyxl-users@googlegroups.com'
    __url__ = 'https://openpyxl.readthedocs.io'

VERSION
    3.1.3

AUTHOR
    See AUTHORS

FILE
    e:\python_workspace\pythonproject\lib\site-packages\openpyxl\__init__.py

3、用法精讲

3-26、openpyxl.worksheet.worksheet.Worksheet.insert_rows函数

3-26-1、语法

insert_rows(self, idx, amount=1)
    Insert row or rows before row==idx

3-26-2、参数

3-26-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-26-2-2、idx(必须)：一个整数类型，表示要插入行的位置索引(从1开始)，即在第几行之前插入新行。

3-26-2-3、 amount(可选)：一个整数类型，表示指定要插入的行数，默认为 1。如果插入多行，可以设置为大于1的整数。

3-26-3、功能

用于在指定位置插入一行或多行的函数。

3-26-4、返回值

没有返回值，但会直接修改工作表对象。

3-26-5、说明

无

3-26-6、用法

# 26、openpyxl.worksheet.worksheet.Worksheet.insert_rows函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 向工作表添加一些数据
ws['A1'] = 'Header1'
ws['B1'] = 'Header2'
ws['A2'] = 'Row 1'
ws['B2'] = 'Row 1 data'
ws['A3'] = 'Row 2'
ws['B3'] = 'Row 2 data'
# 在第2行之前插入3行
ws.insert_rows(2, 3)
# 保存工作簿
wb.save('inserted_rows.xlsx')

3-27、openpyxl.worksheet.worksheet.Worksheet.iter_cols函数

3-27-1、语法

iter_cols(self, min_col=None, max_col=None, min_row=None, max_row=None, values_only=False)
    Produces cells from the worksheet, by column. Specify the iteration range
    using indices of rows and columns.
    
    If no indices are specified the range starts at A1.
    
    If no cells are in the worksheet an empty tuple will be returned.
    
    :param min_col: smallest column index (1-based index)
    :type min_col: int
    
    :param min_row: smallest row index (1-based index)
    :type min_row: int
    
    :param max_col: largest column index (1-based index)
    :type max_col: int
    
    :param max_row: largest row index (1-based index)
    :type max_row: int
    
    :param values_only: whether only cell values should be returned
    :type values_only: bool
    
    :rtype: generator

3-27-2、参数

3-27-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-27-2-2、min_col(可选)：一个整数类型(默认值为None)，表示要遍历的最左列索引。

3-27-2-3、max_col(可选)：一个整数类型(默认值为None)，表示要遍历的最右列索引。

3-27-2-4、min_row(可选)：一个整数类型(默认值为None)，表示要遍历的起始行索引。

3-27-2-5、max_row(可选)：一个整数类型(默认值为None)，表示要遍历的结束行索引。

3-27-2-6、values_only(可选)：一个布尔值(默认值为False)，是否仅返回单元格的值而不是单元格对象。如果为True，仅返回单元格的值。

3-27-3、功能

用于遍历和获取工作表中的列数据的工具。

3-27-4、返回值

返回一个生成器，生成器每次迭代都会提供一个元组，该元组包含指定范围内的每一列的单元格或单元格的值。

3-27-5、说明

该函数的应用场景有：

3-27-5-1、遍历大数据量的列时，提高内存和性能效率。

3-27-5-2、仅处理或查看单元格的值而不是单元格对象。

3-27-5-3、按列遍历而非按行遍历工作表的数据。

3-27-6、用法

# 27、openpyxl.worksheet.worksheet.Worksheet.iter_cols函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 向工作表添加一些数据
ws['A1'] = 'Header1'
ws['B1'] = 'Header2'
ws['A2'] = 'Row 1'
ws['B2'] = 'Row 1 data'
ws['A3'] = 'Row 2'
ws['B3'] = 'Row 2 data'
ws['A4'] = 'Row 3'
ws['B4'] = 'Row 3 data'
# 使用 iter_cols 遍历列
for col in ws.iter_cols(min_row=1, max_row=4, min_col=1, max_col=2, values_only=True):
    for cell in col:
        print(cell)

3-28、openpyxl.worksheet.worksheet.Worksheet.iter_rows函数

3-28-1、语法

iter_rows(self, min_row=None, max_row=None, min_col=None, max_col=None, values_only=False)
    Produces cells from the worksheet, by row. Specify the iteration range
    using indices of rows and columns.
    
    If no indices are specified the range starts at A1.
    
    If no cells are in the worksheet an empty tuple will be returned.
    
    :param min_col: smallest column index (1-based index)
    :type min_col: int
    
    :param min_row: smallest row index (1-based index)
    :type min_row: int
    
    :param max_col: largest column index (1-based index)
    :type max_col: int
    
    :param max_row: largest row index (1-based index)
    :type max_row: int
    
    :param values_only: whether only cell values should be returned
    :type values_only: bool
    
    :rtype: generator

3-28-2、参数

3-28-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-28-2-2、min_row(可选)：一个整数类型(默认值为None)，表示要遍历的起始行索引。

3-28-2-3、max_row(可选)：一个整数类型(默认值为None)，表示要遍历的结束行索引。

3-28-2-4、min_col(可选)：一个整数类型(默认值为None)，表示要遍历的最左列索引。

3-28-2-5、max_col(可选)：一个整数类型(默认值为None)，表示要遍历的最右列索引。

3-27-2-6、values_only(可选)：一个布尔值(默认值为False)，是否仅返回单元格的值而不是单元格对象。如果为True，仅返回单元格的值。

3-28-3、功能

用于遍历和获取工作表中的行数据的工具。

3-28-4、返回值

返回一个生成器，生成器每次迭代都会提供一个元组，该元组包含指定范围内的每一行的单元格或单元格的值。

3-28-5、说明

该函数的应用场景有：

3-28-5-1、遍历大数据量的行时，提高内存和性能效率。

3-28-5-2、仅处理或查看单元格的值而不是单元格对象。

3-28-5-3、按行遍历而非按列遍历工作表的数据。

3-28-6、用法

# 28、openpyxl.worksheet.worksheet.Worksheet.iter_rows函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 向工作表添加一些数据
ws['A1'] = 'Header1'
ws['B1'] = 'Header2'
ws['A2'] = 'Row 1'
ws['B2'] = 'Row 1 data'
ws['A3'] = 'Row 2'
ws['B3'] = 'Row 2 data'
ws['A4'] = 'Row 3'
ws['B4'] = 'Row 3 data'
# 使用 iter_rows 遍历行
for row in ws.iter_rows(min_row=1, max_row=4, min_col=1, max_col=2, values_only=True):
    for cell in row:
        print(cell)

3-29、openpyxl.worksheet.worksheet.Worksheet.merge_cells函数

3-29-1、语法

merge_cells(self, range_string=None, start_row=None, start_column=None, end_row=None, end_column=None)
    Set merge on a cell range.  Range is a cell range (e.g. A1:E1)

3-29-2、参数

3-29-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-29-2-2、range_string(可选)：一个字符串，表示要合并的单元格范围。例如，"A1:D1" 表示从A1单元格到D1单元格的范围。

3-29-2-3、start_row(可选)：一个整数(默认值为None)，表示要合并的起始行索引。

3-29-2-4、start_column(可选)：一个整数(默认值为None)，表示要合并的起始列索引。

3-29-2-5、end_row(可选)：一个整数(默认值为None)，表示要合并的结束行索引。

3-29-2-6、end_column(可选)：一个整数(默认值为None)，表示要合并的结束列索引。

3-29-3、功能

用于在Excel工作表中合并单元格。

3-29-4、返回值

没有返回值，但会直接修改工作表。

3-29-5、说明

该函数的应用场景有：

3-29-5-1、创建报表或表格时需要将多个单元格合并以展示一个大标题。

3-29-5-2、需要合并单元格来突出显示某些数据或使布局更整洁。

3-29-6、用法

# 29、openpyxl.worksheet.worksheet.Worksheet.merge_cells函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 向工作表添加一些数据
ws['A1'] = 'Merged Cell'
# 合并单元格范围 A1:D1
ws.merge_cells('A1:D1')
# 或者使用起始和结束行列索引来合并单元格
ws.merge_cells(start_row=2, start_column=1, end_row=2, end_column=4)
# 保存工作簿
wb.save('merged_cells.xlsx')

3-30、openpyxl.worksheet.worksheet.Worksheet.move_range函数

3-30-1、语法

move_range(self, cell_range, rows=0, cols=0, translate=False)
    Move a cell range by the number of rows and/or columns:
    down if rows > 0 and up if rows < 0
    right if cols > 0 and left if cols < 0
    Existing cells will be overwritten.
    Formulae and references will not be updated.

3-30-2、参数

3-30-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-30-2-2、cell_range(必须)：一个字符串，表示要移动的单元格范围。例如，"A1:D1" 表示从A1单元格到D1单元格的范围。

3-30-2-3、 rows(可选)：一个整数(默认值为0)，表示指定移动目标位置的行偏移量。正数表示向下移动，负数表示向上移动。

3-30-2-4、 cols(可选)：一个整数(默认值为0)，表示指定移动目标位置的列偏移量。正数表示向右移动，负数表示向左移动。

3-30-2-5、 translate(可选)：一个布尔值(默认值为True)，表示是否自动更新引用(例如公式中的单元格引用)。如果为False，移动时不会更新引用。

3-30-3、功能

用于移动一个范围内的单元格到工作表中的新位置。

3-30-4、返回值

没有返回值，但会直接修改工作表。

3-30-5、说明

该函数的应用场景有：

3-30-5-1、需要重新排列或重组数据区域以适应工作表布局的变化。

3-30-5-2、自动化处理工作表数据时，通过移动单元格范围来动态调整数据位置。

3-30-6、用法

# 30、openpyxl.worksheet.worksheet.Worksheet.move_range函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 向工作表添加一些数据
ws['A1'] = 'Data 1'
ws['B1'] = 'Data 2'
ws['C1'] = 'Data 3'
ws['D1'] = 'Data 4'
# 打印移动前的数据
print("移动前：")
for row in ws.iter_rows(min_row=1, max_row=1, min_col=1, max_col=4):
    for cell in row:
        print(cell.value, end=" ")
print()
# 移动单元格范围 A1:D1 到新的位置（向下移动2行，向右移动1列）
ws.move_range("A1:D1", rows=2, cols=1)
# 打印移动后的数据
print("移动后：")
for row in ws.iter_rows(min_row=3, max_row=3, min_col=2, max_col=5):
    for cell in row:
        print(cell.value, end=" ")
print()
# 保存工作簿
wb.save('moved_cells.xlsx')