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

# ['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-21、openpyxl.worksheet.worksheet.Worksheet.calculate_dimension函数

3-21-1、语法

calculate_dimension(self)
    Return the minimum bounding range for all cells containing data (ex. 'A1:M24')
    
    :rtype: string

3-21-2、参数

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

3-21-3、功能

用于计算工作表中单元格的维度，即返回工作表中使用的单元格的范围。

3-21-4、返回值

一个字符串，表示工作表中使用单元格的范围(例如:"A1:C10")。

3-21-5、说明

该函数的应用场景有：

3-21-5-1、数据导出: 在导出数据到其他格式(如CSV或SQL)时，可以使用此函数来确定需要导出的单元格范围。

3-21-5-2、报告生成: 自动化报告生成时，用于确定数据区域，从而生成正确的报表。

3-21-5-3、数据处理: 在数据处理脚本中，可以用来动态确定处理范围，避免处理空单元格。

3-21-6、用法

# 21、openpyxl.worksheet.worksheet.Worksheet.calculate_dimension函数
from openpyxl import Workbook
# 创建一个新的工作簿并激活工作表
wb = Workbook()
ws = wb.active
# 添加一些数据
ws['A1'] = 'Hello'
ws['B2'] = 'World'
ws['C10'] = 'End'
# 计算工作表的维度
dimension = ws.calculate_dimension()
print(dimension)  # 输出：A1:C10

3-22、openpyxl.worksheet.worksheet.Worksheet.cell函数

3-22-1、语法

cell(self, row, column, value=None)
    Returns a cell object based on the given coordinates.
    
    Usage: cell(row=15, column=1, value=5)
    
    Calling `cell` creates cells in memory when they
    are first accessed.
    
    :param row: row index of the cell (e.g. 4)
    :type row: int
    
    :param column: column index of the cell (e.g. 3)
    :type column: int
    
    :param value: value of the cell (e.g. 5)
    :type value: numeric or time or string or bool or none
    
    :rtype: openpyxl.cell.cell.Cell

3-22-2、参数

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

3-22-2-2、row(必须)：一个整数类型，表示指定的行号，从1开始。

3-22-2-3、column(必须)：一个整数类型，表示指定的列号，从1开始。

3-22-2-4、value(可选)：如果提供该参数，会将该值赋给指定的单元格。

3-22-3、功能

用于获取工作表中指定位置的单元格，如果该位置的单元格不存在，则会自动创建。

3-22-4、返回值

返回一个Cell对象，代表指定位置的单元格。

3-22-5、说明

该函数的应用场景有：

3-22-5-1、数据录入：在编写脚本时，可以通过cell函数向工作表中的特定位置写入数据。

3-22-5-2、数据读取：可以通过该函数从工作表中读取指定位置的数据。

3-22-5-3、自动化处理：在自动化任务中，可以根据行列号动态访问或创建单元格，实现数据的批量处理。

3-22-6、用法

# 22、openpyxl.worksheet.worksheet.Worksheet.cell函数
from openpyxl import Workbook
# 创建一个新的工作簿并激活工作表
wb = Workbook()
ws = wb.active
# 获取或创建一个单元格
cell = ws.cell(row=1, column=1)  # 访问A1单元格
cell.value = 'Hello'
# 可以简化为直接赋值
ws.cell(row=2, column=2, value='World')  # 访问B2单元格，并赋值为'World'
# 获取单元格的值
value = ws.cell(row=1, column=1).value
print(value)  # 输出：Hello

3-23、openpyxl.worksheet.worksheet.Worksheet.delete_cols函数

3-23-1、语法

delete_cols(self, idx, amount=1)
    Delete column or columns from col==idx

3-23-2、参数

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

3-23-2-2、idx(必须)：一个整数类型，表示指定从哪一列开始删除，列号从1开始。

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

3-23-3、功能

根据给定的列索引和数量删除列，并将右侧列的内容左移填补空白。

