/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */

/*

 * This file is part of the LibreOffice project.

 *

 * This Source Code Form is subject to the terms of the Mozilla Public

 * License, v. 2.0. If a copy of the MPL was not distributed with this

 * file, You can obtain one at http://mozilla.org/MPL/2.0/.

 *

 * This file incorporates work covered by the following license notice:

 *

 *   Licensed to the Apache Software Foundation (ASF) under one or more

 *   contributor license agreements. See the NOTICE file distributed

 *   with this work for additional information regarding copyright

 *   ownership. The ASF licenses this file to you under the Apache

 *   License, Version 2.0 (the "License"); you may not use this file

 *   except in compliance with the License. You may obtain a copy of

 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .

 */

#pragma once

#include "address.hxx"

#include "typedstrdata.hxx"

#include <i18nlangtag/lang.h>

#include <svx/svdtypes.hxx>

#include <rtl/ref.hxx>

#include <sal/types.h>

#include <com/sun/star/i18n/CollatorOptions.hpp>

#include <com/sun/star/sheet/CellFlags.hpp>

#include "scdllapi.h"

#include <rtl/ustring.hxx>

#include <tools/long.hxx>

#include <o3tl/unit_conversion.hxx>

#include <atomic>

// HACK: <atomic> includes <stdbool.h>, which in some Clang versions does '#define bool bool',

// which confuses clang plugins.

#undef bool

#include <memory>

#include <optional>

#include <string_view>

#include <unordered_map>

namespace com::sun::star::uno { template <typename > class Reference; }

class SfxItemSet;

class SfxViewShell;

struct ScCalcConfig;

enum class SvtScriptType : sal_uInt8;

enum class FormulaError : sal_uInt16;

enum class SvNumFormatType : sal_Int16;

#define SC_COLLATOR_IGNORES css::i18n::CollatorOptions::CollatorOptions_IGNORE_CASE

//  Calc has lots of names...

//  Clipboard names are in so3/soapp.hxx now

//  STRING_SCAPP was "scalc3", "scalc4", now just "scalc"

inline constexpr OUString STRING_SCAPP = u"scalc"_ustr;

inline constexpr OUString STRING_STANDARD = u"Standard"_ustr;

// Have the dreaded programmatic filter name defined in one place.

inline constexpr OUString SC_TEXT_CSV_FILTER_NAME = u"Text - txt - csv (StarCalc)"_ustr;

inline constexpr OUString SC_HTML_FILTER_NAME = u"HTML (StarCalc)"_ustr;

inline constexpr OUString SC_HTML_WEBQ_FILTER_NAME = u"calc_HTML_WebQuery"_ustr;

inline constexpr OUString SC_LOTUS_FILTER_NAME = u"Lotus"_ustr;

inline constexpr OUString SC_DBASE_FILTER_NAME = u"dBase"_ustr;

inline constexpr OUString SC_DIF_FILTER_NAME = u"DIF"_ustr;

inline constexpr OUString SC_SC50_FILTER_NAME = u"StarCalc 5.0"_ustr;

inline constexpr OUString SC_SOXML_FILTER_NAME = u"StarOffice XML (Calc)"_ustr;

inline constexpr OUString SC_QPRO6_FILTER_NAME = u"Quattro Pro 6.0"_ustr;

inline constexpr OUString SC_XL4_FILTER_NAME = u"MS Excel 4.0"_ustr;

inline constexpr OUString SC_XL4TMPL_FILTER_NAME = u"MS Excel 4.0 Vorlage/Template"_ustr;

inline constexpr OUString SC_XL5_FILTER_NAME = u"MS Excel 5.0/95"_ustr;

inline constexpr OUString SC_XL5TMPL_FILTER_NAME = u"MS Excel 5.0/95 Vorlage/Template"_ustr;

inline constexpr OUString SC_XL95_FILTER_NAME = u"MS Excel 95"_ustr;

inline constexpr OUString SC_XL95TMPL_FILTER_NAME = u"MS Excel 95 Vorlage/Template"_ustr;

inline constexpr OUString SC_XL97_FILTER_NAME = u"MS Excel 97"_ustr;

inline constexpr OUString SC_XL97TMPL_FILTER_NAME = u"MS Excel 97 Vorlage/Template"_ustr;

inline constexpr OUString SC_SYLK_FILTER_NAME = u"SYLK"_ustr;

inline constexpr OUString SC_RTF_FILTER_NAME = u"Rich Text Format (StarCalc)"_ustr;

// characters

const sal_Unicode CHAR_NBSP     = 0x00A0;

const sal_Unicode CHAR_SHY      = 0x00AD;

const sal_Unicode CHAR_ZWSP     = 0x200B;

const sal_Unicode CHAR_LRM      = 0x200E;

const sal_Unicode CHAR_RLM      = 0x200F;

const sal_Unicode CHAR_NBHY     = 0x2011;

const sal_Unicode CHAR_WJ       = 0x2060;

