Vecteur 1D de données avec sémantique par valeur (style STL). Plus de détails...

#include <arccore/common/Array.h>

Types publics
typedef AbstractArray< T >	BaseClassType
typedef ArrayTraits< T >::ConstReferenceType	ConstReferenceType
Types publics hérités de Arcane::Array< T >
typedef AbstractArray< T >	BaseClassType
typedef ArrayTraits< T >::ConstReferenceType	ConstReferenceType
typedef ArrayIterator< const_pointer >	const_iterator
	Type de l'itérateur constant sur un élément du tableau.
typedef const value_type *	const_pointer
	Type pointeur constant d'un élément du tableau.
typedef ConstReferenceType	const_reference
	Type référence constante d'un élément du tableau.
typedef std::reverse_iterator< const_iterator >	const_reverse_iterator
typedef ptrdiff_t	difference_type
	Type d'une distance entre itérateur éléments du tableau.
typedef ArrayIterator< pointer >	iterator
	Type de l'itérateur sur un élément du tableau.
typedef value_type *	pointer
	Type pointeur d'un élément du tableau.
typedef value_type &	reference
	Type référence d'un élément du tableau.
typedef std::reverse_iterator< iterator >	reverse_iterator
typedef Int64	size_type
	Type indexant le tableau.
typedef T	value_type
	Type des é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
	UniqueArray ()
	Créé un tableau vide.
	UniqueArray (Int64 req_size, ConstReferenceType value)
	Créé un tableau de size éléments contenant la valeur value.
	UniqueArray (long long asize)
	Créé un tableau de asize éléments contenant la valeur par défaut du type T().
	UniqueArray (long asize)
	Créé un tableau de asize éléments contenant la valeur par défaut du type T().
	UniqueArray (int asize)
	Créé un tableau de asize éléments contenant la valeur par défaut du type T().
	UniqueArray (unsigned long long asize)
	Créé un tableau de asize éléments contenant la valeur par défaut du type T().
	UniqueArray (unsigned long asize)
	Créé un tableau de asize éléments contenant la valeur par défaut du type T().
	UniqueArray (unsigned int asize)
	Créé un tableau de asize éléments contenant la valeur par défaut du type T().
	UniqueArray (const ConstArrayView< T > &aview)
	Créé un tableau en recopiant les valeurs de la value aview.
	UniqueArray (const Span< const T > &aview)
	Créé un tableau en recopiant les valeurs de la value aview.
	UniqueArray (const ArrayView< T > &aview)
	Créé un tableau en recopiant les valeurs de la value aview.
	UniqueArray (const Span< T > &aview)
	Créé un tableau en recopiant les valeurs de la value aview.
	UniqueArray (std::initializer_list< T > alist)
	UniqueArray (const Array< T > &rhs)
	Créé un tableau en recopiant les valeurs rhs.
	UniqueArray (const UniqueArray< T > &rhs)
	Créé un tableau en recopiant les valeurs rhs.
	UniqueArray (const SharedArray< T > &rhs)
	Créé un tableau en recopiant les valeurs rhs.
	UniqueArray (UniqueArray< T > &&rhs) ARCCORE_NOEXCEPT
	Constructeur par déplacement. rhs est invalidé après cet appel.
	UniqueArray (IMemoryAllocator *allocator)
	Créé un tableau vide avec un allocateur spécifique allocator.
	UniqueArray (MemoryAllocationOptions allocate_options)
	Créé un tableau vide avec un allocateur spécifique allocator.
	UniqueArray (IMemoryAllocator *allocator, Int64 asize)
	Créé un tableau de asize éléments avec un allocateur spécifique allocator.
	UniqueArray (MemoryAllocationOptions allocate_options, Int64 asize)
	Créé un tableau de asize éléments avec un allocateur spécifique allocator.
	UniqueArray (IMemoryAllocator *allocator, Span< const T > rhs)
	Créé un tableau avec l'allocateur allocator en recopiant les valeurs rhs.
	UniqueArray (MemoryAllocationOptions allocate_options, Span< const T > rhs)
	Créé un tableau avec l'allocateur allocator en recopiant les valeurs rhs.
void	operator= (const Array< T > &rhs)
	Copie les valeurs de rhs dans cette instance.
void	operator= (const SharedArray< T > &rhs)
	Copie les valeurs de rhs dans cette instance.
void	operator= (const UniqueArray< T > &rhs)
	Copie les valeurs de rhs dans cette instance.
void	operator= (UniqueArray< T > &&rhs) ARCCORE_NOEXCEPT
	Opérateur de recopie par déplacement. rhs est invalidé après cet appel.
void	operator= (const ArrayView< T > &rhs)
	Copie les valeurs de la vue rhs dans cette instance.
void	operator= (const Span< T > &rhs)
	Copie les valeurs de la vue rhs dans cette instance.
void	operator= (const SmallSpan< T > &rhs)
	Copie les valeurs de la vue rhs dans cette instance.
void	operator= (const ConstArrayView< T > &rhs)
	Copie les valeurs de la vue rhs dans cette instance.
void	operator= (const Span< const T > &rhs)
	Copie les valeurs de la vue rhs dans cette instance.
