vtkStringArray.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-FileCopyrightText: Copyright 2004 Sandia Corporation
// SPDX-License-Identifier: LicenseRef-BSD-3-Clause-Sandia-USGov
 
#ifndef vtkStringArray_h
#define vtkStringArray_h
 
#include "vtkAbstractArray.h"
#include "vtkBuffer.h"           // For vtkBuffer
#include "vtkCommonCoreModule.h" // For export macro
#include "vtkStdString.h"        // needed for vtkStdString definition
#include "vtkWrappingHints.h"    // For VTK_MARSHALMANUAL
 
VTK_ABI_NAMESPACE_BEGIN
class vtkStringArrayLookup;
 
class VTKCOMMONCORE_EXPORT VTK_MARSHALMANUAL vtkStringArray : public vtkAbstractArray
{
public:
  enum DeleteMethod
  {
    VTK_DATA_ARRAY_FREE = vtkAbstractArray::VTK_DATA_ARRAY_FREE,
    VTK_DATA_ARRAY_DELETE = vtkAbstractArray::VTK_DATA_ARRAY_DELETE,
    VTK_DATA_ARRAY_ALIGNED_FREE = vtkAbstractArray::VTK_DATA_ARRAY_ALIGNED_FREE,
    VTK_DATA_ARRAY_USER_DEFINED = vtkAbstractArray::VTK_DATA_ARRAY_USER_DEFINED
  };
  using ArrayTypeTag = std::integral_constant<int, vtkArrayTypes::VTK_STRING_ARRAY>;
  using DataTypeTag = std::integral_constant<int, VTK_STRING>;
  using ValueType = vtkStdString;
 
  static vtkStringArray* New();
  static vtkStringArray* ExtendedNew();
  vtkTypeMacro(vtkStringArray, vtkAbstractArray);
  void PrintSelf(ostream& os, vtkIndent indent) override;

  static vtkStringArray* FastDownCast(vtkAbstractArray* source);

  int GetArrayType() const override { return vtkStringArray::ArrayTypeTag::value; }

  int GetDataType() const override { return vtkStringArray::DataTypeTag::value; }
 
  int IsNumeric() const override { return 0; }

  bool CopyComponent(int dstComponent, vtkAbstractArray* src, int srcComponent) override;

  int GetDataTypeSize() const override;

  void Squeeze() override;

  void SetTuple(vtkIdType i, vtkIdType j, vtkAbstractArray* source) override;

  void InsertTuple(vtkIdType i, vtkIdType j, vtkAbstractArray* source) override;

  void InsertTuples(vtkIdList* dstIds, vtkIdList* srcIds, vtkAbstractArray* source) override;
 
  void InsertTuplesStartingAt(
    vtkIdType dstStart, vtkIdList* srcIds, vtkAbstractArray* source) override;

  void InsertTuples(
    vtkIdType dstStart, vtkIdType n, vtkIdType srcStart, vtkAbstractArray* source) override;

  vtkIdType InsertNextTuple(vtkIdType j, vtkAbstractArray* source) override;

  void InterpolateTuple(
    vtkIdType i, vtkIdList* ptIndices, vtkAbstractArray* source, double* weights) override;

  void InterpolateTuple(vtkIdType i, vtkIdType id1, vtkAbstractArray* source1, vtkIdType id2,
    vtkAbstractArray* source2, double t) override;

  void GetTuples(vtkIdList* ptIds, vtkAbstractArray* output) override;

  void GetTuples(vtkIdType p1, vtkIdType p2, vtkAbstractArray* output) override;

  vtkTypeBool ReserveTuples(vtkIdType numTuples) override;

  ValueType GetTypedComponent(vtkIdType tupleIdx, int comp) const
    VTK_EXPECTS(0 <= tupleIdx && GetNumberOfComponents() * tupleIdx + comp < GetNumberOfValues())
      VTK_EXPECTS(0 <= comp && comp < GetNumberOfComponents());


  void SetTypedComponent(vtkIdType tupleIdx, int comp, ValueType value)
    VTK_EXPECTS(0 <= tupleIdx && GetNumberOfComponents() * tupleIdx + comp < GetNumberOfValues())
      VTK_EXPECTS(0 <= comp && comp < GetNumberOfComponents());


  void GetTypedTuple(vtkIdType tupleIdx, ValueType* tuple) const
    VTK_EXPECTS(0 <= tupleIdx && tupleIdx < GetNumberOfTuples());


  void SetTypedTuple(vtkIdType tupleIdx, const ValueType* tuple)
    VTK_EXPECTS(0 <= tupleIdx && tupleIdx < GetNumberOfTuples());

