当前位置:   article > 正文

Python酷库之旅-比翼双飞情侣库(03)

Python酷库之旅-比翼双飞情侣库(03)

目录

一、xlrd库的由来

二、xlrd库优缺点

1、优点

1-1、支持多种Excel文件格式

1-2、高效性

1-3、开源性

1-4、简单易用

1-5、良好的兼容性

2、缺点

2-1、对.xlsx格式支持有限

2-2、功能相对单一

2-3、更新和维护频率低

2-4、依赖外部资源

三、xlrd库的版本说明

1、xlrd 1.2.0版本

2、xlrd 2.0.1版本

3、xlrd3(非官方名称)

四、如何学好xlrd库?

1、获取xlrd库的属性和方法

2、获取xlrd库的帮助信息

3、用法精讲

3-7、xlrd.dump函数

3-7-1、语法

3-7-2、参数

3-7-3、功能

3-7-4、返回值

3-7-5、说明

3-7-6、用法

3-8、xlrd.count_records函数

3-8-1、语法

3-8-2、参数

3-8-3、功能

3-8-4、返回值

3-8-5、说明

3-8-6、用法

3-9、xlrd.biffh.error_text_from_code字典

3-9-1、语法

3-9-2、参数

3-9-3、功能

3-9-4、返回值

3-9-5、说明

3-9-6、用法

五、推荐阅读

1、Python筑基之旅

2、Python函数之旅

3、Python算法之旅

4、Python魔法之旅

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库的由来

        xlrd库是一种用于在Python中读取Excel文件的库,它的名称中的"xl"代表Excel,"rd"代表读取,其开发者是John Machin(注:库名字符拆分诠释,只是一种猜测)。

        xlrd最初是在2005年开始开发的,是基于Python的开源项目(下载:xlrd库官网下载)。

        由于Excel文件在数据处理和分析中的重要性,xlrd库填补了Python在处理Excel文件方面的空白,使得用户可以方便地在Python环境中读取Excel文件的内容,并进行进一步的数据操作和分析。

二、xlrd库

1、优点
1-1、支持多种Excel文件格式

        xlrd库支持多种Excel文件格式,包括`.xls`和`.xlsx`(在旧版本中),这使得无论数据存储在哪种格式的Excel文件中,用户都可以使用xlrd库来读取。


1-2、高效性

        xlrd库使用C语言编写,因此其性能非常高,即使面对非常大的Excel文件,xlrd也可以快速地读取其中的数据。


1-3、开源性

        xlrd是完全开源的,可以在GitHub等平台上找到其源代码,这使得任何人都可以根据自己的需求对其进行修改和扩展。


1-4、简单易用

        xlrd提供了简单直接的API来获取单元格数据、行列数等,使得从Excel文件中读取数据变得简单而高效。


1-5、良好的兼容性

        xlrd库适配多种Python版本,包括Python 2.7(不包括3.0-3.3)或Python 3.4及以上版本,这为用户提供了广泛的兼容性选择。

2、缺点
2-1、对.xlsx格式支持有限

        在xlrd 1.2.0之后的版本中(大约从2020年开始),xlrd库不再支持`.xlsx`文件格式,这限制了xlrd在新版Excel文件(主要是`.xlsx`格式)上的应用。


2-2、功能相对单一

        xlrd库主要专注于从Excel文件中读取数据,而不提供写入或修改Excel文件的功能,这使得在处理需要写入或修改Excel文件的任务时,用户需要结合其他库(如`openpyxl`或`xlwt`)使用。


2-3、更新和维护频率低

        由于xlrd库主要关注于读取Excel文件的功能,并且随着`.xlsx`格式的普及,其使用范围逐渐缩小,因此,xlrd库的更新和维护频率可能相对较低。


2-4、依赖外部资源

        在某些情况下,xlrd库可能需要依赖外部资源或库来完全发挥其功能,这可能会增加用户在使用xlrd库时的复杂性和不确定性。

        总之,xlrd库在读取Excel文件方面具有高效、开源和简单易用等优点,但在对`.xlsx`格式的支持、功能单一以及更新和维护频率等方面存在一些缺点,用户在选择使用xlrd库时需要根据自己的需求进行权衡和选择。

三、xlrd库的版本说明

        xlrd库适配的Python版本根据库的不同版本而有所不同。以下是针对几个主要版本的说明:

1、xlrd 1.2.0版本

1-1、适配Python>=2.7(不包括3.0-3.3)或Python>=3.4
1-2、该版本支持xlsx文件格式,并且是一个广泛使用的版本,因为它能够处理小到中等大小的Excel文件,并且具有较好的性能表现。

2、xlrd 2.0.1版本

2-1、适配Python>=2.7(不包括3.0-3.5)或Python>=3.6
2-2、该版本不再支持xlsx文件格式仅支持旧版的xls文件格式,因为在xlrd 2.0版本之后,xlrd移除了对xlsx格式的支持。