3-23-4、返回值

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

3-23-5、说明

3-23-5-1、适用于清理数据时删除多余的列、重整表格布局或去除不需要的列。

3-23-5-2、删除操作不可逆，建议在执行删除操作前做好备份。

3-23-6、用法

# 23、openpyxl.worksheet.worksheet.Worksheet.delete_cols函数
from openpyxl import Workbook
# 创建一个新的工作簿并激活工作表
wb = Workbook()
ws = wb.active
# 向工作表中添加一些数据
for col in range(1, 6):
    ws.cell(row=1, column=col, value=f'Header {col}')
    ws.cell(row=2, column=col, value=col)
# 打印删除列之前的内容
for row in ws.iter_rows(values_only=True):
    print(row)
# 删除第2列
ws.delete_cols(idx=2)
# 打印删除列之后的内容
print("\nAfter deleting the 2nd column:\n")
for row in ws.iter_rows(values_only=True):
    print(row)
# 保存工作簿
wb.save('delete_columns_example.xlsx')

3-24、openpyxl.worksheet.worksheet.Worksheet.delete_rows函数

3-24-1、语法

delete_rows(self, idx, amount=1)
    Delete row or rows from row==idx

3-24-2、参数

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

3-24-2-2、idx(必须)：一个整数类型，表示指定从哪一行开始删除，行号从1开始。

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

3-24-3、功能

根据给定的行索引和数量删除行，并将下方行的内容上移填补空白。

3-24-4、返回值

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

3-24-5、说明

3-24-5-1、适用于清理数据时删除多余的行、重整表格布局或去除不需要的行。

3-24-5-2、删除操作不可逆，建议在执行删除操作前做好备份。

3-24-6、用法

# 24、openpyxl.worksheet.worksheet.Worksheet.delete_rows函数
from openpyxl import Workbook
# 创建一个新的工作簿并激活工作表
wb = Workbook()
ws = wb.active
# 向工作表中添加一些数据
for row in range(1, 6):
    ws.append([f'Row {row} Col {col}' for col in range(1, 6)])
# 打印删除行之前的内容
for row in ws.iter_rows(values_only=True):
    print(row)
# 删除第2行
ws.delete_rows(idx=2)
# 打印删除行之后的内容
print("\nAfter deleting the 2nd row:\n")
for row in ws.iter_rows(values_only=True):
    print(row)
# 保存工作簿
wb.save('delete_rows_example.xlsx')

3-25、openpyxl.worksheet.worksheet.Worksheet.insert_cols函数

3-25-1、语法

insert_cols(self, idx, amount=1)
    Insert column or columns before col==idx

3-25-2、参数

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

3-25-2-2、idx(必须)：一个整数类型，表示指定从哪一列开始插入，列号从1开始。

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

3-25-3、功能

根据给定的列索引和数量插入空白列，并将右侧列的内容右移。

3-25-4、返回值

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

3-25-5、说明

3-25-5-1、适用于在现有数据中间插入新列、调整表格结构或添加空白列以供后续填充数据。

3-25-5-2、插入操作会导致数据列向右移动，确保不会覆盖现有数据。

3-25-6、用法

# 25、openpyxl.worksheet.worksheet.Worksheet.insert_cols函数
from openpyxl import Workbook
# 创建一个新的工作簿并激活工作表
wb = Workbook()
ws = wb.active
# 向工作表中添加一些数据
for row in range(1, 6):
    ws.append([f'Row {row} Col {col}' for col in range(1, 6)])
# 打印插入列之前的内容
for row in ws.iter_rows(values_only=True):
    print(row)
# 在第2列位置插入一列
ws.insert_cols(idx=2)
# 打印插入列之后的内容
print("\nAfter inserting a column at the 2nd position:\n")
for row in ws.iter_rows(values_only=True):
    print(row)
# 保存工作簿
wb.save('insert_cols_example.xlsx')