  const ValueType& GetValue(vtkIdType id) const
    VTK_EXPECTS(0 <= id && id < this->GetNumberOfValues());

  ValueType& GetValue(vtkIdType id) VTK_EXPECTS(0 <= id && id < this->GetNumberOfValues());

  void SetValue(vtkIdType id, ValueType value)
    VTK_EXPECTS(0 <= id && id < this->GetNumberOfValues())
  {
    this->Buffer->GetBuffer()[id] = value;
    this->DataChanged();
  }
 
  void SetValue(vtkIdType id, const char* value)
    VTK_EXPECTS(0 <= id && id < this->GetNumberOfValues()) VTK_EXPECTS(value != nullptr);
 
  VTK_DEPRECATED_IN_9_7_0("No longer needed")
  int GetNumberOfElementComponents() { return 0; }
  int GetElementComponentSize() const override
  {
    return static_cast<int>(sizeof(ValueType::value_type));
  }

  void InsertValue(vtkIdType id, ValueType f) VTK_EXPECTS(0 <= id);
  void InsertValue(vtkIdType id, const char* val) VTK_EXPECTS(0 <= id) VTK_EXPECTS(val != nullptr);

  vtkVariant GetVariantValue(vtkIdType idx) override;

  void SetVariantValue(vtkIdType idx, vtkVariant value) override;

  void InsertVariantValue(vtkIdType idx, vtkVariant value) override;

  vtkIdType InsertNextValue(ValueType f);
  vtkIdType InsertNextValue(const char* f) VTK_EXPECTS(f != nullptr);

  ValueType* WritePointer(vtkIdType id, vtkIdType number);

  ValueType* GetPointer(vtkIdType id) { return this->Buffer->GetBuffer() + id; }
  void* GetVoidPointer(vtkIdType id) override { return this->GetPointer(id); }

#ifdef __VTK_WRAP__
  vtkAbstractBuffer* GetBuffer() { return this->Buffer; }
#else
  vtkBuffer<ValueType>* GetBuffer() { return this->Buffer; }
#endif // __VTK_WRAP__

  void DeepCopy(vtkAbstractArray* aa) override;

  void ShallowCopy(vtkAbstractArray* src) override;

  void SetArray(
    ValueType* array, vtkIdType size, int save, int deleteMethod = VTK_DATA_ARRAY_DELETE);
  void SetVoidArray(void* array, vtkIdType size, int save) override
  {
    this->SetArray(static_cast<ValueType*>(array), size, save);
  }
  void SetVoidArray(void* array, vtkIdType size, int save, int deleteMethod) override
  {
    this->SetArray(static_cast<ValueType*>(array), size, save, deleteMethod);
  }

  void SetArrayFreeFunction(void (*callback)(void*)) override;

  unsigned long GetActualMemorySize() const override;

  VTK_DEPRECATED_IN_9_7_0("Use vtk::DataArrayValueRange, or the array directly")
  VTK_NEWINSTANCE vtkArrayIterator* NewIterator() override;

  vtkIdType GetDataSize() const override;


  vtkIdType LookupValue(vtkVariant value) override;
  void LookupValue(vtkVariant value, vtkIdList* ids) override;
 
  vtkIdType LookupValue(const ValueType& value);
  void LookupValue(const ValueType& value, vtkIdList* ids);
 
  vtkIdType LookupValue(const char* value);
  void LookupValue(const char* value, vtkIdList* ids);

  void DataChanged() override;

  VTK_DEPRECATED_IN_9_7_0("Use DataChanged() instead")
  virtual void DataElementChanged(vtkIdType id);

  void ClearLookup() override;
 
protected:
  vtkStringArray();
  ~vtkStringArray() override;

  bool ReallocateTuples(vtkIdType numTuples);

  bool EnsureAccessToTuple(vtkIdType tupleIdx);
 
  vtkBuffer<ValueType>* Buffer;

  VTK_DEPRECATED_IN_9_7_0("Use ReserveTuples")
  ValueType* ResizeAndExtend(vtkIdType sz)
  {
    this->ReserveTuples(sz);
    return this->Buffer->GetBuffer();
  }
 
private:
  vtkStringArray(const vtkStringArray&) = delete;
  void operator=(const vtkStringArray&) = delete;
 
  vtkStringArrayLookup* Lookup;
  void UpdateLookup();
};
 
// Declare vtkArrayDownCast implementations for vtkStringArray:
vtkArrayDownCast_FastCastMacro(vtkStringArray);
 
VTK_ABI_NAMESPACE_END
#endif