CollectionsGlobal.h

// -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
//-----------------------------------------------------------------------------
// Copyright 2000-2025 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
// See the top-level COPYRIGHT file for details.
// SPDX-License-Identifier: Apache-2.0
//-----------------------------------------------------------------------------
/*---------------------------------------------------------------------------*/
/* CollectionsGlobal.h                                         (C) 2000-2025 */
/*                                                                           */
/* Définitions globales de la composante 'Collections' de 'Arccore'.         */
/*---------------------------------------------------------------------------*/
#ifndef ARCCORE_COLLECTIONS_COLLECTIONSGLOBAL_H
#define ARCCORE_COLLECTIONS_COLLECTIONSGLOBAL_H
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#include "arccore/base/ArccoreGlobal.h"
 
#include <iosfwd>
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#if defined(ARCCORE_COMPONENT_arccore_collections)
#define ARCCORE_COLLECTIONS_EXPORT ARCCORE_EXPORT
#define ARCCORE_COLLECTIONS_EXTERN_TPL
#else
#define ARCCORE_COLLECTIONS_EXPORT ARCCORE_IMPORT
#define ARCCORE_COLLECTIONS_EXTERN_TPL extern
#endif
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
// Pour l'instant on doit laisser ArrayTraits dans le namespace Arccore
// pour des raisons de compatibilité avec la macro ARCCORE_DEFINE_ARRAY_PODTYPE
namespace Arccore
{
template <typename DataType> class ArrayTraits;
}
 
namespace Arcane
{
class IMemoryAllocator;
class PrintableMemoryAllocator;
class AlignedMemoryAllocator;
class DefaultMemoryAllocator;
class ArrayImplBase;
class ArrayMetaData;
class MemoryAllocationArgs;
class MemoryAllocationOptions;
class ArrayDebugInfo;
template <typename DataType> class ArrayImplT;
template <typename DataType> class Array;
template <typename DataType> class AbstractArray;
template <typename DataType> class UniqueArray;
template <typename DataType> class SharedArray;
template <typename DataType> class Array2;
template <typename DataType> class UniqueArray2;
template <typename DataType> class SharedArray2;
using Arccore::ArrayTraits;
 
// Les trois types suivants sont conservés pour compatibilité avec l'existant.
// Il faudra les rendre optionnels mi-2025 et les supprimer en 2026
using IMemoryAllocator3 = IMemoryAllocator;
using AlignedMemoryAllocator3 = AlignedMemoryAllocator;
using DefaultMemoryAllocator3 = DefaultMemoryAllocator;
} // namespace Arcane
 
namespace Arcane::Accelerator
{
class RunQueue;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arcane
{
using Arcane::Accelerator::RunQueue;
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

enum class eMemoryLocationHint : int8_t
{
  None = 0,
  MainlyDevice = 1,
  MainlyHost = 2,
  HostAndDeviceMostlyRead = 3
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
enum class eHostDeviceMemoryLocation : int8_t
{
  Unknown = 0,
  Device = 1,
  Host = 2,
  ManagedMemoryDevice = 3,
  ManagedMemoryHost = 4,
};
extern "C++" ARCCORE_COLLECTIONS_EXPORT std::ostream&
operator<<(std::ostream& o, eHostDeviceMemoryLocation r);
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

enum class eMemoryResource
{
  Unknown = 0,
  Host,
  HostPinned,
  Device,
  UnifiedMemory
};

static constexpr int ARCCORE_NB_MEMORY_RESOURCE = 5;

// TODO: A rendre obsolète (juin 2025)
using eMemoryRessource = Arcane::eMemoryResource;
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
extern "C++" ARCCORE_COLLECTIONS_EXPORT std::ostream&
operator<<(std::ostream& o, eMemoryResource r);
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
class AllocatedMemoryInfo
{
 public:
 
  AllocatedMemoryInfo() = default;
  explicit AllocatedMemoryInfo(void* base_address)
  : m_base_address(base_address)
  {}
  AllocatedMemoryInfo(void* base_address, Int64 size)
  : m_base_address(base_address)
  , m_size(size)
  , m_capacity(size)
  {}
  AllocatedMemoryInfo(void* base_address, Int64 size, Int64 capacity)
  : m_base_address(base_address)
  , m_size(size)
  , m_capacity(capacity)
  {}

  void* baseAddress() const { return m_base_address; }
  Int64 size() const { return m_size; }
  Int64 capacity() const { return m_capacity; }
 
 public:
 
  void* m_base_address = nullptr;
  Int64 m_size = -1;
  Int64 m_capacity = -1;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // namespace Arcane
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arccore
{
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
using Arcane::AbstractArray;
using Arcane::AlignedMemoryAllocator;
using Arcane::AlignedMemoryAllocator3;
using Arcane::AllocatedMemoryInfo;
using Arcane::ARCCORE_NB_MEMORY_RESOURCE;
using Arcane::Array;
using Arcane::Array2;
using Arcane::ArrayMetaData;
using Arcane::DefaultMemoryAllocator;
using Arcane::DefaultMemoryAllocator3;
using Arcane::eHostDeviceMemoryLocation;
using Arcane::eMemoryLocationHint;
using Arcane::eMemoryResource;
using Arcane::IMemoryAllocator;
using Arcane::IMemoryAllocator3;
using Arcane::MemoryAllocationArgs;
using Arcane::MemoryAllocationOptions;
using Arcane::PrintableMemoryAllocator;
using Arcane::SharedArray;
using Arcane::SharedArray2;
using Arcane::UniqueArray;
using Arcane::UniqueArray2;

// TODO: A rendre obsolète (juin 2025)
using eMemoryRessource = Arcane::eMemoryResource;
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // namespace Arccore
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#endif