helios::async Namespace Reference

Namespaces
namespace	details

Classes
class	AsyncTask
	Handle to an asynchronous task managed by the Executor. More...
class	Executor
	Manages worker threads and executes task graphs using work-stealing scheduling. More...
class	Future
	Wrapper around tf::Future for handling asynchronous task results. More...
class	SubTaskGraph
	Dynamic task graph that can be created within the execution of a task. More...
class	Task
	Represents a single task within a task graph. More...
class	TaskGraph
	Represents a task dependency graph that can be executed by an Executor. More...

Concepts
concept	StaticTask
	Concept for static task callables.
concept	SubTask
	Concept for sub-task callables that receive a SubTaskGraph reference.
concept	AnyTask
	Concept for any valid task callable.

Typedefs
template<typename T = void>
using	AsyncResult = std::expected< T, AsyncError >
	Result type for async operations.

Enumerations
enum class	TaskType : uint8_t { Undefined , Static , SubTask , Async }
	Types of tasks in the async system. More...
enum class	AsyncError : uint8_t {   InvalidTask , ExecutorShutdown , TaskNotFound , InvalidDependency ,   CircularDependency , SchedulingFailed , ThreadNotAvailable }
	Error codes for async operations. More...

Functions
constexpr std::string_view	ToString (AsyncError error) noexcept
	Converts AsyncError to string representation.

Typedef Documentation

AsyncResult

template<typename T = void>

using helios::async::AsyncResult = typedef std::expected<T, AsyncError>

Result type for async operations.

Definition at line 68 of file common.hpp.

Enumeration Type Documentation

AsyncError

enum class helios::async::AsyncError : uint8_t

strong

Error codes for async operations.

Enumerator
InvalidTask	Task handle is invalid or empty.
ExecutorShutdown	Executor has been shut down.
TaskNotFound	Specified task could not be found.
InvalidDependency	Dependency relationship is invalid.
CircularDependency	Circular dependency detected in task graph.
SchedulingFailed	Task could not be scheduled for execution.
ThreadNotAvailable	No worker thread available for execution.

Definition at line 30 of file common.hpp.

                      : uint8_t {
  InvalidTask,         ///< Task handle is invalid or empty
  ExecutorShutdown,    ///< Executor has been shut down
  TaskNotFound,        ///< Specified task could not be found
  InvalidDependency,   ///< Dependency relationship is invalid
  CircularDependency,  ///< Circular dependency detected in task graph
  SchedulingFailed,    ///< Task could not be scheduled for execution
  ThreadNotAvailable   ///< No worker thread available for execution
};

TaskType

enum class helios::async::TaskType : uint8_t

strong

Types of tasks in the async system.

Enumerator
Undefined
Static	Static task with fixed callable.
SubTask	Dynamic task that can spawn subtasks.
Async	Asynchronous task executed independently.

Definition at line 20 of file common.hpp.

                    : uint8_t {
  Undefined,
  Static,   ///< Static task with fixed callable
  SubTask,  ///< Dynamic task that can spawn subtasks
  Async     ///< Asynchronous task executed independently
};

Function Documentation

ToString()

constexpr std::string_view helios::async::ToString ( AsyncError  error )

constexprnoexcept

Converts AsyncError to string representation.

Definition at line 43 of file common.hpp.

                                                                           {
  switch (error) {
    case AsyncError::InvalidTask:
      return "Invalid task";
    case AsyncError::ExecutorShutdown:
      return "Executor is shutdown";
    case AsyncError::TaskNotFound:
      return "Task not found";
    case AsyncError::InvalidDependency:
      return "Invalid dependency";
    case AsyncError::CircularDependency:
      return "Circular dependency detected";
    case AsyncError::SchedulingFailed:
      return "Task scheduling failed";
    case AsyncError::ThreadNotAvailable:
      return "Thread not available";
    default:
      return "Unknown async error";
  }
}