赞
踩
目录
3-9、xlrd.biffh.error_text_from_code字典
5、 博客个人主页
在Excel中,通常所说的“情侣键”并非官方术语,而是对某些常用且经常成对出现的快捷键的一种形象化的称呼。其中,最为人熟知和广泛使用的“情侣键”是“Ctrl+C”和“Ctrl+V”。
1、Ctrl+C:这个快捷键的作用是“拷贝”或“复制”。当你在Excel中选中某个单元格、一行、一列或整个工作表的内容后,按下Ctrl+C键,这些内容就会被复制到计算机的剪贴板中,等待下一步的粘贴操作。
2、Ctrl+V:这个快捷键的作用是“粘贴”。在你按下Ctrl+C键将内容复制到剪贴板后,可以通过按下Ctrl+V键将这些内容粘贴到Excel中的另一个位置,这两个操作经常是连续进行的,因此Ctrl+C和Ctrl+V就像一对“情侣”,总是成对出现。
除了这对常见的“情侣键”外,Excel中还有许多其他的快捷键可以帮助用户更高效地完成各种操作。然而,这些快捷键通常并没有像Ctrl+C和Ctrl+V那样形成特定的“情侣”关系。
然而,今天我不再展开介绍“情侣键”,而是要重点推介Python中的“情侣库”,即xlrd和xlwt两个第三方库。
xlrd库是一种用于在Python中读取Excel文件的库,它的名称中的"xl"代表Excel,"rd"代表读取,其开发者是John Machin(注:库名字符拆分诠释,只是一种猜测)。
xlrd最初是在2005年开始开发的,是基于Python的开源项目(下载:xlrd库官网下载)。
由于Excel文件在数据处理和分析中的重要性,xlrd库填补了Python在处理Excel文件方面的空白,使得用户可以方便地在Python环境中读取Excel文件的内容,并进行进一步的数据操作和分析。
xlrd库支持多种Excel文件格式,包括`.xls`和`.xlsx`(在旧版本中),这使得无论数据存储在哪种格式的Excel文件中,用户都可以使用xlrd库来读取。
xlrd库使用C语言编写,因此其性能非常高,即使面对非常大的Excel文件,xlrd也可以快速地读取其中的数据。
xlrd是完全开源的,可以在GitHub等平台上找到其源代码,这使得任何人都可以根据自己的需求对其进行修改和扩展。
xlrd提供了简单直接的API来获取单元格数据、行列数等,使得从Excel文件中读取数据变得简单而高效。
xlrd库适配多种Python版本,包括Python 2.7(不包括3.0-3.3)或Python 3.4及以上版本,这为用户提供了广泛的兼容性选择。
在xlrd 1.2.0之后的版本中(大约从2020年开始),xlrd库不再支持`.xlsx`文件格式,这限制了xlrd在新版Excel文件(主要是`.xlsx`格式)上的应用。
xlrd库主要专注于从Excel文件中读取数据,而不提供写入或修改Excel文件的功能,这使得在处理需要写入或修改Excel文件的任务时,用户需要结合其他库(如`openpyxl`或`xlwt`)使用。
由于xlrd库主要关注于读取Excel文件的功能,并且随着`.xlsx`格式的普及,其使用范围逐渐缩小,因此,xlrd库的更新和维护频率可能相对较低。
在某些情况下,xlrd库可能需要依赖外部资源或库来完全发挥其功能,这可能会增加用户在使用xlrd库时的复杂性和不确定性。
总之,xlrd库在读取Excel文件方面具有高效、开源和简单易用等优点,但在对`.xlsx`格式的支持、功能单一以及更新和维护频率等方面存在一些缺点,用户在选择使用xlrd库时需要根据自己的需求进行权衡和选择。
xlrd库适配的Python版本根据库的不同版本而有所不同。以下是针对几个主要版本的说明:
1-1、适配Python>=2.7(不包括3.0-3.3)或Python>=3.4。
1-2、该版本支持xlsx文件格式,并且是一个广泛使用的版本,因为它能够处理小到中等大小的Excel文件,并且具有较好的性能表现。
2-1、适配Python>=2.7(不包括3.0-3.5)或Python>=3.6。
2-2、该版本不再支持xlsx文件格式,仅支持旧版的xls文件格式,因为在xlrd 2.0版本之后,xlrd移除了对xlsx格式的支持。
xlrd3是xlrd的开源扩展库,提供了对xlsx文件格式的支持,然而,请注意,xlrd3并不是xlrd的官方名称(下载:https://github.com/Dragon2fly/xlrd3)。
用print()和dir()两个函数获取xlrd库所有属性和方法的列表
- # ['Book', 'FILE_FORMAT_DESCRIPTIONS', 'FMLA_TYPE_ARRAY', 'FMLA_TYPE_CELL', 'FMLA_TYPE_COND_FMT', 'FMLA_TYPE_DATA_VAL',
- # 'FMLA_TYPE_NAME', 'FMLA_TYPE_SHARED', 'Operand', 'PEEK_SIZE', 'Ref3D', 'XLDateError', 'XLRDError', 'XLS_SIGNATURE',
- # 'XL_CELL_BLANK', 'XL_CELL_BOOLEAN', 'XL_CELL_DATE', 'XL_CELL_EMPTY', 'XL_CELL_ERROR', 'XL_CELL_NUMBER', 'XL_CELL_TEXT', 'ZIP_SIGNATURE',
- # '__VERSION__', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__path__',
- # '__spec__', '__version__',
- # 'biff_text_from_num', 'biffh', 'book', 'cellname', 'cellnameabs', 'colname', 'compdoc', 'count_records', 'decompile_formula',
- # 'dump', 'dump_formula', 'empty_cell', 'error_text_from_code', 'evaluate_name_formula', 'formatting', 'formula', 'info',
- # 'inspect_format', 'oBOOL', 'oERR', 'oNUM', 'oREF', 'oREL', 'oSTRG', 'oUNK', 'okind_dict', 'open_workbook', 'open_workbook_xls',
- # 'os', 'pprint', 'rangename3d', 'rangename3drel', 'sheet', 'sys', 'timemachine', 'xldate', 'xldate_as_datetime', 'xldate_as_tuple', 'zipfile']
用help()函数获取xlrd库的帮助信息
- Help on package xlrd:
-
- NAME
- xlrd
-
- DESCRIPTION
- # Copyright (c) 2005-2012 Stephen John Machin, Lingfo Pty Ltd
- # This module is part of the xlrd package, which is released under a
- # BSD-style licence.
-
- PACKAGE CONTENTS
- biffh
- book
- compdoc
- formatting
- formula
- info
- sheet
- timemachine
- xldate
-
- FUNCTIONS
- count_records(filename, outfile=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>)
- For debugging and analysis: summarise the file's BIFF records.
- ie: produce a sorted file of ``(record_name, count)``.
-
- :param filename: The path to the file to be summarised.
- :param outfile: An open file, to which the summary is written.
-
- dump(filename, outfile=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>, unnumbered=False)
- For debugging: dump an XLS file's BIFF records in char & hex.
-
- :param filename: The path to the file to be dumped.
- :param outfile: An open file, to which the dump is written.
- :param unnumbered: If true, omit offsets (for meaningful diffs).
-
- inspect_format(path=None, content=None)
- Inspect the content at the supplied path or the :class:`bytes` content provided
- and return the file's type as a :class:`str`, or ``None`` if it cannot
- be determined.
-
- :param path:
- A :class:`string <str>` path containing the content to inspect.
- ``~`` will be expanded.
-
- :param content:
- The :class:`bytes` content to inspect.
-
- :returns:
- A :class:`str`, or ``None`` if the format cannot be determined.
- The return value can always be looked up in :data:`FILE_FORMAT_DESCRIPTIONS`
- to return a human-readable description of the format found.
-
- open_workbook(filename=None, logfile=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>, verbosity=0, use_mmap=True, file_contents=None, encoding_override=None, formatting_info=False, on_demand=False, ragged_rows=False, ignore_workbook_corruption=False)
- Open a spreadsheet file for data extraction.
-
- :param filename: The path to the spreadsheet file to be opened.
-
- :param logfile: An open file to which messages and diagnostics are written.
-
- :param verbosity: Increases the volume of trace material written to the
- logfile.
-
- :param use_mmap:
-
- Whether to use the mmap module is determined heuristically.
- Use this arg to override the result.
-
- Current heuristic: mmap is used if it exists.
-
- :param file_contents:
-
- A string or an :class:`mmap.mmap` object or some other behave-alike
- object. If ``file_contents`` is supplied, ``filename`` will not be used,
- except (possibly) in messages.
-
- :param encoding_override:
-
- Used to overcome missing or bad codepage information
- in older-version files. See :doc:`unicode`.
-
- :param formatting_info:
-
- The default is ``False``, which saves memory.
- In this case, "Blank" cells, which are those with their own formatting
- information but no data, are treated as empty by ignoring the file's
- ``BLANK`` and ``MULBLANK`` records.
- This cuts off any bottom or right "margin" of rows of empty or blank
- cells.
- Only :meth:`~xlrd.sheet.Sheet.cell_value` and
- :meth:`~xlrd.sheet.Sheet.cell_type` are available.
-
- When ``True``, formatting information will be read from the spreadsheet
- file. This provides all cells, including empty and blank cells.
- Formatting information is available for each cell.
-
- Note that this will raise a NotImplementedError when used with an
- xlsx file.
-
- :param on_demand:
-
- Governs whether sheets are all loaded initially or when demanded
- by the caller. See :doc:`on_demand`.
-
- :param ragged_rows:
-
- The default of ``False`` means all rows are padded out with empty cells so
- that all rows have the same size as found in
- :attr:`~xlrd.sheet.Sheet.ncols`.
-
- ``True`` means that there are no empty cells at the ends of rows.
- This can result in substantial memory savings if rows are of widely
- varying sizes. See also the :meth:`~xlrd.sheet.Sheet.row_len` method.
-
-
- :param ignore_workbook_corruption:
-
- This option allows to read corrupted workbooks.
- When ``False`` you may face CompDocError: Workbook corruption.
- When ``True`` that exception will be ignored.
-
- :returns: An instance of the :class:`~xlrd.book.Book` class.
-
- DATA
- FILE_FORMAT_DESCRIPTIONS = {'xls': 'Excel xls', 'xlsb': 'Excel 2007 xl...
- FMLA_TYPE_ARRAY = 4
- FMLA_TYPE_CELL = 1
- FMLA_TYPE_COND_FMT = 8
- FMLA_TYPE_DATA_VAL = 16
- FMLA_TYPE_NAME = 32
- FMLA_TYPE_SHARED = 2
- PEEK_SIZE = 8
- XLS_SIGNATURE = b'\xd0\xcf\x11\xe0\xa1\xb1\x1a\xe1'
- XL_CELL_BLANK = 6
- XL_CELL_BOOLEAN = 4
- XL_CELL_DATE = 3
- XL_CELL_EMPTY = 0
- XL_CELL_ERROR = 5
- XL_CELL_NUMBER = 2
- XL_CELL_TEXT = 1
- ZIP_SIGNATURE = b'PK\x03\x04'
- __VERSION__ = '2.0.1'
- biff_text_from_num = {0: '(not BIFF)', 20: '2.0', 21: '2.1', 30: '3', ...
- empty_cell = empty:''
- error_text_from_code = {0: '#NULL!', 7: '#DIV/0!', 15: '#VALUE!', 23: ...
- oBOOL = 3
- oERR = 4
- oNUM = 2
- oREF = -1
- oREL = -2
- oSTRG = 1
- oUNK = 0
- okind_dict = {-2: 'oREL', -1: 'oREF', 0: 'oUNK', 1: 'oSTRG', 2: 'oNUM'...
-
- VERSION
- 2.0.1
-
- FILE
- e:\python_workspace\pythonproject\lib\site-packages\xlrd\__init__.py
xlrd.dump(filename, outfile=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>, unnumbered=False)
3-7-2-1、filename(必须):指定了要转储的文件的路径,可以是绝对路径或相对路径。
3-7-2-2、outfile(必须):一个已经通过某种方式(如open()函数)打开的文件对象,转储函数将把内容写入到这个文件中。
3-7-2-3、unnumbered(可选):一个布尔值,用于控制是否在转储内容中包含偏移量信息。如果设置为True,则不包含偏移量,这可能在生成差异比较时有用,因为偏移量可能会使比较变得复杂或难以阅读;如果设置为False(或省略),则包含偏移量。
用于将Excel文件(或其他某种格式的文件)的内容以某种形式(可能是文本或二进制)转储到另一个文件中,以便进行进一步的分析、比较或存档。
无
3-7-5-1、由于xlrd.dump主要用于调试和诊断,因此在常规的数据处理或分析中可能不常用。
3-7-5-2、从xlrd版本2.0开始,它不再支持.xlsx文件,只支持.xls文件。如果需要处理.xlsx文件,可以考虑使用其他库,如openpyxl。
3-7-5-3、在使用xlrd.dump时,应该小心处理日志文件或标准输出的内容,因为它可能会包含大量的详细信息和数据。
- # 7、xlrd.dump函数
- import xlrd
- import sys
- def dump(filename, outfile=sys.stdout, unnumbered=False):
- # 打开Excel文件
- workbook = xlrd.open_workbook(filename)
- # 遍历所有工作表
- for sheet_index, sheet_name in enumerate(workbook.sheet_names()):
- # 打印或写入工作表名称
- print(f"Sheet Name: {sheet_name}", file=outfile)
- # 获取工作表对象
- sheet = workbook.sheet_by_name(sheet_name)
- # 遍历行和列
- for row_index in range(sheet.nrows):
- row_values = sheet.row_values(row_index)
- # 如果unnumbered为 False,则打印或写入行号
- if not unnumbered:
- print(f"Row {row_index + 1}:", file=outfile, end='')
- # 打印或写入行内容
- for value in row_values:
- print(value, end='\t', file=outfile)
- print(file=outfile) # 换行
- if __name__ == '__main__':
- # 直接输出到控制台
- dump(r'E:\360Downloads\test.xls')
- # 输出到文件
- with open(r'E:\360Downloads\test_dump.txt', 'w', encoding='utf-8') as outfile:
- dump(r'E:\360Downloads\test.xls', outfile=outfile, unnumbered=True)
xlrd.count_records(filename, outfile=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>)
3-8-2-1、filename(必须):指定了要转储的文件的路径,可以是绝对路径或相对路径。
3-8-2-2、outfile(可选):一个已经通过某种方式(如open()函数)打开的文件对象,转储函数将把内容写入到这个文件中。
计算一个 Excel 文件中所有工作表的总记录数(即所有单元格的数量)。
返回文件中所有单元格的总数。
无
- # 8、xlrd.count_records函数
- import xlrd
- def count_records(filename):
- # 打开Excel文件
- workbook = xlrd.open_workbook(filename)
- total_cells = 0
- # 遍历所有工作表
- for sheet in workbook.sheets():
- # 计算每个工作表的单元格数量
- nrows = sheet.nrows
- ncols = sheet.ncols
- total_cells += nrows * ncols
- # 返回所有单元格的总数
- return total_cells
- if __name__ == '__main__':
- total_cells_count = count_records(r'E:\360Downloads\test.xls')
- print(f"Total number of cells: {total_cells_count}")
xlrd.biffh.error_text_from_code= {0: '#NULL!', 7: '#DIV/0!', 15: '#VALUE!', 23: '#REF!', 29: '#NAME?', 36: '#NUM!', 42: '#N/A'}
无
用于根据Excel文件中的BIFF(Binary Interchange File Format)错误代码检索对应的错误文本。
返回一个已知错误代码对应的字符串或Unknown error(不存在的错误代码情况)。
无
- # 9、xlrd.biffh.error_text_from_code字典
- # 9-1、查看字典信息
- import xlrd
- print(xlrd.biffh.error_text_from_code)
- # 输出:{0: '#NULL!', 7: '#DIV/0!', 15: '#VALUE!', 23: '#REF!', 29: '#NAME?', 36: '#NUM!', 42: '#N/A'}
-
- # 9-2、应用示例
- # 假设的错误代码和对应的错误文本
- error_codes = {0: '#NULL!', 7: '#DIV/0!', 15: '#VALUE!', 23: '#REF!',
- 29: '#NAME?', 36: '#NUM!', 42: '#N/A'}
- # 创建一个函数,用于根据错误代码获取错误文本
- def error_text_from_code(code):
- return error_codes.get(code, "Unknown error")
- if __name__ == '__main__':
- code = 29 # 假设我们遇到了一个无效的文件格式错误
- print(error_text_from_code(code)) # 输出: #NAME?
- code = 888 # 一个不存在的错误代码
- print(error_text_from_code(code)) # 输出: Unknown error
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。