const sal_Unicode CHAR_NNBSP    = 0x202F; //NARROW NO-BREAK SPACE

#define MINDOUBLE   1.7e-307

#define MAXDOUBLE   1.7e307

const sal_uInt16 MINZOOM = 20;

const sal_uInt16 MAXZOOM = 400;

const SCSIZE MAXSUBTOTAL        = 3;

// ~105.88 twip, i.e. about 2 times narrower than o3tl::Length::ch, which is 210 twip

inline constexpr auto TWIPS_PER_CHAR = o3tl::toTwips(1 / 13.6, o3tl::Length::in);

inline constexpr sal_Int32 STD_COL_WIDTH = o3tl::convert(64, o3tl::Length::pt, o3tl::Length::twip);

inline constexpr sal_Int32 STD_EXTRA_WIDTH = o3tl::convert(2, o3tl::Length::mm, o3tl::Length::twip);

inline constexpr sal_Int32 MAX_EXTRA_WIDTH = o3tl::convert(42, o3tl::Length::cm, o3tl::Length::twip);

inline constexpr sal_Int32 MAX_EXTRA_HEIGHT = o3tl::convert(42, o3tl::Length::cm, o3tl::Length::twip);

inline constexpr sal_Int32 MAX_COL_WIDTH = o3tl::convert(1, o3tl::Length::m, o3tl::Length::twip);

inline constexpr sal_Int32 MAX_ROW_HEIGHT = o3tl::convert(1, o3tl::Length::m, o3tl::Length::twip);

                                    /* standard row height: text + margin - STD_ROWHEIGHT_DIFF */

#define STD_ROWHEIGHT_DIFF  23

namespace sc

{

    constexpr ::tools::Long TwipsToEvenHMM( ::tools::Long nTwips ) { return o3tl::convert(nTwips, 127, 144) * 2; }

}

                                    // standard size as OLE server (cells)

#define OLE_STD_CELLS_X     4

#define OLE_STD_CELLS_Y     5

                                    // repaint flags (for messages)

enum class PaintPartFlags {

    NONE          = 0x00,

    Grid          = 0x01,

    Top           = 0x02,

    Left          = 0x04,

    Extras        = 0x08,

    Marks         = 0x10,

    Objects       = 0x20,

    Size          = 0x40,

    All           = Grid | Top | Left | Extras | Objects | Size,

};

namespace o3tl {

    template<> struct typed_flags<PaintPartFlags> : is_typed_flags<PaintPartFlags, 0x07f> {};

}

                                    // flags for columns / rows

enum class CRFlags : sal_uInt8 {

    // Filtered always together with Hidden

    // Filtered and ManualSize only valid for rows

    NONE        = 0x00,

    Hidden      = 0x01,

    ManualBreak = 0x02,

    Filtered    = 0x04,

    ManualSize  = 0x08,

    All         = Hidden | ManualBreak | Filtered | ManualSize

};

namespace o3tl {

    template<> struct typed_flags<CRFlags> : is_typed_flags<CRFlags, 0x0f> {};

}

enum class ScBreakType {

    NONE   = 0x00,

    Page   = 0x01,

    Manual = 0x02

};

namespace o3tl {

    template<> struct typed_flags<ScBreakType> : is_typed_flags<ScBreakType, 0x03> {};

}

enum class InsertDeleteFlags : sal_Int32

{

    NONE             = 0x0000,

    VALUE            = css::sheet::CellFlags::VALUE,      /// 0x0001 Numeric values (and numeric results if InsertDeleteFlags::FORMULA is not set).

    DATETIME         = css::sheet::CellFlags::DATETIME,   /// 0x0002 Dates, times, datetime values.

    STRING           = css::sheet::CellFlags::STRING,     /// 0x0004 Strings (and string results if InsertDeleteFlags::FORMULA is not set).

    NOTE             = css::sheet::CellFlags::ANNOTATION, /// 0x0008 Cell notes.

    FORMULA          = css::sheet::CellFlags::FORMULA,    /// 0x0010 Formula cells.

    HARDATTR         = css::sheet::CellFlags::HARDATTR,   /// 0x0020 Hard cell attributes.

    STYLES           = css::sheet::CellFlags::STYLES,     /// 0x0040 Cell styles.

    OBJECTS          = css::sheet::CellFlags::OBJECTS,    /// 0x0080 Drawing objects.

    EDITATTR         = css::sheet::CellFlags::EDITATTR,   /// 0x0100 Rich-text attributes.

    /// No value yet for css::sheet::CellFlags::FORMATTED (0x0200)

    OUTLINE          = 0x0800,   /// Sheet / outlining (grouping) information

    SPARKLINES       = 0x4000,   /// Sparklines in a cell.

    NOCAPTIONS       = 0x8000,   /// Internal use only (undo etc.): do not copy/delete caption objects of cell notes.

    ADDNOTES         = 0x0400,   /// Internal use only (copy from clip): do not delete existing cell contents when pasting notes.

