VTK  9.5.20250806
vtkVariantArray.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
2// SPDX-FileCopyrightText: Copyright 2008 Sandia Corporation
3// SPDX-License-Identifier: LicenseRef-BSD-3-Clause-Sandia-USGov
87#ifndef vtkVariantArray_h
88#define vtkVariantArray_h
89
90#include "vtkAbstractArray.h"
91#include "vtkCommonCoreModule.h" // For export macro
92#include "vtkVariant.h" // For variant type
93#include "vtkWrappingHints.h" // For VTK_MARSHALMANUAL
94
96namespace boost
97{
98namespace serialization
99{
100class access;
101}
102}
103
104VTK_ABI_NAMESPACE_BEGIN
105class vtkVariantArrayLookup;
106
107class VTKCOMMONCORE_EXPORT VTK_MARSHALMANUAL vtkVariantArray : public vtkAbstractArray
108{
109
111 friend class boost::serialization::access;
112
113public:
115 {
119 VTK_DATA_ARRAY_USER_DEFINED = vtkAbstractArray::VTK_DATA_ARRAY_USER_DEFINED
120 };
121
125 void PrintSelf(ostream& os, vtkIndent indent) override;
126
127 //
128 // Functions required by vtkAbstractArray
129 //
130
135 vtkTypeBool Allocate(vtkIdType sz, vtkIdType ext = 1000) override;
136
140 void Initialize() override;
141
146 int GetDataType() const override;
147
153 int GetDataTypeSize() const override;
154
162 int GetElementComponentSize() const override;
163
168 void SetNumberOfTuples(vtkIdType number) override;
169
177
183
189 void InsertTuples(vtkIdList* dstIds, vtkIdList* srcIds, vtkAbstractArray* source) override;
190
192 vtkIdType dstStart, vtkIdList* srcIds, vtkAbstractArray* source) override;
193
200 vtkIdType dstStart, vtkIdType n, vtkIdType srcStart, vtkAbstractArray* source) override;
201
208
213 void* GetVoidPointer(vtkIdType id) override;
214
220 void DeepCopy(vtkAbstractArray* da) override;
221
230 vtkIdType i, vtkIdList* ptIndices, vtkAbstractArray* source, double* weights) override;
231
241 vtkAbstractArray* source2, double t) override;
242
248 void Squeeze() override;
249
254 vtkTypeBool Resize(vtkIdType numTuples) override;
255
257
265 void SetVoidArray(void* arr, vtkIdType size, int save) override;
266 void SetVoidArray(void* arr, vtkIdType size, int save, int deleteM) override;
268
277 unsigned long GetActualMemorySize() const override;
278
282 int IsNumeric() const override;
283
289
290 //
291 // Additional functions
292 //
293
298
304 VTK_EXPECTS(0 <= id && id < this->GetNumberOfValues());
305
311 void InsertValue(vtkIdType id, vtkVariant value) VTK_EXPECTS(0 <= id);
312
316 void SetVariantValue(vtkIdType idx, vtkVariant value) override;
317
321 void InsertVariantValue(vtkIdType idx, vtkVariant value) override;
322
328
333
338 vtkVariant* arr, vtkIdType size, int save, int deleteMethod = VTK_DATA_ARRAY_DELETE);
339
346 void SetArrayFreeFunction(void (*callback)(void*)) override;
347
351 vtkIdType GetNumberOfValues() const { return (this->MaxId + 1); }
352
354
358 void LookupValue(vtkVariant value, vtkIdList* ids) override;
360
369 void DataChanged() override;
370
377
383 void ClearLookup() override;
384
390
391protected:
392 // Construct object with default tuple dimension (number of components) of 1.
394
395 // Pointer to data
396
398
399 // Function to resize data
401
402 void (*DeleteFunction)(void*);
403
404private:
405 vtkVariantArray(const vtkVariantArray&) = delete;
406 void operator=(const vtkVariantArray&) = delete;
407
408 vtkVariantArrayLookup* Lookup;
409 void UpdateLookup();
410};
411
412VTK_ABI_NAMESPACE_END
413#endif
Abstract superclass for all arrays.
vtkIdType GetNumberOfValues() const
Get the total number of values in the array.
Abstract superclass to iterate over elements in an vtkAbstractArray.
list of point or cell ids
Definition vtkIdList.h:133
a simple class to control print indentation
Definition vtkIndent.h:108
An array holding vtkVariants.
vtkVariant * Array
void SetVoidArray(void *arr, vtkIdType size, int save, int deleteM) override
This method lets the user specify data to be held by the array.
void SetVoidArray(void *arr, vtkIdType size, int save) override
This method lets the user specify data to be held by the array.
static vtkVariantArray * New()
vtkTypeBool Allocate(vtkIdType sz, vtkIdType ext=1000) override
Allocate memory for this array.
int GetDataType() const override
Return the underlying data type.
void SetArrayFreeFunction(void(*callback)(void *)) override
This method allows the user to specify a custom free function to be called when the array is dealloca...
~vtkVariantArray() override
This destructor is public to work around a bug in version 1.36.0 of the Boost.Serialization library.
void InsertTuples(vtkIdList *dstIds, vtkIdList *srcIds, vtkAbstractArray *source) override
Copy the tuples indexed in srcIds from the source array to the tuple locations indexed by dstIds in t...
static vtkVariantArray * ExtendedNew()
vtkTypeBool Resize(vtkIdType numTuples) override
Resize the array while conserving the data.
void InsertTuplesStartingAt(vtkIdType dstStart, vtkIdList *srcIds, vtkAbstractArray *source) override
Copy the tuples indexed in srcIds from the source array to the tuple locations starting at index dstS...
vtkIdType InsertNextValue(vtkVariant value)
Expand the array by one and set the value at that location.
void InsertVariantValue(vtkIdType idx, vtkVariant value) override
Safely insert a value into the array from a variant.
vtkArrayIterator * NewIterator() override
Subclasses must override this method and provide the right kind of templated vtkArrayIteratorTemplate...
void ClearLookup() override
Delete the associated fast lookup data structure on this array, if it exists.
unsigned long GetActualMemorySize() const override
Return the memory in kibibytes (1024 bytes) consumed by this data array.
vtkIdType LookupValue(vtkVariant value) override
Return the indices where a specific value appears.
void SetTuple(vtkIdType i, vtkIdType j, vtkAbstractArray *source) override
Set the tuple at the ith location using the jth tuple in the source array.
vtkIdType InsertNextTuple(vtkIdType j, vtkAbstractArray *source) override
Insert the jth tuple in the source array, at the end in this array.
void SetVariantValue(vtkIdType idx, vtkVariant value) override
Insert a value into the array from a variant.
int GetDataTypeSize() const override
Return the size of the underlying data type.
void SetNumberOfTuples(vtkIdType number) override
Set the number of tuples (a component group) in the array.
void LookupValue(vtkVariant value, vtkIdList *ids) override
Return the indices where a specific value appears.
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
virtual void DataElementChanged(vtkIdType id)
Tell the array explicitly that a single data element has changed.
void InterpolateTuple(vtkIdType i, vtkIdList *ptIndices, vtkAbstractArray *source, double *weights) override
Set the ith tuple in this array as the interpolated tuple value, given the ptIndices in the source ar...
void InterpolateTuple(vtkIdType i, vtkIdType id1, vtkAbstractArray *source1, vtkIdType id2, vtkAbstractArray *source2, double t) override
Insert the ith tuple in this array as interpolated from the two values, p1 and p2,...
void DeepCopy(vtkAbstractArray *da) override
Deep copy of data.
void DataChanged() override
Tell the array explicitly that the data has changed.
void InsertTuple(vtkIdType i, vtkIdType j, vtkAbstractArray *source) override
Insert the jth tuple in the source array, at ith location in this array.
void Squeeze() override
Free any unnecessary memory.
vtkVariant & GetValue(vtkIdType id) const
Get the data at a particular index.
int IsNumeric() const override
Since each item can be of a different type, we say that a variant array is not numeric.
vtkVariant * ResizeAndExtend(vtkIdType sz)
vtkVariant * GetPointer(vtkIdType id)
Return a pointer to the location in the internal array at the specified index.
void SetArray(vtkVariant *arr, vtkIdType size, int save, int deleteMethod=VTK_DATA_ARRAY_DELETE)
Set the internal array used by this object.
void SetValue(vtkIdType id, vtkVariant value)
Set the data at a particular index.
vtkIdType GetNumberOfValues() const
Return the number of values in the array.
void Initialize() override
Release storage and reset array to initial state.
void * GetVoidPointer(vtkIdType id) override
Return a void pointer.
void InsertValue(vtkIdType id, vtkVariant value)
If id < GetNumberOfValues(), overwrite the array at that index.
int GetElementComponentSize() const override
Return the size, in bytes, of the lowest-level element of an array.
void InsertTuples(vtkIdType dstStart, vtkIdType n, vtkIdType srcStart, vtkAbstractArray *source) override
Copy n consecutive tuples starting at srcStart from the source array to this array,...
A type representing the union of many types.
Definition vtkVariant.h:162
Forward declaration required for Boost serialization.
int vtkTypeBool
Definition vtkABI.h:64
boost::graph_traits< vtkGraph * >::vertex_descriptor source(boost::graph_traits< vtkGraph * >::edge_descriptor e, vtkGraph *)
int vtkIdType
Definition vtkType.h:332
void save(Archiver &ar, const std::string &str, const unsigned int version)
#define VTK_EXPECTS(x)
#define VTK_MARSHALMANUAL
#define VTK_NEWINSTANCE