qt线程类---QThread

来源：互联网发布：zookeeper源码编辑：程序博客网时间：2024/04/30 12:34

http://no001.blog.51cto.com/1142339/276984QThread Class Reference[QtCore module]该类提供平台独立的线程。#include 继承QObject公共类型enum Priority { IdlePriority, LowestPriority, LowPriority, NormalPriority, ..., InheritPriority }公共函数QThread ( QObject * parent = 0 ) ~QThread ()void exit ( int returnCode = 0 )bool isFinished () constbool isRunning () constPriority priority () constvoid setPriority ( Priority priority )void setStackSize ( uintstackSize )uint stackSize () constbool wait ( unsigned long time = ULONG_MAX )公共槽void quit ()void start ( Priority priority = InheritPriority )void terminate ()信号void finished ()void started ()void terminated ()静态公共成员QThread * currentThread ()Qt::HANDLE currentThreadId ()int idealThreadCount ()void yieldCurrentThread ()受保护的函数int exec ()virtual void run ()静态受保护的成员void msleep ( unsigned long msecs )void setTerminationEnabled ( bool enabled = true )void sleep ( unsigned long secs )void usleep ( unsigned long usecs )详细描述一个QThread代表一个独立的线程控制在程序中。它分享数据和所有其他的线程，但是独立运行在一个多任务的操作系统中。代替开始在main中，QThread开始在run。默认的，run开始时间循环，通过调用exec。为了创建你自己的线程，建QThread的子类，并继承run。例如：class MyThread : public QThread { public: void run(); }; void MyThread::run() { QTcpSocket socket; // connect QTcpSocket's signals somewhere meaningful ... socket.connectToHost(hostName, portNumber); exec(); }这将创建一个QTcpSocket在这个线程中，运行线程的时间循环。使用start方法来开始运行。当你返回从run，运行结束，就像一个应用那样当你离开main。QThread将注意你发出一个信号，当线程started，finished，terminated，或者你能用 isFinished和isRunning来查询线程的状态，使用wait来阻塞，直到线程已经完成运行。每个线程得到他自己的堆栈从操作系统中。操作系统也决定堆栈的默认大小。你能使用setStackSize来设置一个惯例的堆栈大小。每个QThread能有他自己的事件循环。你能开始事件循环通过调用exec。你能停止它通过调用exit或quit。拥有一个事件循环使信号和槽的链接成为可能。使用一个机制叫做队列链接。它也使使用那些要求事件循环的类成为可能，例如QTimer和QTcpSocket。注意，尽管如此，那是不可能的使用任何widget的类。在极端情况下，你可能想强制terminate一个线程。尽管如此，那样做是危险地和应该被阻止的。请读文件为terminate和setTerminationEnabled。静态函数currentThreadId和currentThread返回目前运行的线程的标示符。QThread也提供平台独立的sleep函数。使用sleep，msleep，usleep。成员类型文件enum QThread::Priorityenum 类型代表操作系统怎样安排新产生的线程。内容值描述QThread::IdlePriority 0 安排只是当没有其他线程在运行QThread::LowestPriority 1 安排少于低优先级QThread::LowPriority 2 安排少于正常优先级QThread::NormalPriority 3 默认的操作系统优先级QThread::HighPriority 4 安排高于正常优先级QThread::HighestPriority 5 安排高于高优先级QThread::TimeCriticalPriority 6 尽可能的安排QThread::InheritPriority 7 使用同样的优先级，这是默认的成员函数文件QThread::QThread(QObject* parent=0)构造一个新的线程用被给的parent。这个线程不开始运行直到start被调用QThread::~QThread ()摧毁线程注意删除一个线程对象将不停止运行线程。删除一个运行的QThread将可能导致一个程序冲突。你能wait来确保它完成。QThread * QThread::currentThread () [static]返回一个代表目前运行的线程的指针。Qt::HANDLE QThread::currentThreadId () [static]返回线程句柄。警告：该函数返回的句柄是被使用为了内部目的，不应该被用于任何应用的代码。在 windows，返回值是一个假句柄。它不能被使用为数值比较。这个函数返回DWORD返回被win32函数getCurrentThreadId，不是被getCurrentThread返回的handle。int QThread::exec () [protected]进入事件循环，等直到exit被调用。如果通过quit调用exit，返回值将是0。那是必须的调用这个函数来开始事件循环。void QThread::exit ( int returnCode = 0 )告诉线程的事件循环来退出在调用这个函数后，线程离开事件循环，返回从 QEventLoop：：exec（）。并且返回返回码。根据协定，返回0代表成功，非0代表失败注意不像c函数，这个函数返回 caller—it is event processing thar stops.如果没有一个事件循环，这个函数不做任何事情。void QThread::finished () [signal]这个信号被发出当线程结束运行。int QThread::idealThreadCount () [static]返回能被运行在系统上的理想的线程数。bool QThread::isFinished () const返回true如果线程是完成的。bool QThread::isRunning () constvoid QThread::msleep ( unsigned long msecs ) [static protected]Priority QThread::priority () const返回一个线程的优先级，如果函数不运行，返回inheritPriorityvoid QThread::quit () [slot]等同于exit(0).void QThread::run () [virtual protected]线程的开始点。在调用start后，新的线程调用这个函数，默认的继承调用exec。你能重载这个函数来做其他有用的工作。void QThread::setPriority ( Priority priority )设置优先级void QThread::setStackSize ( uint stackSize )设置最大的堆栈大小为线程。警告：大部分操作系统预设最大和最小限制在线程堆栈大小上。这个线程将失败开始，如果堆栈是不在这个限制范围内void QThread::setTerminationEnabled ( bool enabled = true ) [static protected]设置terminate（）函数的有效性。void QThread::sleep ( unsigned long secs ) [static protected]uint QThread::stackSize () constvoid QThread::start ( Priority priority = InheritPriority ) [slot]开始运行程序通过调用run。void QThread::started () [signal]当线程开始，发出该信号。void QThread::terminate () [slot]终止运行的线程。这个线程可能马上终止，也可能延时终止。在terminate后使用wait 同步终止。警告：这个函数是危险地，不被鼓励使用。void QThread::terminated () [signal]void QThread::usleep ( unsigned long usecs ) [static protected]bool QThread::wait ( unsigned long time = ULONG_MAX )阻塞线程直到这些情况被遇到线程结束运行。Time已经过去。（超时）void QThread::yieldCurrentThread () [static]让开线程给另一个可运行的线程。注意这由操作系统决定