3、xlrd3(非官方名称)

        xlrd3是xlrd的开源扩展库,提供了对xlsx文件格式的支持,然而,请注意,xlrd3并不是xlrd的官方名称(下载:https://github.com/Dragon2fly/xlrd3)。

四、如何学好xlrd库?

1、获取xlrd库的属性和方法

        用print()和dir()两个函数获取xlrd库所有属性和方法的列表

  1. # ['Book', 'FILE_FORMAT_DESCRIPTIONS', 'FMLA_TYPE_ARRAY', 'FMLA_TYPE_CELL', 'FMLA_TYPE_COND_FMT', 'FMLA_TYPE_DATA_VAL',
  2. # 'FMLA_TYPE_NAME', 'FMLA_TYPE_SHARED', 'Operand', 'PEEK_SIZE', 'Ref3D', 'XLDateError', 'XLRDError', 'XLS_SIGNATURE',
  3. # 'XL_CELL_BLANK', 'XL_CELL_BOOLEAN', 'XL_CELL_DATE', 'XL_CELL_EMPTY', 'XL_CELL_ERROR', 'XL_CELL_NUMBER', 'XL_CELL_TEXT', 'ZIP_SIGNATURE',
  4. # '__VERSION__', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__path__',
  5. # '__spec__', '__version__',
  6. # 'biff_text_from_num', 'biffh', 'book', 'cellname', 'cellnameabs', 'colname', 'compdoc', 'count_records', 'decompile_formula',
  7. # 'dump', 'dump_formula', 'empty_cell', 'error_text_from_code', 'evaluate_name_formula', 'formatting', 'formula', 'info',
  8. # 'inspect_format', 'oBOOL', 'oERR', 'oNUM', 'oREF', 'oREL', 'oSTRG', 'oUNK', 'okind_dict', 'open_workbook', 'open_workbook_xls',
  9. # 'os', 'pprint', 'rangename3d', 'rangename3drel', 'sheet', 'sys', 'timemachine', 'xldate', 'xldate_as_datetime', 'xldate_as_tuple', 'zipfile']
2、获取xlrd库的帮助信息

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

  1. Help on package xlrd:
  2. NAME
  3. xlrd
  4. DESCRIPTION
  5. # Copyright (c) 2005-2012 Stephen John Machin, Lingfo Pty Ltd
  6. # This module is part of the xlrd package, which is released under a
  7. # BSD-style licence.
  8. PACKAGE CONTENTS
  9. biffh
  10. book
  11. compdoc
  12. formatting
  13. formula
  14. info
  15. sheet
  16. timemachine
  17. xldate
  18. FUNCTIONS
  19. count_records(filename, outfile=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>)
  20. For debugging and analysis: summarise the file's BIFF records.
  21. ie: produce a sorted file of ``(record_name, count)``.
  22. :param filename: The path to the file to be summarised.
  23. :param outfile: An open file, to which the summary is written.
  24. dump(filename, outfile=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>, unnumbered=False)
  25. For debugging: dump an XLS file's BIFF records in char & hex.
  26. :param filename: The path to the file to be dumped.
  27. :param outfile: An open file, to which the dump is written.
  28. :param unnumbered: If true, omit offsets (for meaningful diffs).
  29. inspect_format(path=None, content=None)
  30. Inspect the content at the supplied path or the :class:`bytes` content provided
  31. and return the file's type as a :class:`str`, or ``None`` if it cannot
  32. be determined.
  33. :param path:
  34. A :class:`string <str>` path containing the content to inspect.
  35. ``~`` will be expanded.
  36. :param content:
  37. The :class:`bytes` content to inspect.
  38. :returns:
  39. A :class:`str`, or ``None`` if the format cannot be determined.
  40. The return value can always be looked up in :data:`FILE_FORMAT_DESCRIPTIONS`
  41. to return a human-readable description of the format found.
  42. 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)
  43. Open a spreadsheet file for data extraction.
  44. :param filename: The path to the spreadsheet file to be opened.
  45. :param logfile: An open file to which messages and diagnostics are written.
  46. :param verbosity: Increases the volume of trace material written to the
  47. logfile.
  48. :param use_mmap:
  49. Whether to use the mmap module is determined heuristically.
  50. Use this arg to override the result.
  51. Current heuristic: mmap is used if it exists.
  52. :param file_contents:
  53. A string or an :class:`mmap.mmap` object or some other behave-alike
  54. object. If ``file_contents`` is supplied, ``filename`` will not be used,
  55. except (possibly) in messages.
  56. :param encoding_override:
  57. Used to overcome missing or bad codepage information
  58. in older-version files. See :doc:`unicode`.
  59. :param formatting_info:
  60. The default is ``False``, which saves memory.
  61. In this case, "Blank" cells, which are those with their own formatting
  62. information but no data, are treated as empty by ignoring the file's
  63. ``BLANK`` and ``MULBLANK`` records.
  64. This cuts off any bottom or right "margin" of rows of empty or blank
  65. cells.
  66. Only :meth:`~xlrd.sheet.Sheet.cell_value` and
  67. :meth:`~xlrd.sheet.Sheet.cell_type` are available.
  68. When ``True``, formatting information will be read from the spreadsheet
  69. file. This provides all cells, including empty and blank cells.
  70. Formatting information is available for each cell.
  71. Note that this will raise a NotImplementedError when used with an
  72. xlsx file.
  73. :param on_demand:
  74. Governs whether sheets are all loaded initially or when demanded
  75. by the caller. See :doc:`on_demand`.
  76. :param ragged_rows:
  77. The default of ``False`` means all rows are padded out with empty cells so
  78. that all rows have the same size as found in
  79. :attr:`~xlrd.sheet.Sheet.ncols`.
  80. ``True`` means that there are no empty cells at the ends of rows.
  81. This can result in substantial memory savings if rows are of widely
  82. varying sizes. See also the :meth:`~xlrd.sheet.Sheet.row_len` method.
  83. :param ignore_workbook_corruption:
  84. This option allows to read corrupted workbooks.
  85. When ``False`` you may face CompDocError: Workbook corruption.
  86. When ``True`` that exception will be ignored.
  87. :returns: An instance of the :class:`~xlrd.book.Book` class.
  88. DATA
  89. FILE_FORMAT_DESCRIPTIONS = {'xls': 'Excel xls', 'xlsb': 'Excel 2007 xl...
  90. FMLA_TYPE_ARRAY = 4
  91. FMLA_TYPE_CELL = 1
  92. FMLA_TYPE_COND_FMT = 8
  93. FMLA_TYPE_DATA_VAL = 16
  94. FMLA_TYPE_NAME = 32
  95. FMLA_TYPE_SHARED = 2
  96. PEEK_SIZE = 8
  97. XLS_SIGNATURE = b'\xd0\xcf\x11\xe0\xa1\xb1\x1a\xe1'
  98. XL_CELL_BLANK = 6
  99. XL_CELL_BOOLEAN = 4
  100. XL_CELL_DATE = 3
  101. XL_CELL_EMPTY = 0
  102. XL_CELL_ERROR = 5
  103. XL_CELL_NUMBER = 2
  104. XL_CELL_TEXT = 1
  105. ZIP_SIGNATURE = b'PK\x03\x04'
  106. __VERSION__ = '2.0.1'
  107. biff_text_from_num = {0: '(not BIFF)', 20: '2.0', 21: '2.1', 30: '3', ...
  108. empty_cell = empty:''
  109. error_text_from_code = {0: '#NULL!', 7: '#DIV/0!', 15: '#VALUE!', 23: ...
  110. oBOOL = 3
  111. oERR = 4
  112. oNUM = 2
  113. oREF = -1
  114. oREL = -2
  115. oSTRG = 1
  116. oUNK = 0
  117. okind_dict = {-2: 'oREL', -1: 'oREF', 0: 'oUNK', 1: 'oSTRG', 2: 'oNUM'...
  118. VERSION
  119. 2.0.1
  120. FILE
  121. e:\python_workspace\pythonproject\lib\site-packages\xlrd\__init__.py
3、用法精讲
3-7、xlrd.dump函数
3-7-1、语法
xlrd.dump(filename, outfile=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>, unnumbered=False)
3-7-2、参数

3-7-2-1、filename(必须)指定了要转储的文件的路径,可以是绝对路径或相对路径。

3-7-2-2、outfile(必须)一个已经通过某种方式(如open()函数)打开的文件对象,转储函数将把内容写入到这个文件中。

3-7-2-3、unnumbered(可选)一个布尔值,用于控制是否在转储内容中包含偏移量信息。如果设置为True,则不包含偏移量,这可能在生成差异比较时有用,因为偏移量可能会使比较变得复杂或难以阅读;如果设置为False(或省略),则包含偏移量。

3-7-3、功能

         用于将Excel文件(或其他某种格式的文件)的内容以某种形式(可能是文本或二进制)转储到另一个文件中,以便进行进一步的分析、比较或存档。

3-7-4、返回值

        无

3-7-5、说明

3-7-5-1、由于xlrd.dump主要用于调试和诊断,因此在常规的数据处理或分析中可能不常用。

3-7-5-2、从xlrd版本2.0开始,它不再支持.xlsx文件,只支持.xls文件。如果需要处理.xlsx文件,可以考虑使用其他库,如openpyxl。

3-7-5-3、在使用xlrd.dump时,应该小心处理日志文件或标准输出的内容,因为它可能会包含大量的详细信息和数据。

3-7-6、用法
  1. # 7、xlrd.dump函数
  2. import xlrd
  3. import sys
  4. def dump(filename, outfile=sys.stdout, unnumbered=False):
  5. # 打开Excel文件
  6. workbook = xlrd.open_workbook(filename)
  7. # 遍历所有工作表
  8. for sheet_index, sheet_name in enumerate(workbook.sheet_names()):
  9. # 打印或写入工作表名称
  10. print(f"Sheet Name: {sheet_name}", file=outfile)
  11. # 获取工作表对象
  12. sheet = workbook.sheet_by_name(sheet_name)
  13. # 遍历行和列
  14. for row_index in range(sheet.nrows):
  15. row_values = sheet.row_values(row_index)
  16. # 如果unnumbered为 False,则打印或写入行号
  17. if not unnumbered:
  18. print(f"Row {row_index + 1}:", file=outfile, end='')
  19. # 打印或写入行内容
  20. for value in row_values:
  21. print(value, end='\t', file=outfile)
  22. print(file=outfile) # 换行
  23. if __name__ == '__main__':
  24. # 直接输出到控制台
  25. dump(r'E:\360Downloads\test.xls')
  26. # 输出到文件
  27. with open(r'E:\360Downloads\test_dump.txt', 'w', encoding='utf-8') as outfile:
  28. dump(r'E:\360Downloads\test.xls', outfile=outfile, unnumbered=True)
3-8、xlrd.count_records函数
3-8-1、语法
xlrd.count_records(filename, outfile=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>)
3-8-2、参数

3-8-2-1、filename(必须)指定了要转储的文件的路径,可以是绝对路径或相对路径。

3-8-2-2、outfile(可选)一个已经通过某种方式(如open()函数)打开的文件对象,转储函数将把内容写入到这个文件中。

3-8-3、功能

        计算一个 Excel 文件中所有工作表的总记录数(即所有单元格的数量)。

3-8-4、返回值

        返回文件中所有单元格的总数。

3-8-5、说明

        无

3-8-6、用法
  1. # 8、xlrd.count_records函数
  2. import xlrd
  3. def count_records(filename):
  4. # 打开Excel文件
  5. workbook = xlrd.open_workbook(filename)
  6. total_cells = 0
  7. # 遍历所有工作表
  8. for sheet in workbook.sheets():
  9. # 计算每个工作表的单元格数量
  10. nrows = sheet.nrows
  11. ncols = sheet.ncols
  12. total_cells += nrows * ncols
  13. # 返回所有单元格的总数
  14. return total_cells
  15. if __name__ == '__main__':
  16. total_cells_count = count_records(r'E:\360Downloads\test.xls')
  17. print(f"Total number of cells: {total_cells_count}")
3-9、xlrd.biffh.error_text_from_code字典
3-9-1、语法
xlrd.biffh.error_text_from_code= {0: '#NULL!', 7: '#DIV/0!', 15: '#VALUE!', 23: '#REF!', 29: '#NAME?', 36: '#NUM!', 42: '#N/A'}
3-9-2、参数

        无

3-9-3、功能

        用于根据Excel文件中的BIFF(Binary Interchange File Format)错误代码检索对应的错误文本。

3-9-4、返回值

        返回一个已知错误代码对应的字符串或Unknown error(不存在的错误代码情况)。

3-9-5、说明

        无

3-9-6、用法
  1. # 9、xlrd.biffh.error_text_from_code字典
  2. # 9-1、查看字典信息
  3. import xlrd
  4. print(xlrd.biffh.error_text_from_code)
  5. # 输出:{0: '#NULL!', 7: '#DIV/0!', 15: '#VALUE!', 23: '#REF!', 29: '#NAME?', 36: '#NUM!', 42: '#N/A'}
  6. # 9-2、应用示例
  7. # 假设的错误代码和对应的错误文本
  8. error_codes = {0: '#NULL!', 7: '#DIV/0!', 15: '#VALUE!', 23: '#REF!',
  9. 29: '#NAME?', 36: '#NUM!', 42: '#N/A'}
  10. # 创建一个函数,用于根据错误代码获取错误文本
  11. def error_text_from_code(code):
  12. return error_codes.get(code, "Unknown error")
  13. if __name__ == '__main__':
  14. code = 29 # 假设我们遇到了一个无效的文件格式错误
  15. print(error_text_from_code(code)) # 输出: #NAME?
  16. code = 888 # 一个不存在的错误代码
  17. print(error_text_from_code(code)) # 输出: Unknown error

五、推荐阅读

1、Python筑基之旅
2、Python函数之旅
3、Python算法之旅
4、Python魔法之旅
5、 博客个人主页
声明:本文内容由网友自发贡献,转载请注明出处:【wpsshop】
推荐阅读
相关标签
  

闽ICP备14008679号