Tableau d'items de types quelconques. Plus de détails...

#include <arcane/core/anyitem/AnyItemArray.h>

Graphe d'héritage de Arccore::Array< DataType >:

Graphe de collaboration de Arccore::Array< DataType >:

Types publics
typedef AbstractArray< T >	BaseClassType

typedef ArrayTraits< T >::ConstReferenceType	ConstReferenceType

typedef T	value_type
	Type des éléments du tableau.

typedef ArrayIterator< pointer >	iterator
	Type de l'itérateur sur un élément du tableau.

typedef ArrayIterator< const_pointer >	const_iterator
	Type de l'itérateur constant sur un élément du tableau.

typedef std::reverse_iterator< iterator >	reverse_iterator

typedef std::reverse_iterator< const_iterator >	const_reverse_iterator

typedef value_type *	pointer
	Type pointeur d'un élément du tableau.

typedef const value_type *	const_pointer
	Type pointeur constant d'un élément du tableau.

typedef value_type &	reference
	Type référence d'un élément du tableau.

typedef ConstReferenceType	const_reference
	Type référence constante d'un élément du tableau.

typedef Int64	size_type
	Type indexant le tableau.

typedef ptrdiff_t	difference_type
	Type d'une distance entre itérateur éléments du tableau.

Types publics hérités de Arcane::AbstractArray< T >
typedef ArrayTraits< T >::ConstReferenceType	ConstReferenceType

typedef ArrayTraits< T >::IsPODType	IsPODType

typedef AbstractArray< T >	ThatClassType

using	TrueImpl = T

typedef T	value_type
	Type des éléments du tableau.

typedef value_type *	pointer
	Type pointeur d'un élément du tableau.

typedef const value_type *	const_pointer
	Type pointeur constant d'un élément du tableau.

typedef ArrayIterator< pointer >	iterator
	Type de l'itérateur sur un élément du tableau.

typedef ArrayIterator< const_pointer >	const_iterator
	Type de l'itérateur constant sur un élément du tableau.

typedef value_type &	reference
	Type référence d'un élément du tableau.

typedef ConstReferenceType	const_reference
	Type référence constante d'un élément du tableau.

typedef Int64	size_type
	Type indexant le tableau.

typedef ptrdiff_t	difference_type
	Type d'une distance entre itérateur éléments du tableau.

typedef std::reverse_iterator< iterator >	reverse_iterator

typedef std::reverse_iterator< const_iterator >	const_reverse_iterator

Fonctions membres publiques
	Array (const Group &group)

void	fill (const DataType &data)
	Remplissage du tableau.

void	fill (ConstReferenceType value)
	Remplit le tableau avec la valeur value.

template<typename T>
DataType &	operator[] (const T &item)
	Accesseur.

template<typename T>
Arcane::UniqueArray< DataType >::ConstReferenceType	operator[] (const T &item) const

ConstReferenceType	operator[] (Int64 i) const
	Elément d'indice i.

T &	operator[] (Int64 i)
	Elément d'indice i.

	operator ConstArrayView< T > () const

	operator ArrayView< T > ()

	operator Span< const T > () const

	operator Span< T > ()

ConstArrayView< T >	constView () const
	Vue constante sur ce tableau.

Span< const T >	constSpan () const
	Vue constante sur ce tableau.

ConstArrayView< T >	subConstView (Int64 abegin, Int32 asize) const
	Sous-vue à partir de l'élément abegin et contenant asize éléments.

ArrayView< T >	view () const
	Vue mutable sur ce tableau.

Span< const T >	span () const
	Vue immutable sur ce tableau.

Span< T >	span ()
	Vue mutable sur ce tableau.

SmallSpan< const T >	smallSpan () const
	Vue immutable sur ce tableau.

SmallSpan< T >	smallSpan ()
	Vue mutable sur ce tableau.

SmallSpan< const T >	constSmallSpan () const
	Vue immutable sur ce tableau.

ArrayView< T >	subView (Int64 abegin, Integer asize)
	Sous-vue à partir de l'élément abegin et contenant asize éléments.

void	sample (ConstArrayView< Integer > indexes, ArrayView< T > result) const
	Extrait un sous-tableau à à partir d'une liste d'index.