    SPECIAL_BOOLEAN  = 0x1000,

    FORGETCAPTIONS   = 0x2000,   /// Internal use only (d&d undo): do not delete caption objects of cell notes.

    ATTRIB           = HARDATTR | STYLES,

    CONTENTS         = VALUE | DATETIME | STRING | NOTE | FORMULA | OUTLINE | SPARKLINES,

    // tdf#116127 - add EDITATTR to ALL flags in order to check for valid function inputs

    ALL              = CONTENTS | ATTRIB | OBJECTS | SPARKLINES | EDITATTR,

    /// Copy flags for auto/series fill functions: do not touch notes and drawing objects.

    AUTOFILL         = ALL & ~(NOTE | OBJECTS)

};

namespace o3tl

{

    template<> struct typed_flags<InsertDeleteFlags> : is_typed_flags<InsertDeleteFlags, 0xfdff> {};

}

static_assert((InsertDeleteFlags::ATTRIB & InsertDeleteFlags::CONTENTS) == InsertDeleteFlags::NONE, "these must match");

enum class ScPasteFunc {

    NONE, ADD, SUB, MUL, DIV

};

                                        // bits for HasAttr

enum class HasAttrFlags {

    NONE            = 0x0000,

    Lines           = 0x0001,

    Merged          = 0x0002,

    Overlapped      = 0x0004,

    Protected       = 0x0008,

    Shadow          = 0x0010,

    NeedHeight      = 0x0020,

    ShadowRight     = 0x0040,

    ShadowDown      = 0x0080,

    AutoFilter      = 0x0100,

    Conditional     = 0x0200,

    Rotate          = 0x0400,

    NotOverlapped   = 0x0800,

    RightOrCenter   = 0x1000,   // right or centered logical alignment

};

namespace o3tl {

    template<> struct typed_flags<HasAttrFlags> : is_typed_flags<HasAttrFlags, 0x1fff> {};

}

// Layer id's for drawing.

// These are both id's and positions.

inline constexpr SdrLayerID SC_LAYER_FRONT   (0);

inline constexpr SdrLayerID SC_LAYER_BACK    (1);

inline constexpr SdrLayerID SC_LAYER_INTERN  (2);

inline constexpr SdrLayerID SC_LAYER_CONTROLS(3);

inline constexpr SdrLayerID SC_LAYER_HIDDEN  (4);

//  link tables

enum class ScLinkMode {

    NONE, NORMAL, VALUE

};

                                        //  input

enum class ScEnterMode {

    NORMAL, BLOCK, MATRIX

};

                                        //  step = 10pt, max. indention = 100 steps

#define SC_INDENT_STEP      200

enum class ScScenarioFlags{             //  scenario flags

    NONE       = 0,

    CopyAll    = 1,

    ShowFrame  = 2,

    PrintFrame = 4,

    TwoWay     = 8,

    Attrib     = 16,

    Value      = 32,

    Protected  = 64

};

namespace o3tl {

    template<> struct typed_flags<ScScenarioFlags> : is_typed_flags<ScScenarioFlags, 127> {};

}

enum class SubtotalFlags {

    NONE              = 0x00,

    IgnoreNestedStAg  = 0x08,

    IgnoreErrVal      = 0x04,

    IgnoreHidden      = 0x02,

    IgnoreFiltered    = 0x01

};

namespace o3tl {

    template<> struct typed_flags<SubtotalFlags> : is_typed_flags<SubtotalFlags, 0x0f> {};

}

enum class ScCloneFlags{

/** Default cell clone flags: do not start listening, do not adjust 3D refs to

    old position, clone note captions of cell notes. */

    Default          = 0x0000,

/** If set, cloned formula cells will start to listen to the document. */

    StartListening   = 0x0001,

/** If set, absolute refs will not transformed to external references */

    NoMakeAbsExternal = 0x0002,

/** If set, global named expressions will be converted to sheet-local named

    expressions. */

    NamesToLocal   = 0x0004,

    /** If set, cross-sheet references will be adjusted during copying to

    compensate for the difference of the tab index between source and

    destination cells. */

    AdjustCrossSheetRefs = 0x0008

};

namespace o3tl

{

    template<> struct typed_flags<ScCloneFlags> : is_typed_flags<ScCloneFlags, 0x000f> {};

}

enum CellType

    {

        CELLTYPE_NONE,

        CELLTYPE_VALUE,

        CELLTYPE_STRING,

        CELLTYPE_FORMULA,

        CELLTYPE_EDIT,

    };

enum class DelCellCmd

    {

        CellsUp,

        CellsLeft,

        Rows,

        Cols,

        NONE

    };

enum InsCellCmd

    {

        INS_CELLSDOWN,

        INS_CELLSRIGHT,

        INS_INSROWS_BEFORE,

        INS_INSCOLS_BEFORE,

        INS_NONE,

        INS_INSROWS_AFTER,

        INS_INSCOLS_AFTER

    };

