Text.h 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588
  1. #ifndef Text_H
  2. #define Text_H
  3. #include <functional>
  4. #include <sstream>
  5. #include "Reader.h"
  6. #include "ReferenceCounter.h"
  7. namespace Framework
  8. {
  9. class Text; //! aus dieser Datei
  10. namespace Regex
  11. {
  12. class Result;
  13. class RegexConfig;
  14. } // namespace Regex
  15. class DynamicBuffer : public std::stringbuf
  16. {
  17. private:
  18. std::function<int(std::stringbuf&)> onAppend;
  19. public:
  20. DLLEXPORT DynamicBuffer(std::function<int(std::stringbuf&)> onAppend);
  21. DLLEXPORT virtual int sync() override;
  22. };
  23. class FlushingOStream : public std::ostream
  24. {
  25. private:
  26. std::function<void()> onDestroy;
  27. public:
  28. DLLEXPORT FlushingOStream(
  29. DynamicBuffer* buffer, std::function<void()> onDestroy = []() {});
  30. DLLEXPORT FlushingOStream(const Framework::FlushingOStream& stream);
  31. DLLEXPORT ~FlushingOStream();
  32. };
  33. //! Ein ersatz für String
  34. class Text : public virtual ReferenceCounter
  35. {
  36. private:
  37. char* txt;
  38. int length;
  39. char suchGBeg;
  40. char suchGEnd;
  41. int precision;
  42. DynamicBuffer* stringWriter;
  43. DLLEXPORT Text(char* txt, int l);
  44. public:
  45. //! Erstellt ein neues Text Objekt mit dem Wert ""
  46. DLLEXPORT Text();
  47. //! Erstellt ein neues Text Objekt indem der Wert aus (txt) kopiert wird
  48. //! \param txt Der Text, der kopiert werden soll
  49. DLLEXPORT Text(const Text& txt);
  50. //! Erstellt ein neues Text Objekt indem der Wert aus (txt) kopiert wird
  51. //! \param txt Die Zeichenkette, die kopiert werden soll
  52. DLLEXPORT Text(const char* txt);
  53. //! Erstellt ein neues Text Objekt mit einer zahl als text
  54. //! \param zahl Die Zahl, die im Text sein soll
  55. DLLEXPORT Text(int zahl);
  56. //! Erstellt ein neues Text Objekt mit einer zahl als text
  57. //! \param num Die Zahl, die im Text sein soll
  58. DLLEXPORT Text(double num);
  59. //! Erstellt ein neues Text Objekt mit einer zahl als text
  60. //! \param num Die Zahl, die im Text sein soll
  61. DLLEXPORT Text(float num);
  62. //! Löscht den Text
  63. DLLEXPORT ~Text();
  64. private:
  65. DLLEXPORT void setTextZ(char* t, int l);
  66. public:
  67. //! Wandelt alle buchstaben in großbuchstaben um
  68. DLLEXPORT void toUpperCase();
  69. //! Wandelt alle buchstaben in kleinbuchstaben um
  70. DLLEXPORT void toLowerCase();
  71. //! Legt die Suchgrenzen fest, die von den Suchfunktionen verwendet
  72. //! werden. \param gBeg Das Zeichen, bei dem die Suche beginnen soll
  73. //! \param gEnd Das Zeichen, bei dem die Suche enden soll
  74. DLLEXPORT void setSuchGrenzen(char gBeg, char gEnd);
  75. //! Setzt den Text, den das Zeichnung speichert
  76. //! \param t Eine Zeichenkette, deren Inhalt kopiert wird
  77. DLLEXPORT void setText(const char* t);
  78. //! Setzt den Text, den das Zeichnung speichert
  79. //! \param t Eine Zeichenkette, deren Inhalt kopiert wird
  80. //! \param l Die Länge des Textes, der aus (t) kopiert werden soll
  81. DLLEXPORT void setText(const char* t, int l);
  82. //! Setzt den Text, den das Zeichnung speichert
  83. //! \param t Das TextZeichnung, dessen Inahlt kopiert werden soll
  84. DLLEXPORT void setText(Text* t);
  85. //! Hängt die übergebene Zahl als Hex Text (0-F) ans Ende des Textes an.
  86. //! \param num Die Zahl, die ins Hex System umgewandelt und angehängt
  87. //! werden soll
  88. DLLEXPORT void appendHex(int num);
  89. //! Hängt die übergebene Zahl als Hex Text (0-F) ans Ende des Textes an.
  90. //! \param num Die Zahl, die ins Hex System umgewandelt und angehängt
  91. //! werden soll
  92. DLLEXPORT void appendHex(__int64 num);
  93. //! Fügt den übergebenen Buchtaben der Zeichenkette hinzu
  94. //! \param c Der Buchstabe, der angehängt werden soll
  95. DLLEXPORT void append(char c);
  96. //! Hängt die übergebene Zeichenkette ans Ende des Textes an
  97. //! \param t Die Zeichenkette, deren Kopie ans Ende des Textes angehängt
  98. //! werden soll
  99. DLLEXPORT void append(const char* t);
  100. //! Hängt einen Teil der übergebenen Zeichenkette ans Ende des Textes an
  101. //! \param t Die Zeichenkette, deren Kopie angehängt werden soll
  102. //! \param l Die Länge des Textabschnittes der angehängt werden soll
  103. DLLEXPORT void append(const char* t, int l);
  104. //! Hängt den Inhalt des eines Textes ans Ende des Textes an
  105. //! \param t Der Text, dessen Kopie ans Ende des Textes angehängt werden
  106. //! soll
  107. DLLEXPORT void append(Text* t);
  108. //! Hängt eine Zahl ans Ende Des Textes an
  109. //! \param num Die Zahl, die in einen Text umgewandelt und am Ende
  110. //! angehängt werden soll
  111. DLLEXPORT void append(int num);
  112. //! Hängt eine Zahl ans Ende Des Textes an
  113. //! \param num Die Zahl, die in einen Text umgewandelt und am Ende
  114. //! angehängt werden soll
  115. DLLEXPORT void append(__int64 num);
  116. //! Hängt eine Zahl ohne Vorzeichenbit am Ende des Textes an
  117. //! \param num Die Zahl, die in einen Text umgewandelt und am Ende
  118. //! angehängt werden soll
  119. DLLEXPORT void append(unsigned int num);
  120. //! Hängt eine Kommazahl am Ende des Textes an
  121. //! \param num Die Kommazahl, die am Ende des Textes angehängt werden
  122. //! soll
  123. DLLEXPORT void append(double num);
  124. //! Hängt eine Kommazahl am Ende des Textes an
  125. //! \param num Die Kommazahl, die am Ende des Textes angehängt werden
  126. //! soll
  127. DLLEXPORT void append(float num);
  128. //! Gibt einen ostream zurück, der alle ausgaben an diesen Text anhängt
  129. DLLEXPORT FlushingOStream append();
  130. //! Fügt an einer Bestimmten Stelle ein Zeichen in den Text ein
  131. //! \param p Die position im Text bei der das Zeichen eingefügt werden
  132. //! soll \param c Das Zeichen, das eingefügt werden soll
  133. DLLEXPORT void insert(int p, char c);
  134. //! Fügt an einer Bestimmten Stelle im Text eine Zeichenkette ein
  135. //! \param p Die position im Text bei der die Zeichenkette eingefügt
  136. //! werden soll \param t Die Zeichenkette, deren Kopie an eingefügt
  137. //! werden soll
  138. DLLEXPORT void insert(int p, const char* t);
  139. //! Fügt den Inhalt eines Textes an einer Bestimmten Stelle im Text ein
  140. //! \param p Die Position im Text, bei der der inhalt des Textest
  141. //! eingefügt werden soll \param t Der Text, dessen Kopie an der Stelle
  142. //! eingefügt werden soll
  143. DLLEXPORT void insert(int p, Text* t);
  144. // replaces all regular expression occurences by a static string
  145. // \param regex The regular expression to search for
  146. // \param replacement The string to replace the occurences with
  147. // \param config The configuration for the regular expression
  148. DLLEXPORT void regexReplace(const char* regex,
  149. const char* replacement,
  150. Regex::RegexConfig* config = 0);
  151. // replaces all regular expression occurences with a result of a
  152. // specified replacement function string \param regex The regular
  153. // expression to search for \param replacementFunction a function that
  154. // is called with the result of the regular expression and should return
  155. // the replacement string \param config The configuration for the
  156. // regular expression
  157. DLLEXPORT void regexReplace(const char* regex,
  158. std::function<Text(Regex::Result&)> replacementFunction,
  159. Regex::RegexConfig* config = 0);
  160. //! Ersetzt einen bestimmten Textabschnitt mit einer anderen
  161. //! Zeichenkette
  162. //! p1: Die Startposition des zu ersetzenden Textabschnittes
  163. //! p2: Die Endposition des zu ersetzenden Textabschnittes
  164. //! \param t Die Zeichenkette, die an die entsprechende Stelle kopiert
  165. //! werden soll Beispiel: ( "Hallo Welt" ).ersetzen( 2, 5, "lt" );
  166. //! ergibt: "Halt Welt"
  167. DLLEXPORT void ersetzen(int p1, int p2, const char* t);
  168. //! Ersetzt einen bestimmten Textabschnitt mit dem Inhalt eines anderen
  169. //! Textes
  170. //! p1: Die Startposition des zu ersetzenden Textabschnittes
  171. //! p2: Die Endposition des zu ersetzenden Textabschnittes
  172. //! \param t Der Text, dessen Inhalt an die entsprechende Stelle kopiert
  173. //! werden soll Beispiel: ( "Hallo Welt" ).ersetzen( 2, 5, new Text(
  174. //! "lt" ) ); ergibt: "Halt Welt"
  175. DLLEXPORT void ersetzen(int p1, int p2, Text* t);
  176. //! Sucht und erstetzt jedes Vorkommen eines bestimmten Buchstaben durch
  177. //! einen anderen
  178. //! c1: Der Buchstabe der ersetzt werden soll
  179. //! c2: Der Buchstabe, durch den der Andere ersetzt werden soll
  180. DLLEXPORT void ersetzen(char c1, char c2);
  181. //! Sucht und erstetzt jedes Vorkommen einer bestimmten Zeichenkette
  182. //! durch eine andere
  183. //! t1: Die Zeichenkette, die ersetzt werden soll
  184. //! t2: Die Zeichenkette, durch welche die Andere ersetzt werden soll
  185. DLLEXPORT void ersetzen(const char* t1, const char* t2);
  186. //! Sucht und erstetzt jedes Vorkommen des Inhalts eines Textes durch
  187. //! eine andere Zeichenkette
  188. //! t1: Der Text, dessen Inhalt gesucht und ersetzt wird
  189. //! t2: Die Zeichenkette, durch welche das Vorkommen des Textes ersetzt
  190. //! werden soll
  191. DLLEXPORT void ersetzen(Text* t1, const char* t2);
  192. //! Sucht und erstetzt jedes Vorkommen einer Zeichenkette durch den
  193. //! Inhalt eines Textes
  194. //! t1: Die Zeichenkette, die ersetzt werden soll
  195. //! t2: Der Text, dessen Inhalt das Vorkommen der Zeichenkette
  196. //! ersetzten soll
  197. DLLEXPORT void ersetzen(const char* t1, Text* t2);
  198. //! Sucht und erstetzt jedes Vorkommen des Inhalts eines Textes durch
  199. //! den Inhalt eines anderen Textes
  200. //! t1: Der Text, dessen Vorkommen ersetzt werden sollen
  201. //! t2: Der Text, dessen Inhalt das Vorkommen der Zeichenkette
  202. //! ersetzten soll
  203. DLLEXPORT void ersetzen(Text* t1, Text* t2);
  204. //! Ersetzt das i-te auftreten eines bestimmten Buchstaben mit einem
  205. //! anderen Buchstaben \param i Das wie vielte Auftreten des Buchstabens
  206. //! ersetzt werden soll
  207. //! c1: Der Buchstabe, dessen i-tes Auftreten erstetzt werden soll
  208. //! c2: Der Buchstabe, der das i-te Auftreten des anderen Buchstabens
  209. //! ersetzen soll
  210. DLLEXPORT void ersetzen(int i, char c1, char c2);
  211. //! Ersetzt das i-te auftreten einer bestimmten Zeichenkette mit einer
  212. //! anderen Zeichenkette \param i Das wie vielte Auftreten der
  213. //! Zeichenkette ersetzt werden soll
  214. //! c1: Die Zeichenkette, dessen i-tes Auftreten erstetzt werden soll
  215. //! c2: Die Zeichenkette, die das i-te Auftreten der anderen
  216. //! Zeichenkette ersetzen soll
  217. DLLEXPORT void ersetzen(int i, const char* t1, const char* t2);
  218. //! Ersetzt das i-te auftreten des Inhalts eines Textes mit einer
  219. //! Zeichenkette \param i Das wie vielte Auftreten des Textes ersetzt
  220. //! werden soll
  221. //! c1: Der Text, dessen i-tes Auftreten erstetzt werden soll
  222. //! c2: Die Zeichenkette, die das i-te Auftreten des Textes ersetzen
  223. //! soll
  224. DLLEXPORT void ersetzen(int i, Text* t1, const char* t2);
  225. //! Ersetzt das i-te auftreten einer bestimmten Zeichenkette mit dem
  226. //! Inhalt eines Textes \param i Das wie vielte Auftreten der
  227. //! Zeichenkette ersetzt werden soll
  228. //! c1: Die Zeichenkette, dessen i-tes Auftreten erstetzt werden soll
  229. //! c2: Der Text, dessen Inhalt das i-te Auftreten der Zeichenkette
  230. //! ersetzen soll
  231. DLLEXPORT void ersetzen(int i, const char* t1, Text* t2);
  232. //! Ersetzt das i-te auftreten eines bestimmten Textes mit dem Inhalt
  233. //! eines anderen Textes \param i Das wie vielte Auftreten des Textes
  234. //! ersetzt werden soll
  235. //! c1: Der Text, dessen i-tes Auftreten erstetzt werden soll
  236. //! c2: Der Text, dessen Inhalt das i-te Auftreten des anderen Textes
  237. //! ersetzen soll
  238. DLLEXPORT void ersetzen(int i, Text* t1, Text* t2);
  239. //! Löscht den bisherigen Text und erzeugt einen Text, der aus einem
  240. //! Bestimten Buchstaben besteht, mit einer bestimmten Länge \param c
  241. //! Der Buchstabe, aus dem der Text bestehen soll \param length Die
  242. //! Länge des Textes
  243. DLLEXPORT void fillText(char c, int length);
  244. //! Löscht ein Bestimmtes Zeichen aus dem Text
  245. //! \param p Die Position des zu löschenden Zeichens
  246. DLLEXPORT void remove(int p);
  247. //! Löscht einen Bestimmten Textabschnitt
  248. //! p1: Die Startposition des zu löschenden Abschnittes
  249. //! p2: Die Endposition des zu löschenden Abschnittes (Das Zeichen bei
  250. //! p2 bleibt erhalten)
  251. DLLEXPORT void remove(int p1, int p2);
  252. //! Löscht jedes Vorkommen eines bestimmten Buchsaben
  253. //! \param c Der Buchstabe, dessen Vorkommen gelöscht werden soll
  254. DLLEXPORT void remove(char c);
  255. //! Löscht jedes Vorkommen einer bestimmten Zeichenkette
  256. //! \param t Die Zeichenkette, deren Vorkommen entfernt werden sollen
  257. DLLEXPORT void remove(const char* t);
  258. //! Löscht jedes Vorkommen des Inhalts eines Textes
  259. //! \param t Der text, dessen Inhalt gelöscht werden soll
  260. DLLEXPORT void remove(Text* t);
  261. //! Löscht das i-te Vorkommen eines bestimmten Buchstaben
  262. //! \param i Das wie vielte Vorkommen des Buchstabens gelöscht werden
  263. //! soll \param c Der Buchstabe, dessen i-tes Vorkommen gelöscht werden
  264. //! soll
  265. DLLEXPORT void remove(int i, char c);
  266. //! Löscht das i-te Vorkommen einer bestimmten Zechenkette
  267. //! \param i Das wie vielte Vorkommen der Zeichenkette gelöscht werden
  268. //! soll \param t Die Zeichenkette, dessen i-tes Vorkommen gelöscht
  269. //! werden soll
  270. DLLEXPORT void remove(int i, const char* t);
  271. //! Löscht das i-te Vorkommen eines bestimmten Textinhaltes
  272. //! \param i Das wie vielte Vorkommen des Textinhaltes gelöscht werden
  273. //! soll \param t Der Text, dessen i-tes Vorkommen gelöscht werden soll
  274. DLLEXPORT void remove(int i, Text* t);
  275. //! Löscht alle ' ', '\n', '\r', '\t' bis zu einem anderen buchstaben
  276. //! \param pos Die Position des ersten zeichens
  277. DLLEXPORT void removeWhitespaceAfter(int pos);
  278. //! Löscht alle ' ', '\n', '\r', '\t' bis zu einem anderen buchstaben
  279. //! \param pos Die Position des ersten zeichens (beginnt bei pos-1)
  280. DLLEXPORT void removeWhitespaceBefore(int pos);
  281. //! Setzt die Anzahl der Nachkommastellen beim Anhängen von Kommazahlen
  282. //! \param p Die Anzahl der Stellen nach dem Komma
  283. DLLEXPORT void setPrecision(int p);
  284. //! Gibt die Länge des Textes zurück
  285. DLLEXPORT int getLength() const;
  286. //! Ermittelt die neue Curserposition nachdem Drücken der 'Links'
  287. //! Pfeiltaste \param pos Die alte Curserposition
  288. DLLEXPORT int getLKick(int pos) const;
  289. //! Ermittelt die neue Curserposition nachdem Drücken der 'Oben'
  290. //! Pfeiltaste \param pos Die alte Curserposition
  291. DLLEXPORT int getOKick(int pos) const;
  292. //! Ermittelt die neue Curserposition nachdem Drücken der 'Rechts'
  293. //! Pfeiltaste \param pos Die alte Curserposition
  294. DLLEXPORT int getRKick(int pos) const;
  295. //! Ermittelt die neue Curserposition nachdem Drücken der 'Unten'
  296. //! Pfeiltaste \param pos Die alte Curserposition
  297. DLLEXPORT int getUKick(int pos) const;
  298. //! Überprüft, ob im Text der Inhalt eines anderen Textes vorkommt
  299. //! \param t Der Text, nach dessen Inhalt gesucht werden soll
  300. //! \return (true), wenn der Inhalt des Textes vorkommt. (false) sonnst
  301. DLLEXPORT bool hat(Text* t) const;
  302. //! Überprüft, ob im Text eine bestimmte Zeichenkette vorkommt
  303. //! \param t Die Zeichenkette, nach der gesucht werden soll
  304. //! \return (true), wenn die Zeichenkette vorkommt. (false) sonnst
  305. DLLEXPORT bool hat(const char* t) const;
  306. //! Überprüft, ob im Text eine bestimmte Zeichenkette vorkommt
  307. //! \param searchStartIndex Der index ab dem gesucht werden soll
  308. //! \param t Die Zeichenkette, nach der gesucht werden soll
  309. //! \return (true), wenn die Zeichenkette vorkommt. (false) sonnst
  310. DLLEXPORT bool hat(int searchStartIndex, const char* t) const;
  311. //! Überprüft, ob im Text der Inhalt eines anderen Textes vorkommt
  312. //! \param t Der Text, nach dessen Inhalt gesucht werden soll
  313. //! \return (true), wenn der Inhalt des Textes vorkommt. (false) sonnst
  314. //! \param pos die position an der die zeichenkette im string beginnen
  315. //! soll
  316. DLLEXPORT bool hatAt(int pos, Text* t) const;
  317. //! Überprüft, ob im Text eine bestimmte Zeichenkette vorkommt
  318. //! \param t Die Zeichenkette, nach der gesucht werden soll
  319. //! \return (true), wenn die Zeichenkette vorkommt. (false) sonnst
  320. //! \param pos die position an der die zeichenkette im string beginnen
  321. //! soll
  322. DLLEXPORT bool hatAt(int pos, const char* t) const;
  323. //! Überprüft, ob im Text ein bestimmtes Zeichen vorkommt
  324. //! \param c Das Zeichen, nach dem gesucht werden soll
  325. //! \return (true), wenn das Zeichen vorkommt. (false) sonnst
  326. DLLEXPORT bool hat(char c) const;
  327. //! Überprft, ob der Text den selben Inhalt wie eine Zeichenkette hat
  328. //! \param t Die Zeichenkette, die verglichen werden soll
  329. //! \return (true), wenn der Inhalt des Textes gleich der Zeichenkette
  330. //! ist. (false) sonst
  331. DLLEXPORT bool istGleich(const char* t) const;
  332. //! Überprft, ob der Text den selben Inhalt wie ein anderer Text hat
  333. //! \param t Der Text, dessen Inhalt verglichen werden soll
  334. //! \return (true), wenn die Inhalte der Texte übereinstimmen. (false)
  335. //! sonst
  336. DLLEXPORT bool istGleich(Text* t) const;
  337. //! Gibt den Inhalt des Textes als Zeichenkette zurück
  338. DLLEXPORT const char* getText() const;
  339. //! Zählt, wie oft ein bestimmter Buchstabe im Text vorkomt
  340. //! \param c Der Buchstabe, der gezählt werden soll
  341. //! \return Die Anzahl des Buchstabens im Text
  342. DLLEXPORT int anzahlVon(char c) const;
  343. //! Zählt, wie oft eine bestimmte Zeichenkette im Text vorkommt
  344. //! \param t Die Zeichenkette, die gezählt werden soll
  345. //! \return Die Anzahl der Zeichenkette im Text
  346. DLLEXPORT int anzahlVon(const char* t) const;
  347. //! Zählt, wie oft der Inhalt eines Textest im Text vorkommt
  348. //! \param t Der Text, dessen Inhalt gezählt werden soll
  349. //! \return Die Anzahl des Textinhaltes im Text
  350. DLLEXPORT int anzahlVon(Text* t) const;
  351. //! Gibt die erste Position eines bestimmten Buchstabens im Text zurück
  352. //! \param c Der Buchstabe, der gefunden werden soll
  353. //! \return Die Position des ersten Vorkommens des Buchstabens
  354. DLLEXPORT int positionVon(char c) const;
  355. //! Gibt die erste Position einer bestimmten Zeichenkette im Text zurück
  356. //! \param t Die Zeichenkette, die gefunden werden soll
  357. //! \return Die Position des ersten Vorkommens der Zeichenkette
  358. DLLEXPORT int positionVon(const char* t) const;
  359. //! Gibt die erste Position einer bestimmten Zeichenkette im Text zurück
  360. //! \param searchStart Index ab dem gesucht werden soll
  361. //! \param t Die Zeichenkette, die gefunden werden soll
  362. //! \return Die Position des ersten Vorkommens der Zeichenkette
  363. DLLEXPORT int positionVon(int searchStart, const char* t) const;
  364. //! Gibt die erste Position eines Textinhaltes im Text zurück
  365. //! \param t Der Text, dessen Inhalt gefunden werden soll
  366. //! \return Die Position des ersten Vorkommens des Textinhaltes
  367. DLLEXPORT int positionVon(Text* t) const;
  368. //! Gibt die i-te Position eines bestimmten Buchstabens im Text zurück
  369. //! \param c Der Buchstabe, der gefunden werden soll
  370. //! \param i Das wievielte Vorkommen gefunden werden soll
  371. //! \return Die Position des i-ten Vorkommens des Buchstabens
  372. DLLEXPORT int positionVon(char c, int i) const;
  373. //! Gibt die i-te Position einer bestimmten Zeichenkette im Text zurück
  374. //! \param t Die Zeichenkette, die gefunden werden soll
  375. //! \param i Das wievielte Vorkommen gefunden werden soll
  376. //! \return Die Position des i-ten Vorkommens der Zeichenkette
  377. DLLEXPORT int positionVon(const char* t, int i) const;
  378. //! Gibt die i-te Position eines Textinhaltes im Text zurück
  379. //! \param t Der Text, dessen Inhalt gefunden werden soll
  380. //! \param i Das wievielte Vorkommen gefunden werden soll
  381. //! \return Die Position des i-ten Vorkommens des Textinhaltes
  382. DLLEXPORT int positionVon(Text* t, int i) const;
  383. //! Gibt einen Text zurück, der eine Kopie eines bestimmten
  384. //! Textabschnittes enthält
  385. //! p1: Die Startposition des Textabschnittes
  386. //! p2: Die Endposition des Textabschnittes (nicht enthalten)
  387. DLLEXPORT Text* getTeilText(int p1, int p2) const;
  388. //! Gibt einen Text zurück, der eine Kopie eines bestimmten
  389. //! Textabschnittes enthält
  390. //! p1: Die Startposition des Textabschnittes (Der Textabschnitt geht
  391. //! bis ans Ende des Textes)
  392. DLLEXPORT Text* getTeilText(int p) const;
  393. //! berechnet den Hash code des textes
  394. DLLEXPORT int hashCode() const;
  395. //! Hängt eine Zahl ans Ende des Textes an
  396. DLLEXPORT Text& operator+=(const int num);
  397. //! Hängt eine Zahl ans Ende des Textes an
  398. DLLEXPORT Text& operator+=(const __int64 num);
  399. //! Hängt eine Kommazahl ans Ende des Textes an
  400. DLLEXPORT Text& operator+=(const double num);
  401. //! Hängt eine Kommazahl ans Ende des Textes an
  402. DLLEXPORT Text& operator+=(const float num);
  403. //! Hängt eine Zeichenkette ans Ende des Textes an
  404. DLLEXPORT Text& operator+=(const char* txt);
  405. //! Hängt eine Kopie des Inhalts eines Textes ans Ende des Textes an
  406. DLLEXPORT Text& operator+=(const Text& txt);
  407. //! Setzt den Inhalt des Textes gleich einer Zahl
  408. DLLEXPORT Text& operator=(const int num);
  409. //! Setzt den Inhalt des Textes gleich einer Kommazahl
  410. DLLEXPORT Text& operator=(const double num);
  411. //! Setzt den Inhalt des Textes gleich einer Kommazahl
  412. DLLEXPORT Text& operator=(const float num);
  413. //! Setzt den Inahlt des Textes gleich einer Zeichenkette
  414. DLLEXPORT Text& operator=(const char* txt);
  415. //! Setzt den Inhalt des Textes gleich einer Kopie des Inhalts eines
  416. //! anderen Textes
  417. DLLEXPORT Text& operator=(const Text& txt);
  418. //! Gibt den Inhalt des Textes als Zeichenkette zurück
  419. DLLEXPORT operator const char*() const;
  420. //! Konviertiert den Inhalt des Textes zu einer Zahl
  421. DLLEXPORT explicit operator int() const;
  422. //! Konviertiert den Inhalt des Textes zu einer Zahl
  423. DLLEXPORT explicit operator __int64() const;
  424. //! Konviertiert den Inhalt des Textes zu einer Kommazahl
  425. DLLEXPORT explicit operator double() const;
  426. //! Konviertiert den Inhalt des Textes zu einer Kommazahl
  427. DLLEXPORT explicit operator float() const;
  428. //! Prüft, ob der Inhalt des Textes nach alphabetischer Ordnung später
  429. //! kommt als der Inhalt eines anderen Textes
  430. DLLEXPORT bool operator>(Text& t) const;
  431. //! Prüft, ob der Inhalt des Textes nach alphabetischer Ordnung früher
  432. //! kommt als der Inhalt eines anderen Textes
  433. DLLEXPORT bool operator<(Text& t) const;
  434. //! Erstellt einen neuen Text bestehend aus diesem und t2
  435. DLLEXPORT Text operator+(const Text& t2) const;
  436. //! Erstellt einen neuen Text bestehend aus diesem und t2
  437. DLLEXPORT Text operator+(const char* t2) const;
  438. //! Erstellt einen neuen Text bestehend aus diesem und num
  439. DLLEXPORT Text operator+(const int num) const;
  440. //! Erstellt einen neuen Text bestehend aus diesem und num
  441. DLLEXPORT Text operator+(const __int64 num) const;
  442. //! Erstellt einen neuen Text bestehend aus diesem und num
  443. DLLEXPORT Text operator+(const double num) const;
  444. //! Erstellt einen neuen Text bestehend aus diesem und num
  445. DLLEXPORT Text operator+(const float num) const;
  446. //! Prüft ob der Text mit dem anderen Text übereinstimmt
  447. DLLEXPORT bool operator==(const Text& right) const;
  448. };
  449. class TextReader : public Reader,
  450. public virtual ReferenceCounter
  451. {
  452. private:
  453. Text* txt;
  454. __int64 lPos;
  455. public:
  456. //! Konstructor
  457. //! \param txt Der Text der gelesen werden soll. Er wird nicht kopiert
  458. //! sondern direkt gelesen.
  459. DLLEXPORT TextReader(Text* txt);
  460. //! Destructor
  461. DLLEXPORT virtual ~TextReader();
  462. //! Setzt die Position des Bytes, das als nächstes gelesen werden soll
  463. //! \param pos Der Index des Bytes
  464. //! \param ende 1, wenn der Index vom ende des Textes zählt. 0, wenn der
  465. //! Index vom Beginn des Textes zählt
  466. DLLEXPORT void setLPosition(__int64 pos, bool ende) override;
  467. //! Ließt aus der Datei
  468. //! \param bytes Ein Array, der mit Bytes aus dem Text gefüllt werden
  469. //! soll \param len Wie viele Bytes aus dem Text gelesen werden sollen
  470. DLLEXPORT void lese(char* bytes, int len) override;
  471. //! Ließt die nächste zeile des Textes ein
  472. //! \return Die gelesene Zeile als Text mit zeilenumbruch
  473. DLLEXPORT Text* leseZeile() override;
  474. //! Prüft, ob die Resource vollständig gelesen wurde
  475. //! return 1, wenn die Resource vollständig gelesen wurde. 0, sonst
  476. DLLEXPORT bool istEnde() const override;
  477. //! Gibt den Index des Bytes aus dem Text zurück, welches als nächstes
  478. //! gelesen werden würde return -1, falls ein Fehler aufgetreten ist.
  479. //! Sonst die Position des Lesezeigers
  480. DLLEXPORT __int64 getLPosition() const override;
  481. //! Gibt die Anzahl der zu lesenden Bytes zurück
  482. DLLEXPORT __int64 getSize() const override;
  483. };
  484. //! Durchsucht eine Zeichenkette nach dem num-ten Vorkommen eines bestimmten
  485. //! Buchstabens \param string Die zu durchsuchende Zeichenkette \param c Der
  486. //! zu suchende Buchstabe \param num Das wievielte Vorkommen des Buchtaben
  487. //! gefunden werden soll \return (-1), wenn es kein num-tes Vorkommen des
  488. //! Buchstaben gibt. Sonst die Position des num-ten Vorkommens in der
  489. //! Zeichenkette
  490. DLLEXPORT int stringPositionVonChar(const char* string,
  491. char c,
  492. int num); //! sucht die position des num-ten c-s in string, -1 bei nicht
  493. //! gefunden
  494. //! Durchsucht eine Zeichenkette nach einer Anderen Zeichenkette
  495. //! \param string Die zu durchsuchende Zeichenkette
  496. //! \param suche Die Zeichenkette, nach der gesucht werden soll
  497. //! \param sBegPos Die Position, ab der die Suche begonnen werden soll
  498. //! \return Die Position, an der die zu suchende Zeichenkette erstmals
  499. //! gefunden wurde. (-1) Wenn nichts gefunden wurde.
  500. DLLEXPORT int stringPositionVonString(
  501. const char* string, char* suche, int sBegPos);
  502. //! Kopiert eine bestimmte Zeichenkette in die Zwischenablage des
  503. //! Betriebssystems \param txt Die Zeichenkette, die kopiert werden soll
  504. DLLEXPORT void TextKopieren(const char* txt);
  505. //! Ermittelt, ob in der Zwischenablage des Betriebssystems eine
  506. //! Zeichenkette steht. \return Die Zeichenkette aus der Zwischenablage.
  507. //! Wenn keine Zeichenkette kopiert wurde, wird eine lehre Zeichenkette
  508. //! zurückgegeben.
  509. DLLEXPORT const char* TextInsert();
  510. //! Wandelt einen bestimmten schreibbaren Buchstaben in einen Groß- oder
  511. //! Kleinbuchstaben um \param c Der Buchstabe, der umgewandelt werden soll
  512. //! \param groß Wenn (true), so wird der Buchstabe in einen Großbuchstaben
  513. //! umgewandelt. Wenn (false), wird er in einen Kleinbuchstaben umgewandelt.
  514. //! \return Den umgewandelten Buchstaben
  515. DLLEXPORT char smallOrBig(char c, bool big);
  516. //! Ermittelt, ob ein Buchstabe ein schreibbares Zeichen ist
  517. //! \param zeichen Der Buchstabe, der geprüft werden soll
  518. //! \return (true), wenn der Buchstabe gezeichnet werden kann. (false)
  519. //! sonnst
  520. DLLEXPORT bool istSchreibbar(unsigned char zeichen);
  521. //! Konvertiert eine Zahl aus einer Zeichenkette in belibiger Basis zu einer
  522. //! Zahl \param c Die Zeichenkette, in der Die Zahl steht \param system Die
  523. //! Basis der Zahl \return Die Zahl, die im Text stand
  524. DLLEXPORT unsigned int TextZuInt(const char* c, int system);
  525. //! Konvertiert eine Zahl aus einer Zeichenkette in belibiger Basis zu einer
  526. //! Zahl \param c Die Zeichenkette, in der Die Zahl steht
  527. //! c_ende: Wird duch die Funktion gesetzt und darf 0 sein. Zeigt auf das
  528. //! nächste Zeichen in der Zeichenkette, das nach der Zah steht
  529. //! \param system Die Basis der Zahl
  530. //! \return Die Zahl, die im Text stand
  531. DLLEXPORT unsigned int TextZuInt(const char* c, char** c_ende, int system);
  532. //! Konvertiert eine Zahl aus einer Zeichenkette in belibiger Basis zu einer
  533. //! Zahl \param c Die Zeichenkette, in der Die Zahl steht \param system Die
  534. //! Basis der Zahl \return Die Zahl, die im Text stand
  535. DLLEXPORT unsigned __int64 TextZuInt64(const char* c, int system);
  536. //! Konvertiert eine Zahl aus einer Zeichenkette in belibiger Basis zu einer
  537. //! Zahl \param c Die Zeichenkette, in der Die Zahl steht
  538. //! c_ende: Wird duch die Funktion gesetzt und darf 0 sein. Zeigt auf das
  539. //! nächste Zeichen in der Zeichenkette, das nach der Zah steht
  540. //! \param system Die Basis der Zahl
  541. //! \return Die Zahl, die im Text stand
  542. DLLEXPORT unsigned __int64 TextZuInt64(
  543. const char* c, char** c_ende, int system);
  544. //! Konvertiert eine Zeichenkette zu einem Double
  545. //! \param c Die Zeichenkette, die konvertiert werden soll
  546. //! \return Das double, was in der Zeichenkette stand
  547. DLLEXPORT double TextZuDouble(const char* c);
  548. //! Konvertiert eine Zeichenkette zu einem Float
  549. //! \param c Die Zeichenkette, die konvertiert werden soll
  550. //! \return Das float, was in der Zeichenkette stand
  551. DLLEXPORT float TextZuFloat(const char* c);
  552. //! Konvertiert eine Zeichenkette zu einem Double
  553. //! \param c Die Zeichenkette, die konvertiert werden soll
  554. //! c_ende: Wird duch die Funktion gesetzt und darf 0 sein. Ein Zeiger auf
  555. //! das nächste Zeichen nach dem Double in der Zeichenkette
  556. //! \return Das double, was in der Zeichenkette stand
  557. DLLEXPORT double TextZuDouble(const char* c, char** c_ende);
  558. //! Konvertiert eine Zeichenkette zu einem float
  559. //! \param c Die Zeichenkette, die konvertiert werden soll
  560. //! c_ende: Wird duch die Funktion gesetzt und darf 0 sein. Ein Zeiger auf
  561. //! das nächste Zeichen nach dem float in der Zeichenkette
  562. //! \return Das float, was in der Zeichenkette stand
  563. DLLEXPORT float TextZuFloat(const char* c, char** c_ende);
  564. //! Ermittelt die Länge einer bestimmten Zeichenkette
  565. //! \param txt Die Zeichenkette, deren Länge ermittelt werden soll
  566. //! \return Die Länge der Zeichenkette
  567. DLLEXPORT int textLength(const char* txt);
  568. } // namespace Framework
  569. #endif