void	operator= (const SmallSpan< const T > &rhs)
	Copie les valeurs de la vue rhs dans cette instance.
void	operator= (std::initializer_list< T > alist)
	Copie les valeurs de la vue alist dans cette instance.
	~UniqueArray () override
	Détruit l'instance.
void	swap (UniqueArray< T > &rhs)
	Échange les valeurs de l'instance avec celles de rhs.
UniqueArray< T >	clone () const
	Clone le tableau.
Fonctions membres publiques hérités de Arcane::Array< T >
	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< const T >	constSmallSpan () const
	Vue immutable sur ce tableau.
SmallSpan< T >	smallSpan ()
	Vue mutable 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.
template<typename InputIterator>
void	assign (InputIterator first, InputIterator last)
	Remplace le contenu de l'instance par des copies de celles de l'intervalle [first, last).
void	assign (Int64 count, ConstReferenceType val)
	Remplace le contenu de l'instance par count copies de la valeur val.
iterator	erase (const_iterator pos)
	Supprime l'élément à la position pos.
iterator	erase (const_iterator first, const_iterator last)
	Supprime les éléments de l'intervalle [first, last).
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
	Elément d'indice i.
T &	operator[] (Int64 i)
	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	fill (ConstReferenceType value)
	Remplit le tableau avec la valeur value.
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.
const_iterator	cbegin () const noexcept
	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.
const_iterator	cend () const noexcept
	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.
void	pop_back ()
	Supprime la dernière entité du tableau.
template<typename... Args>
void	emplace_back (Args &&... args)
	Ajoute un nouvel élément construit en place à 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	changeAllocator (const MemoryAllocationOptions &options, RunQueue *queue)
void	changeAllocator (const MemoryAllocationOptions &options)
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é).
void	printInfos (std::ostream &o)

Membres hérités additionnels
Fonctions membres protégées hérités de Arcane::Array< T >
	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 (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.
void	_internalRealloc (Int64 new_capacity, bool compute_capacity, RunQueue *queue=nullptr)
	Réalloue le tableau pour une nouvelle capacité égale à new_capacity.
void	_internalReallocate (Int64 new_capacity, RunQueue *queue)
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 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 T>
class Arcane::UniqueArray< T >

Vecteur 1D de données avec sémantique par valeur (style STL).

Cette classe gère un tableau de valeur de la même manière que la classe stl::vector de la STL.

La sémantique par valeur fonctionne comme suit:

UniqueArray<int> a1(5);
UniqueArray<int> a2;
a2 = a1; // a2 devient une copie de a1.
a1[3] = 1;
a2[3] = 2;
std::cout << a1[3]; // affiche '1'

Il est possible de spécifier un allocateur mémoire spécifique via le constructeur UniqueArray(IMemoryAllocator*). Dans ce cas, l'allocateur spécifié en argument doit rester valide tant que cette instance est utilisée.

Avertissement: L'allocateur est transféré à l'instance de destination lors d'un appel aux constructeurs qui prennent en argument un Array, SharedArray ou UniqueArray. Il en est de même avec l'opérateur d'assignement et lors de l'appel à UniqueArray::swap(). Si ces appels sont envisagés, il faut garantir que l'allocateur restera valide même après transfert. Il est donc préférable dans tout les cas que l'allocateur spécifique utilisé reste valide durant toute la durée de l'application.

Note: Si le type est un type Plain Object Data (POD) alors les données ne sont pas initialisées en cas d'allocation ou de réallocation. La classe template ArrayTraits permet de spécifier si un type est POD suivant la valeur données par le type ArrayTraits<T>::IsPODType qui peut être FalseType ou TrueType. La macro ARCCORE_DEFINE_ARRAY_PODTYPE() permet de définir un tel type. Sauf spécialisation, seuls les types de base du C++ sont POD.

Avertissement: Si ArrayTraits<T>::IsPODType vaut false, les opérations de redimensionnement ou de copie ont toujours lieu sur l'hôte. Il faut donc que la mémoire retournée par l'allocateur (allocator()) soit accessible sur l'hôte.

Définition à la ligne 970 du fichier arccore/src/common/arccore/common/Array.h.

Documentation des définitions de type membres

◆ BaseClassType

template<typename T>

typedef AbstractArray<T> Arcane::UniqueArray< T >::BaseClassType

Définition à la ligne 975 du fichier arccore/src/common/arccore/common/Array.h.

◆ ConstReferenceType

template<typename T>

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

Définition à la ligne 176 du fichier AbstractArray.h.

Documentation des constructeurs et destructeur

◆ UniqueArray() [1/23]

template<typename T>

Arcane::UniqueArray< T >::UniqueArray ( )

inline

Créé un tableau vide.

Définition à la ligne 981 du fichier arccore/src/common/arccore/common/Array.h.

Référencé par Arcane::UniqueArray< CaseOptionEnumValue * >::clone().

◆ UniqueArray() [2/23]

template<typename T>

Arcane::UniqueArray< T >::UniqueArray	(	Int64	req_size,
		ConstReferenceType	value )

inline

Créé un tableau de size éléments contenant la valeur value.

Définition à la ligne 983 du fichier arccore/src/common/arccore/common/Array.h.