StringTools.h

#ifndef STRING_TOOLS_H
#define STRING_TOOLS_H
 
#include <locale.h>
 
BEGIN_MOOTOOLS_NAMESPACE
 
class DLL_TOOLSFUNCTION CSwitchLocale
{
    int category;
    CXString prevloc;
 
public:
    CSwitchLocale(int category = LC_ALL, LPCTSTR newlocal = _T("English"));
    ~CSwitchLocale();
};
 
class DLL_TOOLSFUNCTION CXStringMatch
{
public:
    typedef enum Mode
    {
        REGULAR_EXPRESSION = 1,
        MATCH_ONE_WORD,
        MATCH_ALL_WORDS,
    } Mode;
 
protected:
    typedef enum _Operator
    {
        NONE_OPERATOR = 0,
        OR_OPERATOR = 1,
        AND_OPERATOR = 2,
        AND_NOT_OPERATOR = 3
    } Operator;
 
    typedef struct WordOperation
    {
        CXString word;
        Operator logop;
        bool result;
    } WordOperation;
 
    static CHashTable<TCHAR> hashChar;
    CXArray<WordOperation, WordOperation> expression;
    Mode mode;
    bool matchCase, wholeStringMatch;
 
    bool IsChar(const CXString& txt, char lookFor, int index);
    bool InitExpression(const CXString& lookWhat, Mode mode);
    // int ReplaceCharBySpecialChar(CXString& txt, TCHAR removeChar);
    void RemoveSpecialChar(CXString& txt, TCHAR exceptChar = 0);
    bool ExtractWords(CXString& txt);
    bool AddExpression(const CXString& word, Operator logop);
    bool ShouldRecurse(const CXString& word);
    bool InternalMatch(const CXStringArray& lookIn, Mode mode);
    bool MatchWord(const CXString& lookWhat, const CXStringArray& lookIn);
 
public:
    CXStringMatch();
 
    // Use these methods to perform a same search on different items
    bool PrepareMatch(const CXString& lookWhat, Mode mode, bool matchCase); // Return false if the expression is invalid
    bool Match(const CXString& lookIn);
    bool Match(const CXStringArray &refLookIn);
 
    // Use these methods to perform a single search on different items
    bool Match(const CXString& lookWhat, const CXString& lookIn, Mode mode, bool matchCase);
    bool Match(const CXString& lookWhat, const CXStringArray& lookIn, Mode mode, bool matchCase);
};
 
//! @class CExLCString
//! @brief CExLCString is a class to perform uncase comparison between CXString
class DLL_TOOLSFUNCTION CExLCString : public CXString
{
public:
    CExLCString();
    CExLCString(const CXString& ref);
    CExLCString& operator=(const CXString& ref);
    int Find(const CXString& ref, int nIndex = 0) const;
};
 
template<> class CHashMethods<CExLCString> : public CHashMethods<CXString> {};
 
typedef enum _CompareStringsEnum
{
    STRINGS_COMPARE_NO_CASE = 1,
    STRINGS_COMPARE_CASE,
    STRINGS_COMPARE_LANGUAGE_NO_CASE,
    STRINGS_COMPARE_LANGUAGE_CASE,
    STRINGS_COMPARE_FILENAMES, // Order filename, taking the digit value into account: file0001, file2, file03...
} CompareStringsEnum;
 
//DLL_TOOLSFUNCTION int SScanFS(int numArgs, LPCTSTR string, LPCTSTR format, ...);
DLL_TOOLSFUNCTION CXString CleanText(const CXString& text);
DLL_TOOLSFUNCTION CXString CleanEnhancedText(const CXString& text);
DLL_TOOLSFUNCTION void RemoveDiacritics(CXString& text); // Remove éèï... and convert to eei...
#if !defined(__LINUX__) && !defined(__APPLE__)
DLL_TOOLSFUNCTION void RemoveDiacritics(CXStringA& text);
#endif
DLL_TOOLSFUNCTION void CapitalizeText(CXString& text);
DLL_TOOLSFUNCTION void SortStringArray(CXStringArray& strings, CompareStringsEnum mode = STRINGS_COMPARE_NO_CASE);
DLL_TOOLSFUNCTION void CopyStringArray(CXStringArray& strings, const CXStringArray& srcstrings, bool removeAll, bool lowerCase = FALSE);
DLL_TOOLSFUNCTION int StringFind(const CXString& mainstring, const CXString& stringtofind, bool matchCase);
DLL_TOOLSFUNCTION int StringToHash(const CXStringArray& strings, CHashTable<CXString>& hash, bool matchCase = false, bool addToHash = false);
DLL_TOOLSFUNCTION int FindInStringArray(const CXStringArray& strings, const CXString& string, bool matchCase);
DLL_TOOLSFUNCTION int ExtractString(const CXString& txt, CXStringArray& strarray);
DLL_TOOLSFUNCTION CXString ExtractString(unsigned int ID1, unsigned int ID2, unsigned int value, bool addCarriageReturn);
DLL_TOOLSFUNCTION CXString ExtractString(unsigned int ID, unsigned int value, bool addCarriageReturn);
DLL_TOOLSFUNCTION CXString LoadResourceString(unsigned int ID, LPCTSTR defaultTxt = NULL);
DLL_TOOLSFUNCTION CXString YesNoString(unsigned int ID, bool yes, bool addCarriageReturn = FALSE);
DLL_TOOLSFUNCTION CXString YesNoString(bool yes);
DLL_TOOLSFUNCTION CXString FormatString(unsigned int ID, ...);
DLL_TOOLSFUNCTION int StringFindNoCase(const CXString& findin, const CXString& lookFor, bool findAtTheBeginningOnly);
DLL_TOOLSFUNCTION bool StringRemoveNoCase(CXString& src, const CXString& remove, bool removeAtTheBeginningOnly);
DLL_TOOLSFUNCTION CXString FormatStringEx(unsigned int ID, LPCTSTR formater, bool addCarriageReturn, ...);
DLL_TOOLSFUNCTION CXString FormatString(LPCTSTR ID, ...);
DLL_TOOLSFUNCTION int StringCompare(const CXString& string1, const CXString& string2, bool matchCase);
DLL_TOOLSFUNCTION CXString LowerCaseString(const CXString& lowercase);
DLL_TOOLSFUNCTION CXString GetFileSizeString(fileuint filesize);
DLL_TOOLSFUNCTION CXString GetUnitText(UNIT_MODE unit, bool shortTxt);
#ifndef MOOTOOLS_CRUNCHERSDK
DLL_TOOLSFUNCTION bool ConvertText2Time(const CXString& txttime, CXTime& time);
DLL_TOOLSFUNCTION CXString GetFileDateString(const CXTime& time, bool includeDate, bool includeHours, bool textualDate);
DLL_TOOLSFUNCTION CXString Key2String(unsigned int key, unsigned int modifier);
#endif
DLL_TOOLSFUNCTION CXString GetUniqueName(CHashTable<CXString>& hash, const CXString& srcname, int maxlength = -1, bool addOnlyDigits = false);
DLL_TOOLSFUNCTION CXString CText(const CXString& text);
DLL_TOOLSFUNCTION CXString DText(const CXString& text);
 
#ifdef MOOTOOLS_CRUNCHERSDK
bool LoadSDKResource(const CXString& resourceName, unsigned int langid = 1033); // Load a file containing resource strings in the given specified langage. langid are windows lang ID.
#endif
 
 
END_MOOTOOLS_NAMESPACE
 
#endif // STRING_TOOLS_H