include/formula/vectortoken.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  */
   9
  10 #ifndef INCLUDED_FORMULA_VECTORTOKEN_HXX
  11 #define INCLUDED_FORMULA_VECTORTOKEN_HXX
  12
  13 #include <cstddef>
  14 #include <vector>
  15
  16 #include <formula/formuladllapi.h>
  17 #include <formula/token.hxx>
  18 #include <rtl/ustring.h>
  19
  20 namespace formula {
  21
  22 /**
  23  * Single unit of vector reference consists of two physical arrays.
  24  *
  25  * <p>If the whole data array consists of only numeric values, mpStringArray
  26  * will be NULL, and NaN values in the numeric array represent empty
  27  * cells.</p>
  28  *
  29  * <p>If the whole data array consists of only string values, mpNumericArray
  30  * will be NULL, and NULL values in the string array represent empty
  31  * cells.</p>
  32  *
  33  * <p>If the data array consists of numeric and string values, then both
  34  * mpNumericArray and mpStringArray will be non-NULL, and a string cell will
  35  * be represented by a non-NULL pointer value in the string array.  If the
  36  * string value is NULL, check the corresponding value in the numeric array.
  37  * If the value in the numeric array is NaN, it's an empty cell, otherwise
  38  * it's a numeric cell.</p>
  39  */
  40 struct FORMULA_DLLPUBLIC VectorRefArray
  41 {
  42     enum InitInvalid { Invalid };
  43
  44     const double* mpNumericArray;
  45     rtl_uString** mpStringArray;
  46
  47     bool mbValid;
  48
  49     VectorRefArray();
  50     VectorRefArray( InitInvalid );
  51     VectorRefArray( const double* pArray );
  52     VectorRefArray( rtl_uString** pArray );
  53     VectorRefArray( const double* pNumArray, rtl_uString** pStrArray );
  54
  55     bool isValid() const;
  56 };
  57
  58 /**
  59  * This token represents a single cell reference in a vectorized formula
  60  * calculation context.
  61  */
  62 class FORMULA_DLLPUBLIC SingleVectorRefToken final : public FormulaToken
  63 {
  64     VectorRefArray maArray;
  65     size_t mnArrayLength;
  66
  67 public:
  68     SingleVectorRefToken( const VectorRefArray& rArray, size_t nArrayLength );
  69
  70     virtual FormulaToken* Clone() const override;
  71
  72     const VectorRefArray& GetArray() const;
  73     size_t GetArrayLength() const;
  74 };
  75
  76 /**
  77  * This token represents a range reference in a vectorized formula
  78  * calculation context.
  79  */
  80 class FORMULA_DLLPUBLIC DoubleVectorRefToken final : public FormulaToken
  81 {
  82     std::vector<VectorRefArray> maArrays;
  83
  84     size_t mnArrayLength; /// length of all arrays which does not include trailing empty region.
  85     size_t mnRefRowSize; /// original reference row size. The row size may
  86                          /// change as it goes down the array if either the
  87                          /// start or end position is fixed.
  88
  89     bool mbStartFixed:1; /// whether or not the start row position is absolute.
  90     bool mbEndFixed:1; /// whether or not the end row position is absolute.
  91
  92 public:
  93     DoubleVectorRefToken(
  94         std::vector<VectorRefArray>&& rArrays, size_t nArrayLength,
  95         size_t nRefRowSize, bool bStartFixed, bool bEndFixed );
  96
  97     virtual FormulaToken* Clone() const override;
  98
  99     const std::vector<VectorRefArray>& GetArrays() const;
 100     size_t GetArrayLength() const;
 101     size_t GetRefRowSize() const;
 102     bool IsStartFixed() const;
 103     bool IsEndFixed() const;
 104 };
 105
 106 }
 107
 108 #endif
 109
 110 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */