ITimeHistoryCurveWriter2.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
//-----------------------------------------------------------------------------
/*---------------------------------------------------------------------------*/
/* ITimeHistoryCurveWriter2.h                                  (C) 2000-2025 */
/*                                                                           */
/* Interface for a history curve writer (Version 2).                         */
/*---------------------------------------------------------------------------*/
#ifndef ARCANE_CORE_ITIMEHISTORYCURVEWRITER2_H
#define ARCANE_CORE_ITIMEHISTORYCURVEWRITER2_H
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#include "arcane/utils/UtilsTypes.h"
#include "arcane/utils/ArrayView.h"
#include "arcane/utils/String.h"
 
/*
 * \brief Indicates whether private member access is allowed.
 * By default (March 2016), access is kept for compatibility reasons,
 * but it will need to be removed.
 */
#define ARCANE_ALLOW_CURVE_WRITER_PRIVATE_ACCESS 1
#ifdef SWIG
#undef ARCANE_ALLOW_CURVE_WRITER_PRIVATE_ACCESS
#endif
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arcane
{
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class TimeHistoryCurveInfo
{
 public:
 
  TimeHistoryCurveInfo(const String& aname, Int32ConstArrayView aiterations,
                       RealConstArrayView avalues, Integer sub_size)
  : m_name(aname)
  , m_support()
  , m_has_support(false)
  , m_iterations(aiterations)
  , m_values(avalues)
  , m_sub_size(sub_size)
  , m_sub_domain(-1)
  {}
 
  TimeHistoryCurveInfo(const String& aname, Int32ConstArrayView aiterations,
                       RealConstArrayView avalues, Integer sub_size, Integer sub_domain)
  : m_name(aname)
  , m_support()
  , m_has_support(false)
  , m_iterations(aiterations)
  , m_values(avalues)
  , m_sub_size(sub_size)
  , m_sub_domain(sub_domain)
  {}
 
  TimeHistoryCurveInfo(const String& aname, const String& asupport, Int32ConstArrayView aiterations,
                       RealConstArrayView avalues, Integer sub_size)
  : m_name(aname)
  , m_support(asupport)
  , m_has_support(true)
  , m_iterations(aiterations)
  , m_values(avalues)
  , m_sub_size(sub_size)
  , m_sub_domain(-1)
  {}
 
  TimeHistoryCurveInfo(const String& aname, const String& asupport, Int32ConstArrayView aiterations,
                       RealConstArrayView avalues, Integer sub_size, Integer sub_domain)
  : m_name(aname)
  , m_support(asupport)
  , m_has_support(true)
  , m_iterations(aiterations)
  , m_values(avalues)
  , m_sub_size(sub_size)
  , m_sub_domain(sub_domain)
  {}
 
 public:

  const String& name() const { return m_name; }
  const String& support() const { return m_support; }
  bool hasSupport() const { return m_has_support; }
  Int32ConstArrayView iterations() const { return m_iterations; }
  RealConstArrayView values() const { return m_values; }
  Integer subSize() const { return m_sub_size; }
  // TODO not a great name
  Integer subDomain() const { return m_sub_domain; }
 
#if ARCANE_ALLOW_CURVE_WRITER_PRIVATE_ACCESS
 public:
 
#else
 private:
#endif
  String m_name;
  String m_support;
  bool m_has_support = false;
  Int32ConstArrayView m_iterations;
  RealConstArrayView m_values;
  Integer m_sub_size = 0;
  Integer m_sub_domain = 0;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class TimeHistoryCurveWriterInfo
{
 public:
 
  TimeHistoryCurveWriterInfo(const String& apath, RealConstArrayView atimes)
  : m_path(apath)
  , m_times(atimes)
  {}
 
 public:

  String path() const { return m_path; }
  RealConstArrayView times() const { return m_times; }
 
#if ARCANE_ALLOW_CURVE_WRITER_PRIVATE_ACCESS
 public:
 
#else
 private:
#endif
  String m_path;
  RealConstArrayView m_times;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class ARCANE_CORE_EXPORT ITimeHistoryCurveWriter2
{
 public:

  virtual ~ITimeHistoryCurveWriter2() = default;
 
 public:
 
  virtual void build() = 0;

  virtual void beginWrite(const TimeHistoryCurveWriterInfo& infos) = 0;

  virtual void endWrite() = 0;

  virtual void writeCurve(const TimeHistoryCurveInfo& infos) = 0;

  virtual String name() const = 0;

  virtual void setOutputPath(const String& path) = 0;

  virtual String outputPath() const = 0;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // namespace Arcane
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#endif