enum UpdateRefMode

    {

        URM_INSDEL,

        URM_COPY,

        URM_MOVE,

        URM_REORDER

    };

enum FillDir

    {

        FILL_TO_BOTTOM,

        FILL_TO_RIGHT,

        FILL_TO_TOP,

        FILL_TO_LEFT

    };

enum FillCmd

    {

        FILL_SIMPLE,

        FILL_LINEAR,

        FILL_GROWTH,

        FILL_DATE,

        FILL_AUTO

    };

enum ScMoveDirection

{

    SC_MOVE_RIGHT,

    SC_MOVE_LEFT,

    SC_MOVE_UP,

    SC_MOVE_DOWN

};

enum FillDateCmd

    {

        FILL_DAY,

        FILL_WEEKDAY,

        FILL_MONTH,

        FILL_END_OF_MONTH,

        FILL_YEAR

    };

enum ScDirection

    {

        DIR_BOTTOM,

        DIR_RIGHT,

        DIR_TOP,

        DIR_LEFT

    };

enum ScSizeMode

    {

        SC_SIZE_DIRECT,             // set size or hide if value is 0

        SC_SIZE_OPTIMAL,            // set optimal size for everything

        SC_SIZE_SHOW,               // show with original size

        SC_SIZE_VISOPT,             // set optimal size only if visible

        SC_SIZE_ORIGINAL            // only set size, don't change visible flag

    };

enum ScInputMode

    {

        SC_INPUT_NONE,

        SC_INPUT_TYPE,              // input, while not in inplace mode

        SC_INPUT_TABLE,             // text cursor in the table

        SC_INPUT_TOP                // text cursor in the input line

    };

enum ScVObjMode                     // output modes of objects on a page

{

    VOBJ_MODE_SHOW,

    VOBJ_MODE_HIDE

};

enum ScAnchorType                   // anchor of a character object

{

    SCA_CELL,                       // anchor to cell, move with cell

    SCA_CELL_RESIZE,                // anchor to cell, move and resize with cell

    SCA_PAGE,                       // anchor to page, independent of any cells

    SCA_DONTKNOW                    // for multi selection

};

enum ScGetDBMode

{

    SC_DB_MAKE,         ///< create "untitled" (if necessary)

    SC_DB_AUTOFILTER,   ///< force use of sheet-local instead of document global anonymous range

    SC_DB_IMPORT,       ///< create "Importx" (if necessary)

    SC_DB_OLD           ///< don't create

};

/// For ScDBFunc::GetDBData()

enum class ScGetDBSelection

{

    /** Keep selection as is, expand to used data area if no selection. */

    Keep,

    /** Shrink selection to actually used data area within the selection. */

    ShrinkToUsedData,

    /** If only one row or portion thereof is selected, shrink row to used data

        columns and select further rows down until end of data. If an area is

        selected, shrink rows to actually used columns. Else, no selection,

        expand to used data area. */

    RowDown,

    /** Behave as if the range corresponding to a ScDBData area was selected,

        for API use. */

    ForceMark

};

enum ScLkUpdMode    // modes for updating links

{

    LM_ALWAYS,

    LM_NEVER,

    LM_ON_DEMAND,

    LM_UNKNOWN

};

// enum with values equal to old DBObject enum from sdb

enum ScDBObject

{

    ScDbTable,

    ScDbQuery

};

namespace sc {

enum class EditAction

{

    Unknown,

    InsertColumnsBefore,

    InsertColumnsAfter,

    InsertRowsBefore,

    InsertRowsAfter,

    DeleteColumns,

    DeleteRows,

    UpdatePivotTable

};

}

struct ScImportParam

{

    SCCOL           nCol1;

    SCROW           nRow1;

    SCCOL           nCol2;

    SCROW           nRow2;

    bool            bImport;

    OUString aDBName;                    // alias of data base

    OUString aStatement;

    bool            bNative;

    bool            bSql;                       // statement or name?

    sal_uInt8       nType;                      // enum DBObject

    ScImportParam();

    ScImportParam( const ScImportParam& r );

    ~ScImportParam();

    ScImportParam&  operator=   ( const ScImportParam& r );

    bool            operator==  ( const ScImportParam& r ) const;

};

// Formula data replacement character for a pair of parentheses at end of

// function name, to force sorting parentheses before all other characters.

// Collation may treat parentheses differently.

inline constexpr sal_Unicode cParenthesesReplacement = 0x0001;

struct InputHandlerFunctionNames

{

    ScTypedCaseStrSet       maFunctionData;

    ScTypedCaseStrSet       maFunctionDataPara;

    std::set<sal_Unicode>   maFunctionChar;

};

class ScDocShell;

class SvxSearchItem;

class ScAutoFormat;

class LegacyFuncCollection;

class ScUnoAddInCollection;

class ScUserList;

class SvxBrushItem;

class ScFunctionList;

class ScFunctionMgr;

