Common.h 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529
  1. //---------------------------------------------------------------------------
  2. #ifndef CommonH
  3. #define CommonH
  4. //---------------------------------------------------------------------------
  5. #include <vector>
  6. //---------------------------------------------------------------------------
  7. #define EXCEPTION throw ExtException(NULL, L"")
  8. #define THROWOSIFFALSE(C) { if (!(C)) RaiseLastOSError(); }
  9. #define SAFE_DESTROY_EX(CLASS, OBJ) { CLASS * PObj = OBJ; OBJ = NULL; delete PObj; }
  10. #define SAFE_DESTROY(OBJ) SAFE_DESTROY_EX(TObject, OBJ)
  11. #define NULL_TERMINATE(S) S[LENOF(S) - 1] = L'\0'
  12. #define ASCOPY(dest, source) \
  13. { \
  14. AnsiString CopyBuf = source; \
  15. strncpy(dest, CopyBuf.c_str(), LENOF(dest)); \
  16. dest[LENOF(dest)-1] = '\0'; \
  17. }
  18. #define SWAP(TYPE, FIRST, SECOND) \
  19. { TYPE __Backup = FIRST; FIRST = SECOND; SECOND = __Backup; }
  20. //---------------------------------------------------------------------------
  21. #define PARENTDIRECTORY L".."
  22. #define THISDIRECTORY L"."
  23. //---------------------------------------------------------------------------
  24. extern const wchar_t EngShortMonthNames[12][4];
  25. extern const char Bom[3];
  26. extern const wchar_t TokenPrefix;
  27. extern const wchar_t NoReplacement;
  28. extern const wchar_t TokenReplacement;
  29. extern const UnicodeString LocalInvalidChars;
  30. extern const UnicodeString PasswordMask;
  31. extern const UnicodeString Ellipsis;
  32. //---------------------------------------------------------------------------
  33. extern const UnicodeString HttpProtocol;
  34. extern const UnicodeString HttpsProtocol;
  35. extern const UnicodeString ProtocolSeparator;
  36. //---------------------------------------------------------------------------
  37. UnicodeString ReplaceChar(UnicodeString Str, wchar_t A, wchar_t B);
  38. UnicodeString DeleteChar(UnicodeString Str, wchar_t C);
  39. void PackStr(UnicodeString & Str);
  40. void PackStr(RawByteString & Str);
  41. void PackStr(AnsiString & Str);
  42. void __fastcall Shred(UnicodeString & Str);
  43. void __fastcall Shred(UTF8String & Str);
  44. void __fastcall Shred(AnsiString & Str);
  45. void __fastcall Shred(RawByteString & Str);
  46. UnicodeString AnsiToString(const RawByteString & S);
  47. UnicodeString AnsiToString(const char * S, size_t Len);
  48. UnicodeString MakeValidFileName(UnicodeString FileName);
  49. UnicodeString RootKeyToStr(HKEY RootKey);
  50. UnicodeString BooleanToStr(bool B);
  51. UnicodeString BooleanToEngStr(bool B);
  52. UnicodeString DefaultStr(const UnicodeString & Str, const UnicodeString & Default);
  53. UnicodeString CutToChar(UnicodeString &Str, wchar_t Ch, bool Trim);
  54. UnicodeString CopyToChars(const UnicodeString & Str, int & From, UnicodeString Chs, bool Trim,
  55. wchar_t * Delimiter = NULL, bool DoubleDelimiterEscapes = false);
  56. UnicodeString CopyToChar(const UnicodeString & Str, wchar_t Ch, bool Trim);
  57. UnicodeString RemoveSuffix(const UnicodeString & Str, const UnicodeString & Suffix, bool RemoveNumbersAfterSuffix = false);
  58. UnicodeString DelimitStr(UnicodeString Str, UnicodeString Chars);
  59. UnicodeString ShellDelimitStr(UnicodeString Str, wchar_t Quote);
  60. UnicodeString ExceptionLogString(Exception *E);
  61. UnicodeString __fastcall MainInstructions(const UnicodeString & S);
  62. bool __fastcall HasParagraphs(const UnicodeString & S);
  63. UnicodeString __fastcall MainInstructionsFirstParagraph(const UnicodeString & S);
  64. bool ExtractMainInstructions(UnicodeString & S, UnicodeString & MainInstructions);
  65. UnicodeString RemoveMainInstructionsTag(UnicodeString S);
  66. UnicodeString UnformatMessage(UnicodeString S);
  67. UnicodeString RemoveInteractiveMsgTag(UnicodeString S);
  68. UnicodeString RemoveEmptyLines(const UnicodeString & S);
  69. bool IsNumber(const UnicodeString Str);
  70. extern const wchar_t NormalizedFingerprintSeparator;
  71. UnicodeString Base64ToUrlSafe(const UnicodeString & S);
  72. UnicodeString MD5ToUrlSafe(const UnicodeString & S);
  73. bool SameChecksum(const UnicodeString & AChecksum1, const UnicodeString & AChecksum2, bool Base64);
  74. UnicodeString __fastcall SystemTemporaryDirectory();
  75. UnicodeString __fastcall GetShellFolderPath(int CSIdl);
  76. UnicodeString __fastcall GetPersonalFolder();
  77. UnicodeString __fastcall GetDesktopFolder();
  78. UnicodeString __fastcall StripPathQuotes(const UnicodeString Path);
  79. UnicodeString __fastcall AddQuotes(UnicodeString Str);
  80. UnicodeString __fastcall AddPathQuotes(UnicodeString Path);
  81. void __fastcall SplitCommand(UnicodeString Command, UnicodeString &Program,
  82. UnicodeString & Params, UnicodeString & Dir);
  83. UnicodeString __fastcall ValidLocalFileName(UnicodeString FileName);
  84. UnicodeString __fastcall ValidLocalFileName(
  85. UnicodeString FileName, wchar_t InvalidCharsReplacement,
  86. const UnicodeString & TokenizibleChars, const UnicodeString & LocalInvalidChars);
  87. UnicodeString __fastcall ExtractProgram(UnicodeString Command);
  88. UnicodeString __fastcall ExtractProgramName(UnicodeString Command);
  89. UnicodeString __fastcall FormatCommand(UnicodeString Program, UnicodeString Params);
  90. UnicodeString __fastcall ExpandFileNameCommand(const UnicodeString Command,
  91. const UnicodeString FileName);
  92. void __fastcall ReformatFileNameCommand(UnicodeString & Command);
  93. UnicodeString __fastcall EscapeParam(const UnicodeString & Param);
  94. UnicodeString __fastcall EscapePuttyCommandParam(UnicodeString Param);
  95. UnicodeString __fastcall StringsToParams(TStrings * Strings);
  96. UnicodeString __fastcall ExpandEnvironmentVariables(const UnicodeString & Str);
  97. bool __fastcall SamePaths(const UnicodeString & Path1, const UnicodeString & Path2);
  98. UnicodeString GetNormalizedPath(const UnicodeString & Path);
  99. UnicodeString GetCanonicalPath(const UnicodeString & Path);
  100. bool __fastcall IsPathToSameFile(const UnicodeString & Path1, const UnicodeString & Path2);
  101. int __fastcall CompareLogicalText(
  102. const UnicodeString & S1, const UnicodeString & S2, bool NaturalOrderNumericalSorting);
  103. int __fastcall CompareNumber(__int64 Value1, __int64 Value2);
  104. bool ContainsTextSemiCaseSensitive(const UnicodeString & Text, const UnicodeString & SubText);
  105. bool __fastcall IsReservedName(UnicodeString FileName);
  106. UnicodeString __fastcall ApiPath(UnicodeString Path);
  107. UnicodeString __fastcall DisplayableStr(const RawByteString & Str);
  108. UnicodeString __fastcall ByteToHex(unsigned char B, bool UpperCase = true);
  109. UnicodeString __fastcall BytesToHex(const unsigned char * B, size_t Length, bool UpperCase = true, wchar_t Separator = L'\0');
  110. UnicodeString __fastcall BytesToHex(RawByteString Str, bool UpperCase = true, wchar_t Separator = L'\0');
  111. UnicodeString __fastcall CharToHex(wchar_t Ch, bool UpperCase = true);
  112. RawByteString __fastcall HexToBytes(const UnicodeString Hex);
  113. unsigned char __fastcall HexToByte(const UnicodeString Hex);
  114. bool __fastcall IsLowerCaseLetter(wchar_t Ch);
  115. bool __fastcall IsUpperCaseLetter(wchar_t Ch);
  116. bool __fastcall IsLetter(wchar_t Ch);
  117. bool __fastcall IsDigit(wchar_t Ch);
  118. bool __fastcall IsHex(wchar_t Ch);
  119. UnicodeString __fastcall DecodeUrlChars(UnicodeString S);
  120. UnicodeString __fastcall EncodeUrlString(UnicodeString S);
  121. UnicodeString __fastcall EncodeUrlPath(UnicodeString S);
  122. UnicodeString __fastcall AppendUrlParams(UnicodeString URL, UnicodeString Params);
  123. UnicodeString __fastcall ExtractFileNameFromUrl(const UnicodeString & Url);
  124. bool __fastcall RecursiveDeleteFile(const UnicodeString & FileName, bool ToRecycleBin);
  125. int __fastcall RecursiveDeleteFileChecked(const UnicodeString & FileName, bool ToRecycleBin);
  126. void __fastcall DeleteFileChecked(const UnicodeString & FileName);
  127. unsigned int __fastcall CancelAnswer(unsigned int Answers);
  128. unsigned int __fastcall AbortAnswer(unsigned int Answers);
  129. unsigned int __fastcall ContinueAnswer(unsigned int Answers);
  130. UnicodeString __fastcall LoadStr(int Ident, unsigned int MaxLength);
  131. UnicodeString __fastcall LoadStrFrom(HINSTANCE Module, int Ident);
  132. UnicodeString __fastcall LoadStrPart(int Ident, int Part);
  133. UnicodeString __fastcall EscapeHotkey(const UnicodeString & Caption);
  134. bool __fastcall CutToken(UnicodeString & Str, UnicodeString & Token,
  135. UnicodeString * RawToken = NULL, UnicodeString * Separator = NULL);
  136. bool __fastcall CutTokenEx(UnicodeString & Str, UnicodeString & Token,
  137. UnicodeString * RawToken = NULL, UnicodeString * Separator = NULL);
  138. void __fastcall AddToList(UnicodeString & List, const UnicodeString & Value, const UnicodeString & Delimiter);
  139. bool __fastcall IsWinVista();
  140. bool __fastcall IsWin7();
  141. bool __fastcall IsWin8();
  142. bool __fastcall IsWin10();
  143. bool __fastcall IsWin10Build(unsigned int BuildNumber);
  144. bool __fastcall IsWine();
  145. bool __fastcall IsUWP();
  146. TLibModule * __fastcall FindModule(void * Instance);
  147. __int64 __fastcall Round(double Number);
  148. bool __fastcall TryRelativeStrToDateTime(UnicodeString S, TDateTime & DateTime, bool Add);
  149. bool TryStrToDateTimeStandard(const UnicodeString & S, TDateTime & Value);
  150. bool __fastcall TryStrToSize(UnicodeString SizeStr, __int64 & Size);
  151. UnicodeString __fastcall SizeToStr(__int64 Size);
  152. LCID __fastcall GetDefaultLCID();
  153. UnicodeString __fastcall DefaultEncodingName();
  154. UnicodeString __fastcall WindowsProductName();
  155. bool _fastcall GetWindowsProductType(DWORD & Type);
  156. int __fastcall GetWindowsBuild();
  157. UnicodeString __fastcall WindowsVersion();
  158. UnicodeString __fastcall WindowsVersionLong();
  159. bool __fastcall IsDirectoryWriteable(const UnicodeString & Path);
  160. UnicodeString __fastcall FormatNumber(__int64 Size);
  161. UnicodeString __fastcall FormatSize(__int64 Size);
  162. UnicodeString __fastcall ExtractFileBaseName(const UnicodeString & Path);
  163. TStringList * __fastcall TextToStringList(const UnicodeString & Text);
  164. UnicodeString __fastcall StringsToText(TStrings * Strings);
  165. TStrings * __fastcall CloneStrings(TStrings * Strings);
  166. UnicodeString __fastcall TrimVersion(UnicodeString Version);
  167. UnicodeString __fastcall FormatVersion(int MajovVersion, int MinorVersion, int Release);
  168. TFormatSettings __fastcall GetEngFormatSettings();
  169. int __fastcall ParseShortEngMonthName(const UnicodeString & MonthStr);
  170. // The defaults are equal to defaults of TStringList class (except for Sorted)
  171. TStringList * __fastcall CreateSortedStringList(bool CaseSensitive = false, System::Types::TDuplicates Duplicates = dupIgnore);
  172. UnicodeString __fastcall FindIdent(const UnicodeString & Ident, TStrings * Idents);
  173. void __fastcall CheckCertificate(const UnicodeString & Path);
  174. typedef struct x509_st X509;
  175. typedef struct evp_pkey_st EVP_PKEY;
  176. void __fastcall ParseCertificate(const UnicodeString & Path,
  177. const UnicodeString & Passphrase, X509 *& Certificate, EVP_PKEY *& PrivateKey,
  178. bool & WrongPassphrase);
  179. bool __fastcall IsHttpUrl(const UnicodeString & S);
  180. bool __fastcall IsHttpOrHttpsUrl(const UnicodeString & S);
  181. UnicodeString __fastcall ChangeUrlProtocol(const UnicodeString & S, const UnicodeString & Protocol);
  182. void __fastcall LoadScriptFromFile(UnicodeString FileName, TStrings * Lines, bool FallbackToAnsi = false);
  183. UnicodeString __fastcall StripEllipsis(const UnicodeString & S);
  184. UnicodeString __fastcall GetFileMimeType(const UnicodeString & FileName);
  185. bool __fastcall IsRealFile(const UnicodeString & FileName);
  186. UnicodeString GetOSInfo();
  187. UnicodeString GetEnvironmentInfo();
  188. void SetStringValueEvenIfEmpty(TStrings * Strings, const UnicodeString & Name, const UnicodeString & Value);
  189. UnicodeString __fastcall GetAncestorProcessName(int Levels = 1);
  190. UnicodeString GetAncestorProcessNames();
  191. //---------------------------------------------------------------------------
  192. struct TSearchRecSmart : public TSearchRec
  193. {
  194. public:
  195. TSearchRecSmart();
  196. void Clear();
  197. TDateTime GetLastWriteTime() const;
  198. bool IsRealFile() const;
  199. bool IsDirectory() const;
  200. bool IsHidden() const;
  201. private:
  202. mutable FILETIME FLastWriteTimeSource;
  203. mutable TDateTime FLastWriteTime;
  204. };
  205. //---------------------------------------------------------------------------
  206. typedef void __fastcall (__closure* TProcessLocalFileEvent)
  207. (const UnicodeString & FileName, const TSearchRecSmart & Rec, void * Param);
  208. bool __fastcall FileSearchRec(const UnicodeString FileName, TSearchRec & Rec);
  209. void CopySearchRec(const TSearchRec & Source, TSearchRec & Dest);
  210. struct TSearchRecChecked : public TSearchRecSmart
  211. {
  212. UnicodeString Path;
  213. bool Opened;
  214. };
  215. struct TSearchRecOwned : public TSearchRecChecked
  216. {
  217. ~TSearchRecOwned();
  218. void Close();
  219. };
  220. int __fastcall FindCheck(int Result, const UnicodeString & Path);
  221. int __fastcall FindFirstUnchecked(const UnicodeString & Path, int Attr, TSearchRecChecked & F);
  222. int __fastcall FindFirstChecked(const UnicodeString & Path, int Attr, TSearchRecChecked & F);
  223. int __fastcall FindNextChecked(TSearchRecChecked & F);
  224. int __fastcall FindNextUnchecked(TSearchRecChecked & F);
  225. void __fastcall ProcessLocalDirectory(UnicodeString DirName,
  226. TProcessLocalFileEvent CallBackFunc, void * Param = NULL, int FindAttrs = -1);
  227. int __fastcall FileGetAttrFix(const UnicodeString FileName);
  228. //---------------------------------------------------------------------------
  229. extern const wchar_t * DSTModeNames;
  230. enum TDSTMode
  231. {
  232. dstmWin = 0, //
  233. dstmUnix = 1, // adjust UTC time to Windows "bug"
  234. dstmKeep = 2
  235. };
  236. bool __fastcall UsesDaylightHack();
  237. TDateTime __fastcall EncodeDateVerbose(Word Year, Word Month, Word Day);
  238. TDateTime __fastcall EncodeTimeVerbose(Word Hour, Word Min, Word Sec, Word MSec);
  239. double __fastcall DSTDifferenceForTime(TDateTime DateTime);
  240. TDateTime __fastcall SystemTimeToDateTimeVerbose(const SYSTEMTIME & SystemTime);
  241. TDateTime __fastcall UnixToDateTime(__int64 TimeStamp, TDSTMode DSTMode);
  242. TDateTime __fastcall ConvertTimestampToUTC(TDateTime DateTime);
  243. TDateTime __fastcall ConvertTimestampFromUTC(TDateTime DateTime);
  244. FILETIME __fastcall DateTimeToFileTime(const TDateTime DateTime, TDSTMode DSTMode);
  245. TDateTime __fastcall AdjustDateTimeFromUnix(TDateTime DateTime, TDSTMode DSTMode);
  246. void __fastcall UnifyDateTimePrecision(TDateTime & DateTime1, TDateTime & DateTime2);
  247. TDateTime __fastcall FileTimeToDateTime(const FILETIME & FileTime);
  248. __int64 __fastcall ConvertTimestampToUnix(const FILETIME & FileTime,
  249. TDSTMode DSTMode);
  250. __int64 __fastcall ConvertTimestampToUnixSafe(const FILETIME & FileTime,
  251. TDSTMode DSTMode);
  252. UnicodeString __fastcall FixedLenDateTimeFormat(const UnicodeString & Format);
  253. UnicodeString __fastcall StandardTimestamp(const TDateTime & DateTime);
  254. UnicodeString __fastcall StandardTimestamp();
  255. UnicodeString __fastcall StandardDatestamp();
  256. UnicodeString __fastcall FormatTimeZone(long Sec);
  257. UnicodeString __fastcall GetTimeZoneLogString();
  258. bool __fastcall AdjustClockForDSTEnabled();
  259. int __fastcall CompareFileTime(TDateTime T1, TDateTime T2);
  260. int __fastcall TimeToMSec(TDateTime T);
  261. int __fastcall TimeToSeconds(TDateTime T);
  262. int __fastcall TimeToMinutes(TDateTime T);
  263. UnicodeString __fastcall FormatDateTimeSpan(const UnicodeString TimeFormat, TDateTime DateTime);
  264. TStrings * TlsCipherList();
  265. //---------------------------------------------------------------------------
  266. template<class MethodT>
  267. MethodT __fastcall MakeMethod(void * Data, void * Code)
  268. {
  269. MethodT Method;
  270. ((TMethod*)&Method)->Data = Data;
  271. ((TMethod*)&Method)->Code = Code;
  272. return Method;
  273. }
  274. //---------------------------------------------------------------------------
  275. enum TAssemblyLanguage { alCSharp, alVBNET, alPowerShell };
  276. extern const UnicodeString RtfPara;
  277. extern const UnicodeString AssemblyNamespace;
  278. extern const UnicodeString SessionClassName;
  279. extern const UnicodeString TransferOptionsClassName;
  280. //---------------------------------------------------------------------
  281. UnicodeString __fastcall RtfText(const UnicodeString & Text, bool Rtf = true);
  282. UnicodeString __fastcall RtfColor(int Index);
  283. UnicodeString __fastcall RtfOverrideColorText(const UnicodeString & Text);
  284. UnicodeString __fastcall RtfColorItalicText(int Color, const UnicodeString & Text);
  285. UnicodeString __fastcall RtfColorText(int Color, const UnicodeString & Text);
  286. UnicodeString __fastcall RtfKeyword(const UnicodeString & Text);
  287. UnicodeString __fastcall RtfParameter(const UnicodeString & Text);
  288. UnicodeString __fastcall RtfString(const UnicodeString & Text);
  289. UnicodeString __fastcall RtfLink(const UnicodeString & Link, const UnicodeString & RtfText);
  290. UnicodeString __fastcall RtfSwitch(
  291. const UnicodeString & Name, const UnicodeString & Link, bool Rtf = true);
  292. UnicodeString __fastcall RtfSwitchValue(
  293. const UnicodeString & Name, const UnicodeString & Link, const UnicodeString & Value, bool Rtf = true);
  294. UnicodeString __fastcall RtfSwitch(
  295. const UnicodeString & Name, const UnicodeString & Link, const UnicodeString & Value, bool Rtf = true);
  296. UnicodeString __fastcall RtfSwitch(
  297. const UnicodeString & Name, const UnicodeString & Link, int Value, bool Rtf = true);
  298. UnicodeString __fastcall RtfEscapeParam(UnicodeString Param, bool PowerShellEscape);
  299. UnicodeString __fastcall RtfRemoveHyperlinks(UnicodeString Text);
  300. UnicodeString __fastcall ScriptCommandLink(const UnicodeString & Command);
  301. UnicodeString __fastcall AssemblyBoolean(TAssemblyLanguage Language, bool Value);
  302. UnicodeString __fastcall AssemblyString(TAssemblyLanguage Language, UnicodeString S);
  303. UnicodeString __fastcall AssemblyCommentLine(TAssemblyLanguage Language, const UnicodeString & Text);
  304. UnicodeString __fastcall AssemblyPropertyRaw(
  305. TAssemblyLanguage Language, const UnicodeString & ClassName, const UnicodeString & Name,
  306. const UnicodeString & Value, bool Inline);
  307. UnicodeString __fastcall AssemblyProperty(
  308. TAssemblyLanguage Language, const UnicodeString & ClassName, const UnicodeString & Name,
  309. const UnicodeString & Type, const UnicodeString & Member, bool Inline);
  310. UnicodeString __fastcall AssemblyProperty(
  311. TAssemblyLanguage Language, const UnicodeString & ClassName, const UnicodeString & Name,
  312. const UnicodeString & Value, bool Inline);
  313. UnicodeString __fastcall AssemblyProperty(
  314. TAssemblyLanguage Language, const UnicodeString & ClassName, const UnicodeString & Name, int Value, bool Inline);
  315. UnicodeString __fastcall AssemblyProperty(
  316. TAssemblyLanguage Language, const UnicodeString & ClassName, const UnicodeString & Name, bool Value, bool Inline);
  317. UnicodeString __fastcall RtfLibraryMethod(const UnicodeString & ClassName, const UnicodeString & MethodName, bool Inpage);
  318. UnicodeString __fastcall RtfLibraryClass(const UnicodeString & ClassName);
  319. UnicodeString __fastcall AssemblyVariableName(TAssemblyLanguage Language, const UnicodeString & ClassName);
  320. UnicodeString __fastcall AssemblyStatementSeparator(TAssemblyLanguage Language);
  321. UnicodeString __fastcall AssemblyVariableDeclaration(TAssemblyLanguage Language);
  322. UnicodeString __fastcall AssemblyNewClassInstance(
  323. TAssemblyLanguage Language, const UnicodeString & ClassName, bool Inline);
  324. UnicodeString __fastcall AssemblyNewClassInstanceStart(
  325. TAssemblyLanguage Language, const UnicodeString & ClassName, bool Inline);
  326. UnicodeString __fastcall AssemblyNewClassInstanceEnd(TAssemblyLanguage Language, bool Inline);
  327. UnicodeString __fastcall AssemblyAddRawSettings(
  328. TAssemblyLanguage Language, TStrings * RawSettings, const UnicodeString & ClassName,
  329. const UnicodeString & MethodName);
  330. //---------------------------------------------------------------------------
  331. #include "Global.h"
  332. //---------------------------------------------------------------------------
  333. template<class T>
  334. class TValueRestorer
  335. {
  336. public:
  337. __fastcall TValueRestorer(T & Target, const T & Value) :
  338. FTarget(Target),
  339. FValue(Value),
  340. FArmed(true)
  341. {
  342. }
  343. __fastcall TValueRestorer(T & Target) :
  344. FTarget(Target),
  345. FValue(Target),
  346. FArmed(true)
  347. {
  348. }
  349. void Release()
  350. {
  351. if (FArmed)
  352. {
  353. FTarget = FValue;
  354. FArmed = false;
  355. }
  356. }
  357. __fastcall ~TValueRestorer()
  358. {
  359. Release();
  360. }
  361. protected:
  362. T & FTarget;
  363. T FValue;
  364. bool FArmed;
  365. };
  366. //---------------------------------------------------------------------------
  367. class TAutoNestingCounter : public TValueRestorer<int>
  368. {
  369. public:
  370. __fastcall TAutoNestingCounter(int & Target) :
  371. TValueRestorer<int>(Target)
  372. {
  373. DebugAssert(Target >= 0);
  374. ++Target;
  375. }
  376. __fastcall ~TAutoNestingCounter()
  377. {
  378. DebugAssert(!FArmed || (FTarget == (FValue + 1)));
  379. }
  380. };
  381. //---------------------------------------------------------------------------
  382. class TAutoFlag : public TValueRestorer<bool>
  383. {
  384. public:
  385. __fastcall TAutoFlag(bool & Target) :
  386. TValueRestorer<bool>(Target)
  387. {
  388. DebugAssert(!Target);
  389. Target = true;
  390. }
  391. __fastcall ~TAutoFlag()
  392. {
  393. DebugAssert(!FArmed || FTarget);
  394. }
  395. };
  396. //---------------------------------------------------------------------------
  397. #include <map>
  398. //---------------------------------------------------------------------------
  399. template<class T1, class T2>
  400. class BiDiMap
  401. {
  402. public:
  403. typedef std::map<T1, T2> TFirstToSecond;
  404. typedef TFirstToSecond::const_iterator const_iterator;
  405. void Add(const T1 & Value1, const T2 & Value2)
  406. {
  407. FFirstToSecond.insert(std::make_pair(Value1, Value2));
  408. FSecondToFirst.insert(std::make_pair(Value2, Value1));
  409. }
  410. T1 LookupFirst(const T2 & Value2) const
  411. {
  412. TSecondToFirst::const_iterator Iterator = FSecondToFirst.find(Value2);
  413. DebugAssert(Iterator != FSecondToFirst.end());
  414. return Iterator->second;
  415. }
  416. T2 LookupSecond(const T1 & Value1) const
  417. {
  418. const_iterator Iterator = FFirstToSecond.find(Value1);
  419. DebugAssert(Iterator != FFirstToSecond.end());
  420. return Iterator->second;
  421. }
  422. const_iterator begin()
  423. {
  424. return FFirstToSecond.begin();
  425. }
  426. const_iterator end()
  427. {
  428. return FFirstToSecond.end();
  429. }
  430. private:
  431. TFirstToSecond FFirstToSecond;
  432. typedef std::map<T2, T1> TSecondToFirst;
  433. TSecondToFirst FSecondToFirst;
  434. };
  435. //---------------------------------------------------------------------------
  436. template<class T>
  437. class TMulticastEvent
  438. {
  439. public:
  440. TMulticastEvent()
  441. {
  442. // noop
  443. }
  444. TMulticastEvent(const TMulticastEvent & Other) :
  445. FEventHandlers(Other.FEventHandlers)
  446. {
  447. }
  448. explicit TMulticastEvent(T EventHandler)
  449. {
  450. Add(EventHandler);
  451. }
  452. void Add(T EventHandler)
  453. {
  454. DebugAssert(EventHandler != NULL);
  455. DebugAssert(Find(EventHandler) == FEventHandlers.end());
  456. FEventHandlers.push_back(EventHandler);
  457. }
  458. void Remove(T EventHandler)
  459. {
  460. TEventHandlers::iterator I = Find(EventHandler);
  461. if (DebugAlwaysTrue(I != FEventHandlers.end()))
  462. {
  463. FEventHandlers.erase(I);
  464. }
  465. }
  466. #pragma warn -inl
  467. template<typename P>
  468. void Invoke(const P & p)
  469. {
  470. TEventHandlers::iterator I = FEventHandlers.begin();
  471. while (I != FEventHandlers.end())
  472. {
  473. (*I)(p);
  474. ++I;
  475. }
  476. }
  477. #pragma warn .inl
  478. bool Contains(T EventHandler)
  479. {
  480. return (Find(EventHandler) != FEventHandlers.end());
  481. }
  482. bool Any() const
  483. {
  484. return (FEventHandlers.size() > 0);
  485. }
  486. bool operator==(const TMulticastEvent<T> Other) const
  487. {
  488. return (FEventHandlers == Other.FEventHandlers);
  489. }
  490. void operator=(const TMulticastEvent<T> & Other)
  491. {
  492. FEventHandlers = Other.FEventHandlers;
  493. }
  494. private:
  495. typedef std::vector<T> TEventHandlers;
  496. TEventHandlers FEventHandlers;
  497. TEventHandlers::iterator Find(T EventHandler)
  498. {
  499. return std::find(FEventHandlers.begin(), FEventHandlers.end(), EventHandler);
  500. }
  501. };
  502. //---------------------------------------------------------------------------
  503. typedef std::vector<UnicodeString> TUnicodeStringVector;
  504. //---------------------------------------------------------------------------
  505. #endif