Pyqt 所有的数据类型

PyQt 数据类型总结

PyQt 作为 Qt 框架的 Python 绑定，其数据类型体系既包含 Qt 原生的数据结构，也与 Python 原生类型存在映射关系。以下从基本类型、容器类型、特殊类型等维度进行全面总结：

一、基本数据类型

PyQt 的基本数据类型与 Qt 核心模块（QtCore）紧密相关，同时兼容 Python 原生类型。

PyQt 类型	对应 Python 类型	用途说明
int	int	整数类型，支持 32 位/64 位整数，与 Python int 完全兼容。
float	float	浮点数类型，对应 C++ 双精度浮点型，精度与 Python float 一致。
bool	bool	布尔值，True/False，与 Python 布尔类型等价。
QChar	str（单字符）	表示单个 Unicode 字符，可与 Python 字符串的单个字符相互转换。
QString	str	存储 Unicode 字符串，支持丰富的文本操作（如格式化、查找替换），可直接与 Python str 互转。
QByteArray	bytes	字节数组，用于二进制数据存储（如网络传输、文件读写），对应 Python bytes 类型。

二、容器数据类型

PyQt 提供了类似 Python 容器的类型，支持高效的数据存储和操作。

• 序列容器

  • QList<T>：泛型列表，支持快速插入和删除，类似 Python list，可存储任意 Qt 类型。
    • 示例：QList[int]、QList[str]（通过 QString 存储字符串）。
  • QLinkedList<T>：链表结构，适用于频繁插入/删除场景，性能优于 QList。
  • QVector<T>：动态数组，支持随机访问，内存连续，类似 Python list 但更接近 C++ 数组。

• 映射容器

  • QMap<Key, Value>：键值对映射，按键排序，查找效率高，类似 Python dict。
  • QHash<Key, Value>：哈希表实现，查找时间复杂度 O(1)，不保证顺序，性能优于 QMap。

• 集合容器

  • QSet<T>：无序集合，元素唯一，基于哈希表实现，支持快速查找和去重。

三、日期与时间类型

处理时间和日期的专用类型，位于 QtCore 模块。

• QDate：仅包含日期（年、月、日），支持日历计算和格式化。
• QTime：仅包含时间（时、分、秒、毫秒），用于计时和时间间隔测量。
• QDateTime：结合日期和时间，支持时区转换和复杂时间计算。
• QTimeZone：表示时区，用于处理跨时区的日期时间转换。
• QTimer：定时器类，虽非数据类型，但常用于时间相关操作（如定时触发事件）。

四、几何与图形类型

用于界面布局和图形绘制的基础类型，位于 QtCore 和 QtGui 模块。

• 坐标与尺寸

  • QPoint：二维坐标点（x, y），支持整数和浮点数版本（QPointF）。
  • QSize：宽高尺寸（width, height），同样分为整数（QSize）和浮点（QSizeF）版本。
  • QRect：矩形区域（左上角坐标 + 尺寸），浮点版本为 QRectF。

• 图形元素

  • QColor：颜色表示（RGB、HSV 等模式），支持透明度（Alpha 通道）。
  • QFont：字体定义（字族、大小、样式等），用于文本渲染。
  • QPen：线条属性（颜色、宽度、样式），用于绘制图形边框。
  • QBrush：填充样式（颜色、渐变、图案），用于填充图形区域。

五、特殊数据类型

PyQt 中具有特定用途的高级类型，解决复杂场景需求。

• QVariant：通用数据容器，可存储任意 Qt 支持的类型（包括自定义对象），类似 Python 的 object。
  • 用途：在 Qt 的信号与槽机制中传递不同类型的数据，或在模型-视图架构中存储多变的数据。
• QUrl：统一资源定位符，用于处理网络地址和文件路径，支持 URL 编码/解码。
• QByteArrayList：字节数组列表，用于存储多个二进制数据块，常用于网络协议解析。
• QSignalMapper：信号映射器，将信号参数转换为其他类型，实现信号的灵活转发。
• QMetaType：元数据类型，用于获取类型信息、注册自定义类型到 Qt 系统。

六、Python 与 Qt 类型的转换

PyQt 支持 Qt 类型与 Python 原生类型的自动转换，但需注意以下规则：

1. 输入转换（Python → Qt）

   • str → QString（自动转换，无需显式处理）。
   • list/tuple → QList（元素需为 Qt 支持的类型）。
   • dict → QMap 或 QHash（键值需为 Qt 类型）。

2. 输出转换（Qt → Python）

   • QString → str（通过 toString() 方法或直接赋值）。
   • QList<T> → Python list（元素自动转换为对应 Python 类型）。
   • QVariant → Python 类型（通过 toPython() 方法获取原生对象）。

3. 自定义类型转换

   • 若需传递自定义类实例，需通过 QMetaType.registerType() 注册类型，确保信号槽机制支持其传递。

七、常用模块与类型对应关系

模块	包含的核心数据类型
QtCore	QDate, QTime, QDateTime, QVariant, QList, QMap, QPoint, QRect 等。
QtGui	QColor, QFont, QPen, QBrush, QPixmap, QImage 等图形相关类型。
QtWidgets	主要包含界面组件类，数据类型多依赖 QtCore 和 QtGui。
QtNetwork	QUrl, QNetworkRequest, QNetworkReply 等网络相关类型。
QtMultimedia	多媒体数据类型（如 QAudioFormat, QVideoFrame）。

八、注意事项

1. 性能优化：

   • 对大量数据操作时，QVector 和 QHash 比 Python 原生列表/字典效率更高。
   • 避免频繁在 Qt 类型与 Python 类型间转换，尤其是循环场景。

2. 类型安全：

   • 在信号槽连接中，确保参数类型匹配，否则可能导致程序崩溃或异常。
   • 使用 QVariant 时，建议通过 type() 或 canConvert() 检查类型兼容性。

3. 字符串处理：

   • PyQt5 及以上版本中，QString 与 Python str 可无缝转换，但需注意 Unicode 编码一致性。

通过以上分类总结，可全面掌握 PyQt 数据类型的体系结构及应用场景，在开发中根据需求选择合适的类型以提升代码效率和可靠性。