VTK
vtkStringArray.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkStringArray.h
5  Language: C++
6 
7  Copyright 2004 Sandia Corporation.
8  Under the terms of Contract DE-AC04-94AL85000, there is a non-exclusive
9  license for use of this work by or on behalf of the
10  U.S. Government. Redistribution and use in source and binary forms, with
11  or without modification, are permitted provided that this Notice and any
12  statement of authorship are reproduced on all copies.
13 
14 =========================================================================*/
15 
27 #ifndef vtkStringArray_h
28 #define vtkStringArray_h
29 
30 #include "vtkCommonCoreModule.h" // For export macro
31 #include "vtkAbstractArray.h"
32 #include "vtkStdString.h" // needed for vtkStdString definition
33 
34 class vtkStringArrayLookup;
35 
36 class VTKCOMMONCORE_EXPORT vtkStringArray : public vtkAbstractArray
37 {
38 public:
39  static vtkStringArray* New();
41  void PrintSelf(ostream& os, vtkIndent indent) VTK_OVERRIDE;
42 
43  //
44  //
45  // Functions required by vtkAbstractArray
46  //
47  //
48 
52  int GetDataType() VTK_OVERRIDE
53  { return VTK_STRING; }
54 
55  int IsNumeric() VTK_OVERRIDE { return 0; }
56 
60  void Initialize() VTK_OVERRIDE;
61 
68  int GetDataTypeSize() VTK_OVERRIDE;
69 
74  void Squeeze() VTK_OVERRIDE { this->ResizeAndExtend (this->MaxId+1); }
75 
79  int Resize(vtkIdType numTuples) VTK_OVERRIDE;
80 
87  void SetTuple(vtkIdType i, vtkIdType j, vtkAbstractArray* source) VTK_OVERRIDE;
88 
93  void InsertTuple(vtkIdType i, vtkIdType j, vtkAbstractArray* source) VTK_OVERRIDE;
94 
100  void InsertTuples(vtkIdList *dstIds, vtkIdList *srcIds,
101  vtkAbstractArray *source) VTK_OVERRIDE;
102 
108  void InsertTuples(vtkIdType dstStart, vtkIdType n, vtkIdType srcStart,
109  vtkAbstractArray* source) VTK_OVERRIDE;
110 
116  vtkIdType InsertNextTuple(vtkIdType j, vtkAbstractArray* source) VTK_OVERRIDE;
117 
125  void InterpolateTuple(vtkIdType i, vtkIdList *ptIndices,
126  vtkAbstractArray* source, double* weights) VTK_OVERRIDE;
127 
137  vtkIdType id1, vtkAbstractArray* source1,
138  vtkIdType id2, vtkAbstractArray* source2, double t) VTK_OVERRIDE;
139 
146  void GetTuples(vtkIdList *ptIds, vtkAbstractArray *output) VTK_OVERRIDE;
147 
155  void GetTuples(vtkIdType p1, vtkIdType p2, vtkAbstractArray *output) VTK_OVERRIDE;
156 
161  int Allocate( vtkIdType sz, vtkIdType ext=1000 ) VTK_OVERRIDE;
162 
166  vtkStdString &GetValue(vtkIdType id);
167 
173  { this->Array[id] = value; this->DataChanged(); }
174 
175  void SetValue(vtkIdType id, const char *value);
176 
181  void SetNumberOfTuples(vtkIdType number) VTK_OVERRIDE
182  { this->SetNumberOfValues(this->NumberOfComponents* number); }
183 
189  void SetNumberOfValues(vtkIdType number) VTK_OVERRIDE;
190 
191  vtkIdType GetNumberOfValues() { return this->MaxId + 1; }
192 
193  int GetNumberOfElementComponents() { return 0; }
194  int GetElementComponentSize() VTK_OVERRIDE { return static_cast<int>(sizeof(vtkStdString::value_type)); }
195 
199  void InsertValue(vtkIdType id, vtkStdString f);
200 
201  void InsertValue(vtkIdType id, const char *val);
202 
207  void SetVariantValue(vtkIdType idx, vtkVariant value) VTK_OVERRIDE;
208 
213  void InsertVariantValue(vtkIdType idx, vtkVariant value) VTK_OVERRIDE;
214 
218  vtkIdType InsertNextValue(vtkStdString f);
219 
220  vtkIdType InsertNextValue(const char *f);
221 
227  vtkStdString* WritePointer(vtkIdType id, vtkIdType number);
228 
233  vtkStdString* GetPointer(vtkIdType id) { return this->Array + id; }
234  void* GetVoidPointer(vtkIdType id) VTK_OVERRIDE { return this->GetPointer(id); }
235 
240  void DeepCopy( vtkAbstractArray* aa ) VTK_OVERRIDE;
241 
252  void SetArray(vtkStdString* array, vtkIdType size, int save);
253  void SetVoidArray(void* array, vtkIdType size, int save) VTK_OVERRIDE
254  { this->SetArray(static_cast<vtkStdString*>(array), size, save); }
255  void SetVoidArray(void* array, vtkIdType size, int save,
256  int vtkNotUsed(deleteMethod)) VTK_OVERRIDE
257  { this->SetArray(static_cast<vtkStdString*>(array), size, save); }
258 
270  unsigned long GetActualMemorySize() VTK_OVERRIDE;
271 
276 
282  vtkIdType GetDataSize() VTK_OVERRIDE;
283 
285 
288  vtkIdType LookupValue(vtkVariant value) VTK_OVERRIDE;
289  void LookupValue(vtkVariant value, vtkIdList* ids) VTK_OVERRIDE;
291 
293  void LookupValue(vtkStdString value, vtkIdList* ids);
294 
295  vtkIdType LookupValue(const char* value);
296  void LookupValue(const char* value, vtkIdList* ids);
297 
306  void DataChanged() VTK_OVERRIDE;
307 
313  virtual void DataElementChanged(vtkIdType id);
314 
320  void ClearLookup() VTK_OVERRIDE;
321 
322 protected:
323  vtkStringArray();
324  ~vtkStringArray() VTK_OVERRIDE;
325 
326  vtkStdString* Array; // pointer to data
327  vtkStdString* ResizeAndExtend(vtkIdType sz); // function to resize data
328 
330 
331 private:
332  vtkStringArray(const vtkStringArray&) VTK_DELETE_FUNCTION;
333  void operator=(const vtkStringArray&) VTK_DELETE_FUNCTION;
334 
335  vtkStringArrayLookup* Lookup;
336  void UpdateLookup();
337 
338 };
339 
340 #endif
void SetVoidArray(void *array, vtkIdType size, int save, int vtkNotUsed(deleteMethod)) override
This method lets the user specify data to be held by the array.
vtkIdType GetNumberOfValues()
Wrapper around std::string to keep symbols short.
Definition: vtkStdString.h:41
virtual void DataChanged()=0
Tell the array explicitly that the data has changed.
vtkStdString * GetPointer(vtkIdType id)
Get the address of a particular data index.
virtual void DeepCopy(vtkAbstractArray *da)
Deep copy of data.
virtual void GetTuples(vtkIdList *tupleIds, vtkAbstractArray *output)
Given a list of tuple ids, return an array of tuples.
Abstract superclass for all arrays.
virtual vtkIdType LookupValue(vtkVariant value)=0
Return the value indices where a specific value appears.
virtual int GetDataTypeSize()=0
Return the size of the underlying data type.
vtkStdString * Array
virtual void SetNumberOfValues(vtkIdType numValues)
Specify the number of values (tuples * components) for this object to hold.
a vtkAbstractArray subclass for strings
int vtkIdType
Definition: vtkType.h:345
virtual void InterpolateTuple(vtkIdType dstTupleIdx, vtkIdList *ptIndices, vtkAbstractArray *source, double *weights)=0
Set the tuple at dstTupleIdx in this array to the interpolated tuple value, given the ptIndices in th...
int GetElementComponentSize() override
Return the size, in bytes, of the lowest-level element of an array.
virtual void Initialize()=0
Release storage and reset array to initial state.
A atomic type representing the union of many types.
Definition: vtkVariant.h:69
void SetValue(vtkIdType id, vtkStdString value)
Set the data at a particular index.
#define VTK_STRING
Definition: vtkType.h:64
virtual vtkIdType GetDataSize()
Returns the size of the data in DataTypeSize units.
void SetNumberOfTuples(vtkIdType number) override
Set the number of tuples (a component group) in the array.
void * GetVoidPointer(vtkIdType id) override
Return a void pointer.
virtual void ClearLookup()=0
Delete the associated fast lookup data structure on this array, if it exists.
a simple class to control print indentation
Definition: vtkIndent.h:33
list of point or cell ids
Definition: vtkIdList.h:30
virtual int Resize(vtkIdType numTuples)=0
Resize the array to the requested number of tuples and preserve data.
void Squeeze() override
Free any unnecessary memory.
virtual VTK_NEWINSTANCE vtkArrayIterator * NewIterator()=0
Subclasses must override this method and provide the right kind of templated vtkArrayIteratorTemplate...
virtual void InsertVariantValue(vtkIdType valueIdx, vtkVariant value)=0
Insert a value into the array from a variant.
Abstract superclass to iterate over elements in an vtkAbstractArray.
#define VTK_NEWINSTANCE
virtual void InsertTuple(vtkIdType dstTupleIdx, vtkIdType srcTupleIdx, vtkAbstractArray *source)=0
Insert the tuple at srcTupleIdx in the source array into this array at dstTupleIdx.
virtual int Allocate(vtkIdType numValues, vtkIdType ext=1000)=0
Allocate memory for this array.
void save(Archiver &ar, const vtkUnicodeString &str, const unsigned int vtkNotUsed(version))
boost::graph_traits< vtkGraph *>::vertex_descriptor source(boost::graph_traits< vtkGraph * >::edge_descriptor e, vtkGraph *)
virtual vtkIdType InsertNextTuple(vtkIdType srcTupleIdx, vtkAbstractArray *source)=0
Insert the tuple from srcTupleIdx in the source array at the end of this array.
int GetDataType() override
Get the data type.
virtual void SetTuple(vtkIdType dstTupleIdx, vtkIdType srcTupleIdx, vtkAbstractArray *source)=0
Set the tuple at dstTupleIdx in this array to the tuple at srcTupleIdx in the source array...
StdString::value_type value_type
Definition: vtkStdString.h:46
int IsNumeric() override
This method is here to make backward compatibility easier.
virtual unsigned long GetActualMemorySize()=0
Return the memory in kibibytes (1024 bytes) consumed by this data array.
static vtkObject * New()
Create an object with Debug turned off, modified time initialized to zero, and reference counting on...
virtual void SetVariantValue(vtkIdType valueIdx, vtkVariant value)=0
Set a value in the array from a variant.
void SetVoidArray(void *array, vtkIdType size, int save) override
virtual void InsertTuples(vtkIdList *dstIds, vtkIdList *srcIds, vtkAbstractArray *source)=0
Copy the tuples indexed in srcIds from the source array to the tuple locations indexed by dstIds in t...
int GetNumberOfElementComponents()
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.