File indexing completed on 2024-04-28 15:54:00
0001 #!/usr/bin/env python2.7 0002 # -*- coding: utf-8 -*- 0003 """:synopsis: Create multiple threads of control within one interpreter. 0004 0005 """ 0006 """ 0007 This is the type of lock objects. 0008 0009 0010 """ 0011 LockType = None 0012 def start_new_thread(function,args,kwargs): 0013 """ 0014 Start a new thread and return its identifier. The thread executes the function 0015 *function* with the argument list *args* (which must be a tuple). The optional 0016 *kwargs* argument specifies a dictionary of keyword arguments. When the function 0017 returns, the thread silently exits. When the function terminates with an 0018 unhandled exception, a stack trace is printed and then the thread exits (but 0019 other threads continue to run). 0020 0021 0022 """ 0023 pass 0024 0025 def interrupt_main(): 0026 """ 0027 Raise a :exc:`KeyboardInterrupt` exception in the main thread. A subthread can 0028 use this function to interrupt the main thread. 0029 0030 """ 0031 pass 0032 0033 def exit(): 0034 """ 0035 Raise the :exc:`SystemExit` exception. When not caught, this will cause the 0036 thread to exit silently. 0037 0038 .. 0039 function:: exit_prog(status) 0040 0041 Exit all threads and report the value of the integer argument 0042 *status* as the exit status of the entire program. 0043 **Caveat:** code in pending :keyword:`finally` clauses, in this thread 0044 or in other threads, is not executed. 0045 0046 0047 """ 0048 pass 0049 0050 def allocate_lock(): 0051 """ 0052 Return a new lock object. Methods of locks are described below. The lock is 0053 initially unlocked. 0054 0055 0056 """ 0057 pass 0058 0059 def get_ident(): 0060 """ 0061 Return the 'thread identifier' of the current thread. This is a nonzero 0062 integer. Its value has no direct meaning; it is intended as a magic cookie to 0063 be used e.g. to index a dictionary of thread-specific data. Thread identifiers 0064 may be recycled when a thread exits and another thread is created. 0065 0066 0067 """ 0068 pass 0069 0070 def stack_size(size): 0071 """ 0072 Return the thread stack size used when creating new threads. The optional 0073 *size* argument specifies the stack size to be used for subsequently created 0074 threads, and must be 0 (use platform or configured default) or a positive 0075 integer value of at least 32,768 (32kB). If changing the thread stack size is 0076 unsupported, the :exc:`error` exception is raised. If the specified stack size is 0077 invalid, a :exc:`ValueError` is raised and the stack size is unmodified. 32kB 0078 is currently the minimum supported stack size value to guarantee sufficient 0079 stack space for the interpreter itself. Note that some platforms may have 0080 particular restrictions on values for the stack size, such as requiring a 0081 minimum stack size > 32kB or requiring allocation in multiples of the system 0082 memory page size - platform documentation should be referred to for more 0083 information (4kB pages are common; using multiples of 4096 for the stack size is 0084 the suggested approach in the absence of more specific information). 0085 Availability: Windows, systems with POSIX threads. 0086 0087 """ 0088 pass 0089