class SfxItemPool;

class EditTextObject;

class SfxObjectShell;

class SvNumberFormatter;

struct ScInterpreterContext;

class ScUnitConverter;

class CharClass;

class LocaleDataWrapper;

class SvtSysLocale;

class CalendarWrapper;

class CollatorWrapper;

class ScFieldEditEngine;

namespace com::sun::star {

    namespace lang {

        struct Locale;

    }

    namespace i18n {

        class XOrdinalSuffix;

    }

}

namespace utl {

    class TransliterationWrapper;

}

namespace sc {

    class SharedStringPoolPurge;

}

class ScGlobal

{

    static std::unique_ptr<SvxSearchItem> xSearchItem;

    static std::unique_ptr<ScAutoFormat> xAutoFormat;

    static std::atomic<LegacyFuncCollection*> pLegacyFuncCollection;

    static std::atomic<ScUnoAddInCollection*> pAddInCollection;

    static std::unique_ptr<ScUserList> xUserList;

    static OUString         aStrClipDocName;

    static std::unique_ptr<SvxBrushItem> xEmptyBrushItem;

    static std::unique_ptr<SvxBrushItem> xButtonBrushItem;

    static std::unordered_map<OUString, std::unique_ptr<ScFunctionList>> xStarCalcFunctionList;

    static std::unordered_map<OUString, std::unique_ptr<ScFunctionMgr>> xStarCalcFunctionMgr;

    static std::atomic<ScUnitConverter*> pUnitConverter;

    static std::unique_ptr<SvNumberFormatter> xEnglishFormatter;          // for UNO / XML export

    static css::uno::Reference< css::i18n::XOrdinalSuffix> xOrdinalSuffix;

    static std::optional<CalendarWrapper>    oCalendar;

    static std::atomic<CollatorWrapper*>     pCaseCollator;

    static std::atomic<CollatorWrapper*>     pCollator;

    static std::atomic<::utl::TransliterationWrapper*> pTransliteration;

    static std::atomic<::utl::TransliterationWrapper*> pCaseTransliteration;

    static std::atomic<css::lang::Locale*>   pLocale;

    static std::unique_ptr<ScFieldEditEngine> xFieldEditEngine;

    static std::atomic<sc::SharedStringPoolPurge*> pSharedStringPoolPurge;

    static std::unordered_map<OUString, InputHandlerFunctionNames> maInputHandlerFunctionNames;

    static void                 InitPPT();

public:

    static std::optional<SvtSysLocale> oSysLocale;

    SC_DLLPUBLIC static const LocaleDataWrapper& getLocaleData();

    SC_DLLPUBLIC static const CharClass& getCharClass();

    static CalendarWrapper&     GetCalendar();

    /// case-insensitive collator

    SC_DLLPUBLIC static CollatorWrapper& GetCollator();

    /// case-sensitive collator

    static CollatorWrapper&     GetCaseCollator();

    static CollatorWrapper&     GetCollator(bool bCaseSensitive);

    static css::lang::Locale&   GetLocale();

    SC_DLLPUBLIC static ::utl::TransliterationWrapper& GetTransliteration();

    static ::utl::TransliterationWrapper& GetCaseTransliteration();

    static ::utl::TransliterationWrapper& GetTransliteration(bool bCaseSensitive);

    SC_DLLPUBLIC static LanguageType            eLnge;

    static constexpr sal_Unicode cListDelimiter = ',';

    static const OUString&      GetClipDocName();

    static void                 SetClipDocName( const OUString& rNew );

    SC_DLLPUBLIC static const SvxSearchItem&    GetSearchItem();

    SC_DLLPUBLIC static void                    SetSearchItem( const SvxSearchItem& rNew );

    SC_DLLPUBLIC static ScAutoFormat*       GetOrCreateAutoFormat();

    SC_DLLPUBLIC static void                ResetAutoFormat();

    static void                 ClearAutoFormat(); //BugId 54209

    static LegacyFuncCollection*      GetLegacyFuncCollection();

    SC_DLLPUBLIC static ScUnoAddInCollection* GetAddInCollection();

    SC_DLLPUBLIC static bool IsValidExternal(const OUString& rAddIn);

    SC_DLLPUBLIC static ScUserList&         GetUserList();

    static void                 SetUserList( const ScUserList* pNewList );

    /**

     * Open the specified URL.

     * @param bIgnoreSettings - If true, ignore security settings (Ctrl-Click) and just open the URL.

     */

    SC_DLLPUBLIC static void OpenURL(const OUString& rURL, const OUString& rTarget, bool bIgnoreSettings = false);

    /// Whether the URL can be opened according to current security options (Click/Ctrl-Click)

    static bool                 ShouldOpenURL();

    SC_DLLPUBLIC static OUString            GetAbsDocName( const OUString& rFileName,

                                                const SfxObjectShell* pShell );

    SC_DLLPUBLIC static OUString            GetDocTabName( std::u16string_view rFileName,

                                                std::u16string_view rTabName );

