vtkStringArray.h

Go to the documentation of this file.

/*=========================================================================

  Program:   Visualization Toolkit
  Module:    vtkStringArray.h
  Language:  C++

  Copyright 2004 Sandia Corporation.
  Under the terms of Contract DE-AC04-94AL85000, there is a non-exclusive
  license for use of this work by or on behalf of the
  U.S. Government. Redistribution and use in source and binary forms, with
  or without modification, are permitted provided that this Notice and any
  statement of authorship are reproduced on all copies.

=========================================================================*/

#ifndef vtkStringArray_h
#define vtkStringArray_h

#include "vtkCommonCoreModule.h" // For export macro
#include "vtkAbstractArray.h"
#include "vtkStdString.h" // needed for vtkStdString definition

class vtkStringArrayLookup;

class VTKCOMMONCORE_EXPORT vtkStringArray : public vtkAbstractArray
{
public:
  static vtkStringArray* New();
  vtkTypeMacro(vtkStringArray,vtkAbstractArray);
  void PrintSelf(ostream& os, vtkIndent indent) VTK_OVERRIDE;

  //
  //
  // Functions required by vtkAbstractArray
  //
  //

  int GetDataType() VTK_OVERRIDE
    { return VTK_STRING; }

  int IsNumeric() VTK_OVERRIDE { return 0; }

  void Initialize() VTK_OVERRIDE;

  int GetDataTypeSize() VTK_OVERRIDE;

  void Squeeze() VTK_OVERRIDE { this->ResizeAndExtend (this->MaxId+1); }

  int Resize(vtkIdType numTuples) VTK_OVERRIDE;

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

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

  void InsertTuples(vtkIdList *dstIds, vtkIdList *srcIds,
                            vtkAbstractArray *source) VTK_OVERRIDE;

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

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

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

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

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

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

  int Allocate( vtkIdType sz, vtkIdType ext=1000 ) VTK_OVERRIDE;

  vtkStdString &GetValue(vtkIdType id);

  void SetValue(vtkIdType id, vtkStdString value)
    { this->Array[id] = value; this->DataChanged(); }

  void SetValue(vtkIdType id, const char *value);

  void SetNumberOfTuples(vtkIdType number) VTK_OVERRIDE
    { this->SetNumberOfValues(this->NumberOfComponents* number); }

  void SetNumberOfValues(vtkIdType number) VTK_OVERRIDE;

  vtkIdType GetNumberOfValues() { return this->MaxId + 1; }

  int GetNumberOfElementComponents() { return 0; }
  int GetElementComponentSize() VTK_OVERRIDE { return static_cast<int>(sizeof(vtkStdString::value_type)); }

  void InsertValue(vtkIdType id, vtkStdString f);

  void InsertValue(vtkIdType id, const char *val);

  void SetVariantValue(vtkIdType idx, vtkVariant value) VTK_OVERRIDE;

  void InsertVariantValue(vtkIdType idx, vtkVariant value) VTK_OVERRIDE;

  vtkIdType InsertNextValue(vtkStdString f);

  vtkIdType InsertNextValue(const char *f);

  vtkStdString* WritePointer(vtkIdType id, vtkIdType number);

  vtkStdString* GetPointer(vtkIdType id) { return this->Array + id; }
  void* GetVoidPointer(vtkIdType id) VTK_OVERRIDE { return this->GetPointer(id); }

  void DeepCopy( vtkAbstractArray* aa ) VTK_OVERRIDE;

  void SetArray(vtkStdString* array, vtkIdType size, int save);
  void SetVoidArray(void* array, vtkIdType size, int save) VTK_OVERRIDE
    { this->SetArray(static_cast<vtkStdString*>(array), size, save); }
  void SetVoidArray(void* array, vtkIdType size, int save,
                    int vtkNotUsed(deleteMethod)) VTK_OVERRIDE
    { this->SetArray(static_cast<vtkStdString*>(array), size, save); }

  unsigned long GetActualMemorySize() VTK_OVERRIDE;

  VTK_NEWINSTANCE vtkArrayIterator* NewIterator() VTK_OVERRIDE;

  vtkIdType GetDataSize() VTK_OVERRIDE;


  vtkIdType LookupValue(vtkVariant value) VTK_OVERRIDE;
  void LookupValue(vtkVariant value, vtkIdList* ids) VTK_OVERRIDE;

  vtkIdType LookupValue(vtkStdString value);
  void LookupValue(vtkStdString value, vtkIdList* ids);

  vtkIdType LookupValue(const char* value);
  void LookupValue(const char* value, vtkIdList* ids);

  void DataChanged() VTK_OVERRIDE;

  virtual void DataElementChanged(vtkIdType id);

  void ClearLookup() VTK_OVERRIDE;

protected:
  vtkStringArray();
  ~vtkStringArray() VTK_OVERRIDE;

  vtkStdString* Array;   // pointer to data
  vtkStdString* ResizeAndExtend(vtkIdType sz);  // function to resize data

  int SaveUserArray;

private:
  vtkStringArray(const vtkStringArray&) VTK_DELETE_FUNCTION;
  void operator=(const vtkStringArray&) VTK_DELETE_FUNCTION;

  vtkStringArrayLookup* Lookup;
  void UpdateLookup();

};

#endif