- Main Page
- Modules
- Namespaces
- Classes
- Files
- Related Pages

- Class List
- Class Hierarchy
- Class Members

# tbb::task_scheduler_init Class Reference
[Task Scheduling]

Class representing reference to tbb scheduler. More...

`#include <task_scheduler_init.h>`

List of all members.

## Public Member Functions
void __TBB_EXPORTED_METHOD | initialize (int number_of_threads=automatic)
| Ensure that scheduler exists for this thread.
void __TBB_EXPORTED_METHOD | initialize (int number_of_threads, stack_size_type thread_stack_size)
| The overloaded method with stack size parameter.
void __TBB_EXPORTED_METHOD | terminate ()
| Inverse of method initialize.
| task_scheduler_init (int number_of_threads=automatic, stack_size_type thread_stack_size=0)
| Shorthand for default constructor followed by call to intialize(number_of_threads).
| ~task_scheduler_init ()
| Destroy scheduler for this thread if thread has no other live task_scheduler_inits.
bool | is_active () const
| Returns true if scheduler is active (initialized); false otherwise.
## Static Public Member Functions
static int __TBB_EXPORTED_FUNC | default_num_threads ()
| Returns the number of threads TBB scheduler would create if initialized by default.
## Static Public Attributes
static const int | automatic = -1
| Typedef for number of threads that is automatic.
static const int | deferred = -2
| Argument to initialize() or constructor that causes initialization to be deferred.

## Detailed Description

Class representing reference to tbb scheduler.

A thread must construct a task_scheduler_init, and keep it alive, during the time that it uses the services of class task.

## Member Function Documentation

static int __TBB_EXPORTED_FUNC tbb::task_scheduler_init::default_num_threads | ( |  | ) | `[static]`

Returns the number of threads TBB scheduler would create if initialized by default.

Result returned by this method does not depend on whether the scheduler has already been initialized.

Because tbb 2.0 does not support blocking tasks yet, you may use this method to boost the number of threads in the tbb's internal pool, if your tasks are doing I/O operations. The optimal number of additional threads depends on how much time your tasks spend in the blocked state.

Before TBB 3.0 U4 this method returned the number of logical CPU in the system. Currently on Windows, Linux and FreeBSD it returns the number of logical CPUs available to the current process in accordance with its affinity mask.

NOTE: The return value of this method never changes after its first invocation. This means that changes in the process affinity mask that took place after this method was first invoked will not affect the number of worker threads in the TBB worker threads pool.

void __TBB_EXPORTED_METHOD tbb::task_scheduler_init::initialize | ( | int | number_of_threads,
|  | stack_size_type | thread_stack_size |
| ) |  |  |

The overloaded method with stack size parameter.

Overloading is necessary to preserve ABI compatibility

void __TBB_EXPORTED_METHOD tbb::task_scheduler_init::initialize | ( | int | number_of_threads = `automatic` | ) |

Ensure that scheduler exists for this thread.

A value of -1 lets tbb decide on the number of threads, which is typically the number of hardware threads. For production code, the default value of -1 should be used, particularly if the client code is mixed with third party clients that might also use tbb.

The number_of_threads is ignored if any other task_scheduler_inits currently exist. A thread may construct multiple task_scheduler_inits. Doing so does no harm because the underlying scheduler is reference counted.

The documentation for this class was generated from the following file:

- task_scheduler_init.h

Copyright © 2005-2010 Intel Corporation. All Rights Reserved.

Intel, Pentium, Intel Xeon, Itanium, Intel XScale and VTune are registered trademarks or trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

* Other names and brands may be claimed as the property of others.