ITaskImplementation.h

// -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
//-----------------------------------------------------------------------------
// Copyright 2000-2026 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
// See the top-level COPYRIGHT file for details.
// SPDX-License-Identifier: Apache-2.0
//-----------------------------------------------------------------------------
/*---------------------------------------------------------------------------*/
/* ITaskImplementation.h                                       (C) 2000-2025 */
/*                                                                           */
/* Task management interface.                                                */
/*---------------------------------------------------------------------------*/
#ifndef ARCCORE_BASE_ITASKIMPLEMENTATION_H
#define ARCCORE_BASE_ITASKIMPLEMENTATION_H
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#include "arccore/concurrency/ConcurrencyGlobal.h"
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arcane
{
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class ARCCORE_CONCURRENCY_EXPORT ITaskImplementation
{
 public:
 
  virtual ~ITaskImplementation() = default;
 
 public:

  virtual void initialize(Int32 nb_thread) = 0;
  virtual void terminate() = 0;
  virtual ITask* createRootTask(ITaskFunctor* f) = 0;

  virtual void executeParallelFor(Integer begin, Integer size, const ParallelLoopOptions& options, IRangeFunctor* f) = 0;

  virtual void executeParallelFor(Integer begin, Integer size, Integer block_size, IRangeFunctor* f) = 0;

  virtual void executeParallelFor(Integer begin, Integer size, IRangeFunctor* f) = 0;

  virtual void executeParallelFor(const ParallelFor1DLoopInfo& loop_info) = 0;

  virtual void executeParallelFor(const ComplexForLoopRanges<1>& loop_ranges,
                                  const ForLoopRunInfo& run_info,
                                  IMDRangeFunctor<1>* functor) = 0;
  virtual void executeParallelFor(const ComplexForLoopRanges<2>& loop_ranges,
                                  const ForLoopRunInfo& run_info,
                                  IMDRangeFunctor<2>* functor) = 0;
  virtual void executeParallelFor(const ComplexForLoopRanges<3>& loop_ranges,
                                  const ForLoopRunInfo& run_info,
                                  IMDRangeFunctor<3>* functor) = 0;
  virtual void executeParallelFor(const ComplexForLoopRanges<4>& loop_ranges,
                                  const ForLoopRunInfo& run_info,
                                  IMDRangeFunctor<4>* functor) = 0;

  virtual bool isActive() const = 0;

  ARCCORE_DEPRECATED_REASON("Y2025: use ConcurrencyBase::maxAllowedThread() instead")
  Int32 nbAllowedThread() const;

  virtual Int32 currentTaskThreadIndex() const = 0;

  virtual Int32 currentTaskIndex() const = 0;

  virtual void printInfos(std::ostream& o) const = 0;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // End namespace Arcane
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#endif