    SC_DLLPUBLIC static sal_uInt32 GetStandardFormat( ScInterpreterContext&, sal_uInt32 nFormat, SvNumFormatType nType );

    /// Horizontal pixel per twips factor.

    SC_DLLPUBLIC static double              nScreenPPTX;

    /// Vertical pixel per twips factor.

    SC_DLLPUBLIC static double              nScreenPPTY;

    static rtl::Reference<ScDocShell> xDrawClipDocShellRef;

    static sal_uInt16           nDefFontHeight;

    SC_DLLPUBLIC static sal_uInt16           nStdRowHeight;

    SC_DLLPUBLIC static ::tools::Long                nLastRowHeightExtra;

    static ::tools::Long             nLastColWidthExtra;

    SC_DLLPUBLIC static void Init();                     // during start up

    static void             InitAddIns();

    SC_DLLPUBLIC static void Clear();                    // at the end of the program

    static void             InitTextHeight(SfxItemPool& rPool);

    static const SvxBrushItem* GetEmptyBrushItem() { return xEmptyBrushItem.get(); }

    static SvxBrushItem*    GetButtonBrushItem();

    static bool             HasStarCalcFunctionList();

    static ScFunctionList*  GetStarCalcFunctionList();

    static ScFunctionMgr*   GetStarCalcFunctionMgr();

    static void             ResetFunctionList();

    static const InputHandlerFunctionNames& GetInputHandlerFunctionNames();

    static OUString         GetErrorString(FormulaError nErrNumber);

    static OUString         GetLongErrorString(FormulaError nErrNumber);

    static bool             EETextObjEqual( const EditTextObject* pObj1,

                                            const EditTextObject* pObj2 );

    static bool             CheckWidthInvalidate( bool& bNumFormatChanged,

                                                  const SfxItemSet& rNewAttrs,

                                                  const SfxItemSet& rOldAttrs );

    static bool             HasAttrChanged( const SfxItemSet& rNewAttrs,

                                            const SfxItemSet& rOldAttrs,

                                            const sal_uInt16      nWhich );

    static bool IsValidOOXMLError(FormulaError nErrNumber);

    static ScUnitConverter* GetUnitConverter();

    /// strchr() functionality on unicode, as long as we need it for FormulaToken etc.

    static const sal_Unicode* UnicodeStrChr( const sal_Unicode* pStr, sal_Unicode c );

    static sal_Unicode ToUpperAlpha( sal_Unicode c )

        { return ( c >= 'a' && c <= 'z' ) ? ( c-'a'+'A' ) : c; }

    /** Adds the string rToken to rTokenList, using a list separator character.

        @param rTokenList  The string list where the token will be appended to.

        @param rToken  The token string to append to the token list.

        @param cSep  The character to separate the tokens.

        @param nSepCount  Specifies how often cSep is inserted between two tokens.

        @param bForceSep  true = Always insert separator; false = Only, if not at begin or end. */

    SC_DLLPUBLIC static OUString addToken(

                                std::u16string_view rTokenList, std::u16string_view rToken,

                                sal_Unicode cSep, sal_Int32 nSepCount = 1,

                                bool bForceSep = false );

    /** Returns true, if the first and last character of the string is cQuote. */

    SC_DLLPUBLIC static bool             IsQuoted( std::u16string_view rString, sal_Unicode cQuote );

    /** Inserts the character cQuote at beginning and end of rString.

        @param bEscapeEmbedded      If <TRUE/>, embedded quote characters are

                                    escaped by doubling them.

     */

    SC_DLLPUBLIC static void             AddQuotes( OUString& rString, sal_Unicode cQuote, bool bEscapeEmbedded = true );

    /** Erases the character cQuote from rString, if it exists at beginning AND end.

        @param bUnescapeEmbedded    If <TRUE/>, embedded doubled quote characters

                                    are unescaped by replacing them with a

                                    single instance.

     */

    SC_DLLPUBLIC static void             EraseQuotes( OUString& rString, sal_Unicode cQuote, bool bUnescapeEmbedded = true );

    /** Finds an unquoted instance of cChar in rString, starting at

        offset nStart. Unquoted instances may occur when concatenating two

        quoted strings with a separator, for example, 's1':'s2'. Embedded

        quotes have to be escaped by being doubled. Caller must ensure that

        nStart points into an unquoted range or the opening quote. Specialty:

        if cChar=='\'' the first quote character from nStart on is found.

        @returns offset if found, else -1

     */

    SC_DLLPUBLIC static sal_Int32   FindUnquoted( const OUString& rString, sal_Unicode cChar, sal_Int32 nStart = 0 );

    /** Finds an unquoted instance of cChar in null-terminated pString. Same

        semantics as FindUnquoted( const String&, ...)

        @returns: pointer to cChar if found, else NULL

     */

    SC_DLLPUBLIC static const sal_Unicode* FindUnquoted( const sal_Unicode* pString, sal_Unicode cChar );