void	add (ConstReferenceType val)
	Ajoute l'élément val à la fin du tableau.

void	addRange (ConstReferenceType val, Int64 n)
	Ajoute n élément de valeur val à la fin du tableau.

void	addRange (ConstArrayView< T > val)
	Ajoute n élément de valeur val à la fin du tableau.

void	addRange (Span< const T > val)
	Ajoute n élément de valeur val à la fin du tableau.

void	addRange (ArrayView< T > val)
	Ajoute n élément de valeur val à la fin du tableau.

void	addRange (Span< T > val)
	Ajoute n élément de valeur val à la fin du tableau.

void	addRange (const Array< T > &val)
	Ajoute n élément de valeur val à la fin du tableau.

void	resize (Int64 s)
	Change le nombre d'éléments du tableau à s.

void	resize (Int64 s, ConstReferenceType fill_value)
	Change le nombre d'éléments du tableau à s.

void	resizeNoInit (Int64 s)
	Redimensionne sans initialiser les nouvelles valeurs.

void	reserve (Int64 new_capacity)
	Réserve le mémoire pour new_capacity éléments.

void	shrink ()
	Réalloue pour libérer la mémoire non utilisée.

void	shrink (Int64 new_capacity)
	Réalloue la mémoire avoir une capacité proche de new_capacity.

void	shrink_to_fit ()
	Réalloue pour libérer la mémoire non utilisée.

void	remove (Int64 index)
	Supprime l'entité ayant l'indice index.

void	popBack ()
	Supprime la dernière entité du tableau.

T &	at (Int64 i)
	Elément d'indice i. Vérifie toujours les débordements.

ConstReferenceType	at (Int64 i) const
	Elément d'indice i. Vérifie toujours les débordements.

void	setAt (Int64 i, ConstReferenceType value)
	Positionne l'élément d'indice i. Vérifie toujours les débordements.

ConstReferenceType	item (Int64 i) const
	Elément d'indice i.

void	setItem (Int64 i, ConstReferenceType v)
	Elément d'indice i.

ConstReferenceType	operator() (Int64 i) const

T &	operator() (Int64 i)
	Elément d'indice i.

T &	back ()
	Dernier élément du tableau.

ConstReferenceType	back () const
	Dernier élément du tableau (const)

T &	front ()
	Premier élément du tableau.

ConstReferenceType	front () const
	Premier élément du tableau (const)

void	clear ()
	Supprime les éléments du tableau.

void	copy (Span< const T > rhs)
	Copie les valeurs de rhs dans l'instance.

Array< T >	clone () const
	Clone le tableau.

const T *	unguardedBasePointer () const

T *	unguardedBasePointer ()

const T *	data () const
	Accès à la racine du tableau hors toute protection.

T *	data ()

iterator	begin ()
	Itérateur sur le premier élément du tableau.

const_iterator	begin () const
	Itérateur constant sur le premier élément du tableau.

iterator	end ()
	Itérateur sur le premier élément après la fin du tableau.

const_iterator	end () const
	Itérateur constant sur le premier élément après la fin du tableau.

reverse_iterator	rbegin ()
	Itérateur inverse sur le premier élément du tableau.

const_reverse_iterator	rbegin () const
	Itérateur inverse sur le premier élément du tableau.

reverse_iterator	rend ()
	Itérateur inverse sur le premier élément après la fin du tableau.

const_reverse_iterator	rend () const
	Itérateur inverse sur le premier élément après la fin du tableau.

ArrayRange< pointer >	range ()
	Intervalle d'itération du premier au dernièr élément.

ArrayRange< const_pointer >	range () const
	Intervalle d'itération du premier au dernièr élément.

void	push_back (ConstReferenceType val)
	Ajoute l'élément val à la fin du tableau.

Fonctions membres publiques hérités de Arcane::AbstractArray< T >
	AbstractArray (const AbstractArray< T > &rhs)=delete

AbstractArray< T > &	operator= (const AbstractArray< T > &rhs)=delete

void	dispose ()
	Libère la mémoire utilisée par le tableau.

	operator ConstArrayView< T > () const

	operator Span< const T > () const

	operator SmallSpan< const T > () const

