Release 3.11.0 (2025/11/24)

Table of Contents

• Release Summary
• Download
• System Requirements
• New Features
  • Taskflow Core
  • Utilities
• Bug Fixes
• Breaking Changes
• Documentation
• Miscellaneous Items

Release Summary

This release improves scheduling performance through optimized memory ordering in the notification algorithm and fixes a few bugs related to exception handling. We also revised multiple cookbook pages to enhance readability.

Download

Taskflow 3.11.0 can be downloaded here.

System Requirements

To use Taskflow v3.11.0, you need a compiler that supports C++17:

• GNU C++ Compiler at least v8.4 with -std=c++17
• Clang C++ Compiler at least v6.0 with -std=c++17
• Microsoft Visual Studio at least v19.27 with /std:c++17
• Apple Clang Xcode Version at least v12.0 with -std=c++17
• Nvidia CUDA Toolkit and Compiler (nvcc) at least v11.1 with -std=c++17
• Intel C++ Compiler at least v19.0.1 with -std=c++17
• Intel DPC++ Clang Compiler at least v13.0.0 with -std=c++17

Taskflow works on Linux, Windows, and Mac OS X.

Attention

Although Taskflow supports primarily C++17, you can enable C++20 compilation through -std=c++20 to achieve better performance due to new C++20 features. That being said, we are actively working on migrating Taskflow to C++20, which is planned for the next major release v4.

New Features

Taskflow Core

• added examples/task_visitor.cpp to demonstrate how to traverse a taskflow (#699)
• added five benchmarks to showcase the capability of tf::Runtime
  • fibonacci
  • skynet
  • integrate
  • nqueens
  • primes
• added methods to retrieve the exception pointer of a task
  • tf::Task::exception_ptr
  • tf::AsyncTask::exception_ptr
• added methods to check if a task holds an exception pointer
  • tf::Task::has_exception_ptr
  • tf::AsyncTask::has_exception_ptr
• added several new unit tests for exception handling (test_exception.cpp)
  • recursive exception propagation
  • concurrent exception throwing
• added dependent-async methods to tf::Runtime (#701)
  • tf::Runtime::dependent_async
  • tf::Runtime::silent_dependent_async
• removed code support for SYCL
• removed thread_local to avoid incorrect references caused by Windows DLL boundaries
• replaced TF_CACHELINE_SIZE with std::hardware_destructive_interference_size
• enhanced the performance of atomic notifier via relaxed memory order
• enforced implicit synchronization at the end of a runtime task's scope for safer usage

Utilities

• added coprime function
• added floor_log2 function

Bug Fixes

• toggled exception block in executor (#690)
• fixed missing exception on thread creation failure in executor (#693)
• fixed segmentation fault caused by empty async dependency (#700)
• fixed compilation errors for CUDA 13 (#721)
• fixed missing exception on recursive runtime tasking (#724)
• fixed memory leak in exception handling for async tasks (#730)

Breaking Changes

• removed tf::corun(graph) due to a design flaw in its exception-handling behavior

// previously
taskflow.emplace([&](tf::Runtime& rt){
  rt.corun(graph);
});
// now - simply use tf::Executor::corun
taskflow.emplace([&](tf::Runtime& rt){
  executor.corun(graph);
});

Documentation

• revised Static Tasking
• revised Executor
• revised Conditional Tasking
• revised Runtime Tasking
• revised Asynchronous Tasking
• revised Asynchronous Tasking with Dependencies
• revised Exception Handling
  • Retrieve the Exception Pointer of a Task
• revised Request Cancellation

Miscellaneous Items

• Taskflow won the best poster award from 2025 CppCon!

If you are interested in collaborating with us on applying Taskflow to your projects, please feel free to reach out to Dr. Tsung-Wei Huang!