    static  rtl_TextEncoding GetEncodingValue( std::u16string_view rEncoding );

    static  OUString        GetEncodingString( rtl_TextEncoding eVal );

    /// a "ReadOnly" formatter for UNO/XML export

    static  SvNumberFormatter*  GetEnglishFormatter();

    static bool IsSystemRTL();                      // depending on system language

    static LanguageType GetEditDefaultLanguage();   // for EditEngine::SetDefaultLanguage

    SC_DLLPUBLIC static SvtScriptType GetDefaultScriptType();             // for all WEAK characters

    /** Map ATTR_((CJK|CTL)_)?FONT_... to proper WhichIDs.

        If more than one SvtScriptType::... values are or'ed together, prefers

        first COMPLEX, then ASIAN */

    SC_DLLPUBLIC static sal_uInt16 GetScriptedWhichID( SvtScriptType nScriptType, sal_uInt16 nWhich );

    /** Adds a language item to the item set, if the number format item contains

        a language that differs from its parent's language. */

    SC_DLLPUBLIC static void             AddLanguage( SfxItemSet& rSet, const SvNumberFormatter& rFormatter );

    /** Obtain the ordinal suffix for a number according to the system locale */

    static OUString         GetOrdinalSuffix( sal_Int32 nNumber);

    static sc::SharedStringPoolPurge& GetSharedStringPoolPurge();

    /** Replaces the first occurrence of rPlaceholder in rString with

        rReplacement, or if rPlaceholder is not found appends one space if

        rString does not end in a space and appends rReplacement.

        Meant to be used with resource strings ala "Column %1" where a

        translation may have omitted the %1 placeholder and a simple

        replacement would end up with nothing replaced so no column indicator

        in the result string.

     */

    SC_DLLPUBLIC static OUString    ReplaceOrAppend( const OUString& rString,

                                                     std::u16string_view rPlaceholder,

                                                     const OUString& rReplacement );

    /** Convert string content to numeric value.

        In any case, if rError is set 0.0 is returned.

        If nStringNoValueError is FormulaError::CellNoValue, that is unconditionally

        assigned to rError and 0.0 is returned. The caller is expected to

        handle this situation. Used by the interpreter.

        Usually FormulaError::NoValue is passed as nStringNoValueError.

        Otherwise, depending on the string conversion configuration different

        approaches are taken:

        For ScCalcConfig::StringConversion::ILLEGAL

        The error value passed in nStringNoValueError is assigned to rError

        (and 0.0 returned).

        For ScCalcConfig::StringConversion::ZERO

        A zero value is returned and no error assigned.

        For ScCalcConfig::StringConversion::LOCALE

        If the string is empty or consists only of spaces, if "treat empty

        string as zero" is set 0.0 is returned, else nStringNoValueError

        assigned to rError (and 0.0 returned).

        Else a non-empty string is passed to the number formatter's scanner to

        be parsed locale dependent. If that does not detect a numeric value

        nStringNoValueError is assigned to rError (and 0.0 returned).

        If no number formatter was passed, the conversion falls back to

        UNAMBIGUOUS.

        For ScCalcConfig::StringConversion::UNAMBIGUOUS

        If the string is empty or consists only of spaces, if "treat empty

        string as zero" is set 0.0 is returned, else nStringNoValueError

        assigned to rError (and 0.0 returned).

        If the string is not empty the following conversion rules are applied:

        Converted are only integer numbers including exponent, and ISO 8601 dates

        and times in their extended formats with separators. Anything else,

        especially fractional numeric values with decimal separators or dates other

        than ISO 8601 would be locale dependent and is a no-no. Leading and

        trailing blanks are ignored.

        The following ISO 8601 formats are converted:

        CCYY-MM-DD

        CCYY-MM-DDThh:mm

        CCYY-MM-DDThh:mm:ss

        CCYY-MM-DDThh:mm:ss,s

        CCYY-MM-DDThh:mm:ss.s

        hh:mm

        hh:mm:ss

        hh:mm:ss,s

        hh:mm:ss.s

        The century CC may not be omitted and the two-digit year setting is not

        taken into account. Instead of the T date and time separator exactly one

        blank may be used.

        If a date is given, it must be a valid Gregorian calendar date. In this

        case the optional time must be in the range 00:00 to 23:59:59.99999...

        If only time is given, it may have any value for hours, taking elapsed time

        into account; minutes and seconds are limited to the value 59 as well.

        If the string can not be converted to a numeric value, the error value

        passed in nStringNoValueError is assigned to rError.

        @param rStr

            The string to be converted.

        @param rConfig

            The calculation configuration.

        @param rError

            Contains the error on return, if any. If an error was set before

            and the conversion did not result in an error, still 0.0 is

            returned.

        @param nStringNoValueError

            The error value to be assigned to rError if string could not be

            converted to number.

        @param pFormatter

            The number formatter to use in case of

            ScCalcConfig::StringConversion::LOCALE. Can but should not be

            nullptr in which case conversion falls back to

            ScCalcConfig::StringConversion::UNAMBIGUOUS and if a date is

            detected the null date is assumed to be the standard 1899-12-30

            instead of the configured null date.

        @param rCurFmtType

            Can be assigned a format type in case a date or time or date+time

            string was converted, e.g. SvNumFormatType::DATE or

            SvNumFormatType::TIME or a combination thereof.

     */

