newFixedThreadPoolContext

Creates a coroutine execution context with the fixed-size thread-pool and built-in yield support. NOTE: The resulting CoroutineDispatcher owns native resources (its threads). Resources are reclaimed by CloseableCoroutineDispatcher.close.

If the resulting dispatcher is closed and attempt to submit a continuation task is made,

  • On the JVM, the Job of the affected task is cancelled and the task is submitted to the Dispatchers.IO, so that the affected coroutine can clean up its resources and promptly complete.

  • On Native, the attempt to submit a task throws an exception.

This is a delicate API. The result of this method is a closeable resource with the associated native resources (threads or native workers). It should not be allocated in place, should be closed at the end of its lifecycle, and has non-trivial memory and CPU footprint. If you do not need a separate thread pool, but only have to limit effective parallelism of the dispatcher, it is recommended to use Dispatchers.IO.limitedParallelism(nThreads) or Dispatchers.Default.limitedParallelism(nThreads) instead.

If you need a completely separate thread pool with scheduling policy that is based on the standard JDK executors, use the following expression: Executors.newFixedThreadPool().asCoroutineDispatcher(). See Executor.asCoroutineDispatcher for details.

Parameters

nThreads

the number of threads.

name

the base name of the created threads.