Integer	size () const
	Nombre d'éléments du vecteur.

Integer	length () const
	Nombre d'éléments du vecteur.

Integer	capacity () const
	Capacité (nombre d'éléments alloués) du vecteur.

Int64	largeSize () const
	Nombre d'éléments du vecteur (en 64 bits)

Int64	largeLength () const
	Nombre d'éléments du vecteur (en 64 bits)

Int64	largeCapacity () const
	Capacité (nombre d'éléments alloués) du vecteur (en 64 bits)

bool	empty () const
	Capacité (nombre d'éléments alloués) du vecteur.

bool	contains (ConstReferenceType v) const
	Vrai si le tableau contient l'élément de valeur v.

ConstReferenceType	operator[] (Int64 i) const
	Elément d'indice i.

ConstReferenceType	operator() (Int64 i) const
	Elément d'indice i.

void	setMemoryLocationHint (eMemoryLocationHint new_hint)
	Modifie les informations sur la localisation mémoire.

void	_internalSetHostDeviceMemoryLocation (eHostDeviceMemoryLocation location)
	Positionne l'emplacement physique de la zone mémoire.

eHostDeviceMemoryLocation	hostDeviceMemoryLocation () const
	Positionne l'emplacement physique de la zone mémoire.

void	printInfos (std::ostream &o)

Fonctions membres publiques hérités de Arcane::AbstractArrayBase
IMemoryAllocator *	allocator () const

MemoryAllocationOptions	allocationOptions () const

void	setDebugName (const String &name)
	Positionne le nom du tableau pour les informations de debug.

String	debugName () const
	Nom de debug (nul si aucun nom spécifié)

Fonctions membres protégées
	Array (Array< T > &&rhs) ARCCORE_NOEXCEPT
	Constructeur par déplacement (uniquement pour UniqueArray)

void	_initFromInitializerList (std::initializer_list< T > alist)

Fonctions membres protégées hérités de Arcane::AbstractArray< T >
	AbstractArray ()
	Construit un vecteur vide avec l'allocateur par défaut.

	AbstractArray (ThatClassType &&rhs) ARCCORE_NOEXCEPT
	Constructeur par déplacement. Ne doit être utilisé que par UniqueArray.

AllocatedMemoryInfo	_currentMemoryInfo () const

void	_initFromSpan (const Span< const T > &view)
	Initialise le tableau avec la vue view.

void	_initFromAllocator (IMemoryAllocator *a, Int64 acapacity)
	Construit un tableau avec un allocateur spécifique a.

void	_initFromAllocator (MemoryAllocationOptions o, Int64 acapacity, void *pre_allocated_buffer=nullptr)
	Construit un vecteur vide avec un allocateur spécifique a.

void	_reserve (Int64 new_capacity)
	Réserve le mémoire pour new_capacity éléments.

template<typename PodType>
void	_internalRealloc (Int64 new_capacity, bool compute_capacity, PodType pod_type, RunQueue *queue=nullptr)
	Réalloue le tableau pour une nouvelle capacité égale à new_capacity.

void	_internalRealloc (Int64 new_capacity, bool compute_capacity)

void	_internalReallocate (Int64 new_capacity, TrueType, RunQueue *queue)
	Réallocation pour un type POD.

void	_internalReallocate (Int64 new_capacity, FalseType, RunQueue *queue)
	Réallocation pour un type complexe (non POD)

void	_internalDeallocate (RunQueue *queue=nullptr)

void	_internalAllocate (Int64 new_capacity, RunQueue *queue)

void	_copyFromMemory (const T *source)

virtual void	_updateReferences ()
	Mise à jour des références.

virtual Integer	_getNbRef ()
	Mise à jour des références.

void	_addRange (ConstReferenceType val, Int64 n)
	Ajoute n élément de valeur val à la fin du tableau.

void	_addRange (Span< const T > val)
	Ajoute n élément de valeur val à la fin du tableau.

void	_checkFreeMemory ()
	Détruit l'instance si plus personne ne la référence.

void	_destroy ()

void	_destroyRange (Int64, Int64, TrueType)

void	_destroyRange (Int64 abegin, Int64 aend, FalseType)

void	_createRangeDefault (Int64, Int64, TrueType)

void	_createRangeDefault (Int64 abegin, Int64 aend, FalseType)

void	_createRange (Int64 abegin, Int64 aend, ConstReferenceType value, TrueType)

void	_createRange (Int64 abegin, Int64 aend, ConstReferenceType value, FalseType)

void	_createRange (Int64 abegin, Int64 aend, const T *values)

void	_fill (ConstReferenceType value)

void	_clone (const ThatClassType &orig_array)

template<typename PodType>
void	_resizeHelper (Int64 s, PodType pod_type, RunQueue *queue)

void	_resize (Int64 s)

void	_resizeNoInit (Int64 s, RunQueue *queue=nullptr)
	Redimensionne sans initialiser les nouvelles valeurs.

void	_clear ()

void	_resize (Int64 s, ConstReferenceType value)
	Redimensionne et remplit les nouvelles valeurs avec value.

void	_copy (const T *rhs_begin, TrueType)

void	_copy (const T *rhs_begin, FalseType)

void	_copy (const T *rhs_begin)

void	_resizeAndCopyView (Span< const T > rhs)
	Redimensionne l'instance et recopie les valeurs de rhs.

void	_move (ThatClassType &rhs) ARCCORE_NOEXCEPT
	Implémente l'opérateur d'assignement par déplacement.

void	_swap (ThatClassType &rhs) ARCCORE_NOEXCEPT
	Échange les valeurs de l'instance avec celles de rhs.

void	_shrink ()

void	_shrink (Int64 new_capacity)

void	_reset ()
	Réinitialise le tableau à un tableau vide.

constexpr Integer	_clampSizeOffet (Int64 offset, Int32 asize) const

void	_assignFromArray (const AbstractArray< T > &rhs)

void	_setMP (TrueImpl *new_mp)

void	_setMP2 (TrueImpl new_mp, ArrayMetaData new_md)

bool	_isSharedNull ()

Fonctions membres protégées hérités de Arcane::AbstractArrayBase
virtual bool	_isUseOwnMetaData () const
	Indique si m_md fait référence à m_meta_data.

void	_swapMetaData (AbstractArrayBase &rhs)

void	_copyMetaData (const AbstractArrayBase &rhs)

void	_allocateMetaData ()

void	_deallocateMetaData (ArrayMetaData *md)

void	_checkValidSharedArray ()

Fonctions membres privées
	Array (const Array< T > &rhs)=delete

void	operator= (const Array< T > &rhs)=delete

Fonctions membres privées statiques
static int	TV_ttf_display_type (const Arccore::Array< T > *obj)
	Method called from totalview debugger.

Attributs privés
Arcane::UniqueArray< Arcane::UniqueArray< DataType > >	m_values
	Conteneur des variables génériques.

Membres hérités additionnels
Fonctions membres protégées statiques hérités de Arcane::AbstractArray< T >
static constexpr Int64	typeSize ()

Fonctions membres protégées statiques hérités de Arcane::AbstractArrayBase
static constexpr RunQueue *	_nullRunQueue ()
	Méthode explicite pour une RunQueue nulle.

Attributs protégés hérités de Arcane::AbstractArray< T >
T *	m_ptr = nullptr

Attributs protégés hérités de Arcane::AbstractArrayBase
ArrayMetaData *	m_md = nullptr

ArrayMetaData	m_meta_data

Description détaillée

template<typename DataType>
class Arccore::Array< DataType >

Tableau d'items de types quelconques.

Classe de base des vecteurs 1D de données.

Similaire aux variables mais sans les définir

Par exemle :

AnyItem::UniqueArray<Real> array(family.allItems()); array.fill(0.);

ENUMERATE_ANY_ITEM(iitem, family.allItems()) { array[iitem] += variable[iitem]; }

\TODO : on pourrait améliorer l'implémentation en utilisant le localId dans la AnyItem::Family avec un tableau unique alloué à maxLocalId

Cette classe manipule un vecteur (tableau) 1D de données.

Les instances de cette classe ne sont pas copiables ni affectable. Pour créer un tableau copiable, il faut utiliser SharedArray (pour une sémantique par référence) ou UniqueArray (pour une sémantique par valeur comme la STL).

Définition à la ligne 52 du fichier AnyItemArray.h.

Documentation des définitions de type membres

◆ BaseClassType

template<typename DataType>

typedef AbstractArray<T> Arcane::Array< DataType >::BaseClassType

Définition à la ligne 1040 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ const_iterator

template<typename DataType>

typedef ArrayIterator<const_pointer> Arcane::AbstractArray< T >::const_iterator

Type de l'itérateur constant sur un élément du tableau.

Définition à la ligne 312 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ const_pointer

template<typename DataType>

typedef const value_type* Arcane::AbstractArray< T >::const_pointer

Type pointeur constant d'un élément du tableau.

Définition à la ligne 308 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ const_reference

template<typename DataType>

typedef ConstReferenceType Arcane::AbstractArray< T >::const_reference

Type référence constante d'un élément du tableau.

Définition à la ligne 316 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ const_reverse_iterator

template<typename DataType>

typedef std::reverse_iterator<const_iterator> Arcane::AbstractArray< T >::const_reverse_iterator

Définition à la ligne 323 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ ConstReferenceType

template<typename DataType>

typedef ArrayTraits<T>::ConstReferenceType Arcane::AbstractArray< T >::ConstReferenceType

Définition à la ligne 296 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ difference_type

template<typename DataType>

typedef ptrdiff_t Arcane::AbstractArray< T >::difference_type

Type d'une distance entre itérateur éléments du tableau.

Définition à la ligne 320 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ iterator

template<typename DataType>

typedef ArrayIterator<pointer> Arcane::AbstractArray< T >::iterator

Type de l'itérateur sur un élément du tableau.

Définition à la ligne 310 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ pointer

template<typename DataType>

typedef value_type* Arcane::AbstractArray< T >::pointer

Type pointeur d'un élément du tableau.

Définition à la ligne 306 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ reference

template<typename DataType>

typedef value_type& Arcane::AbstractArray< T >::reference

Type référence d'un élément du tableau.

Définition à la ligne 314 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ reverse_iterator

template<typename DataType>

typedef std::reverse_iterator<iterator> Arcane::AbstractArray< T >::reverse_iterator

Définition à la ligne 322 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ size_type

template<typename DataType>

typedef Int64 Arcane::AbstractArray< T >::size_type

Type indexant le tableau.

Définition à la ligne 318 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ value_type

template<typename DataType>

typedef T Arcane::AbstractArray< T >::value_type

Type des éléments du tableau.

Définition à la ligne 304 du fichier arccore/src/collections/arccore/collections/Array.h.

Documentation des constructeurs et destructeur

◆ Array() [1/3]

template<typename DataType>

Arcane::Array< DataType >::Array ( const Group & group )

inline

Définition à la ligne 56 du fichier AnyItemArray.h.

◆ Array() [2/3]

template<typename DataType>

Arcane::Array< DataType >::Array ( )

inlineprotected

Définition à la ligne 1059 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ Array() [3/3]

template<typename DataType>

Arcane::Array< DataType >::Array ( Array< T > && rhs )

inlineprotected

Constructeur par déplacement (uniquement pour UniqueArray)

Définition à la ligne 1064 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ ~Array()

template<typename DataType>

Arcane::Array< DataType >::~Array ( )

inline

Définition à la ligne 1083 du fichier arccore/src/collections/arccore/collections/Array.h.

Documentation des fonctions membres

◆ _initFromInitializerList()

template<typename DataType>

void Arcane::Array< DataType >::_initFromInitializerList ( std::initializer_list< T > alist )

inlineprotected

Définition à la ligne 1068 du fichier arccore/src/collections/arccore/collections/Array.h.

◆ add()

template<typename DataType>

void Arcane::Array< DataType >::add ( ConstReferenceType val )

inline

Ajoute l'élément val à la fin du tableau.

Définition à la ligne 1195 du fichier arccore/src/collections/arccore/collections/Array.h.

Référencé par Arcane::SplitSDMeshPartitioner::MAJDomaine(), Arcane::Hdf5VariableReaderHelper2::open(), et Arcane::Hdf5VariableReaderHelper::open().

Voici le graphe des appelants de cette fonction :