    static double ConvertStringToValue( const OUString& rStr, const ScCalcConfig& rConfig,

            FormulaError & rError, FormulaError nStringNoValueError,

            ScInterpreterContext& rContext, SvNumFormatType & rCurFmtType );

    /// Calc's threaded group calculation is in progress.

    SC_DLLPUBLIC static bool bThreadedGroupCalcInProgress;

};

// maybe move to dbdata.hxx (?):

enum ScQueryOp

    {

        SC_EQUAL,

        SC_LESS,

        SC_GREATER,

        SC_LESS_EQUAL,

        SC_GREATER_EQUAL,

        SC_NOT_EQUAL,

        SC_TOPVAL,

        SC_BOTVAL,

        SC_TOPPERC,

        SC_BOTPERC,

        SC_CONTAINS,

        SC_DOES_NOT_CONTAIN,

        SC_BEGINS_WITH,

        SC_DOES_NOT_BEGIN_WITH,

        SC_ENDS_WITH,

        SC_DOES_NOT_END_WITH

    };

enum ScQueryConnect

    {

        SC_AND,

        SC_OR

    };

enum ScSubTotalFunc : sal_Int16

    {

        SUBTOTAL_FUNC_NONE  = 0,

        SUBTOTAL_FUNC_AVE   = 1,

        SUBTOTAL_FUNC_CNT   = 2,

        SUBTOTAL_FUNC_CNT2  = 3,

        SUBTOTAL_FUNC_MAX   = 4,

        SUBTOTAL_FUNC_MIN   = 5,

        SUBTOTAL_FUNC_PROD  = 6,

        SUBTOTAL_FUNC_STD   = 7,

        SUBTOTAL_FUNC_STDP  = 8,

        SUBTOTAL_FUNC_SUM   = 9,

        SUBTOTAL_FUNC_VAR   = 10,

        SUBTOTAL_FUNC_VARP  = 11,

        SUBTOTAL_FUNC_MED   = 12,

        SUBTOTAL_FUNC_SELECTION_COUNT = 13

    };

enum ScAggregateFunc

    {

        AGGREGATE_FUNC_AVE     = 1,

        AGGREGATE_FUNC_CNT     = 2,

        AGGREGATE_FUNC_CNT2    = 3,

        AGGREGATE_FUNC_MAX     = 4,

        AGGREGATE_FUNC_MIN     = 5,

        AGGREGATE_FUNC_PROD    = 6,

        AGGREGATE_FUNC_STD     = 7,

        AGGREGATE_FUNC_STDP    = 8,

        AGGREGATE_FUNC_SUM     = 9,

        AGGREGATE_FUNC_VAR     = 10,

        AGGREGATE_FUNC_VARP    = 11,

        AGGREGATE_FUNC_MEDIAN  = 12,

        AGGREGATE_FUNC_MODSNGL = 13,

        AGGREGATE_FUNC_LARGE   = 14,

        AGGREGATE_FUNC_SMALL   = 15,

        AGGREGATE_FUNC_PERCINC = 16,

        AGGREGATE_FUNC_QRTINC  = 17,

        AGGREGATE_FUNC_PERCEXC = 18,

        AGGREGATE_FUNC_QRTEXC  = 19

    };

class ScArea;

struct ScConsolidateParam

{

    SCCOL           nCol;                   // cursor position /

    SCROW           nRow;                   // or start of destination area respectively

    SCTAB           nTab;

    ScSubTotalFunc  eFunction;

    sal_uInt16      nDataAreaCount;         // number of data areas

    std::unique_ptr<ScArea[]> pDataAreas; // array of pointers into data areas

    bool            bByCol;

    bool            bByRow;

    bool            bReferenceData;         // reference source data

    ScConsolidateParam();

    ScConsolidateParam( const ScConsolidateParam& r );

    ~ScConsolidateParam();

    ScConsolidateParam& operator=       ( const ScConsolidateParam& r );

    bool                operator==      ( const ScConsolidateParam& r ) const;

    void                Clear           (); // = ClearDataAreas()+Members

    void                ClearDataAreas  ();

    void                SetAreas        ( std::unique_ptr<ScArea[]> pAreas, sal_uInt16 nCount );

};

extern SfxViewShell* pScActiveViewShell;

extern sal_uInt16 nScClickMouseModifier;

extern sal_uInt16 nScFillModeMouseModifier;

/* vim:set shiftwidth=4 softtabstop=4 expandtab: */