Datei.h 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222
  1. #ifndef Datei_H
  2. #define Datei_H
  3. #include <fstream>
  4. #include "Array.h"
  5. #include "Reader.h"
  6. #include "Writer.h"
  7. namespace Framework
  8. {
  9. class Text; //! Text.h
  10. class Zeit; //! Zeit.h
  11. namespace Encryption
  12. {
  13. class Key; //! Schlüssel.h
  14. }
  15. class Datei; //! aus dieser Datei
  16. //! Ließt und schreibt in eine Datei
  17. class Datei : public Reader,
  18. public Writer,
  19. public virtual ReferenceCounter
  20. {
  21. public:
  22. class Style
  23. {
  24. public:
  25. static const int lesen = 0x01; //! datei wird zum lesen geöffnet
  26. static const int schreiben
  27. = 0x02; //! datei wirt zum schreiben geöffnet
  28. static const int ende
  29. = 0x04; //! setzt dateizeiger ans Ende der Datei
  30. };
  31. private:
  32. std::fstream* stream;
  33. Text* pfad;
  34. __int64 gr;
  35. char tmpLByte;
  36. char tmpLBPos;
  37. char tmpSByte;
  38. char tmpSBPos;
  39. Encryption::Key* key;
  40. public:
  41. //! Konstruktor
  42. DLLEXPORT Datei();
  43. //! Konstruktor
  44. DLLEXPORT Datei(const char* pfad);
  45. //! Konstruktor
  46. DLLEXPORT Datei(Text* pfad);
  47. //! Destruktor
  48. DLLEXPORT virtual ~Datei();
  49. //! Setzt den Pfad zur Datei
  50. //! \param pfad Der Pfad
  51. DLLEXPORT void setDatei(const char* pfad);
  52. //! Setzt den Pfad zur Datei
  53. //! \param pfad Der Pfad
  54. DLLEXPORT void setDatei(Text* pfad);
  55. //! Benennt die Datei um oder verschiebt sie
  56. //! \param pfad Der neue Pfad zur Datei. Wenn sich nur der Name ändert,
  57. //! wird sie nur umbenannt \return 1, wenn das umbenennen erfolgreich
  58. //! war. 0, sonst
  59. DLLEXPORT bool umbenennen(const char* pfad);
  60. //! Benennt die Datei um oder verschiebt sie
  61. //! \param pfad Der neue Pfad zur Datei. Wenn sich nur der Name ändert,
  62. //! wird sie nur umbenannt \return 1, wenn das umbenennen erfolgreich
  63. //! war. 0, sonst
  64. DLLEXPORT bool umbenennen(Text* pfad);
  65. //! Löscht die Datei
  66. //! \return 1, wenn das löschen erfolgreich war. 0 sonst
  67. DLLEXPORT bool remove();
  68. //! Erstellt die Datei neu. Wenn im Pfad Ordner vorkommen, die nicht
  69. //! existieren, so werden sie erstellt
  70. //! return 1: wenn das erstellen erfolgreich war. 0, sonst
  71. DLLEXPORT bool erstellen();
  72. //! Öffnet die Datei
  73. //! \param style Legt fest, ob die Datei zum lesen und/oder schreiben
  74. //! geöffnet wird. Alle Elemente aus Datei::Style:: sin möglich
  75. //! return 1: wenn die datei erfolgreich geöffnet werden konnte. 0
  76. //! sonnst
  77. DLLEXPORT bool open(int style);
  78. //! Setzt die Position des Bytes, das als nächstes gelesen werden soll
  79. //! \param pos Der Index des Bytes
  80. //! \param ende 1, wenn der Index vom ende der Datei zählt. 0, wenn der
  81. //! Index vom Beginn der Datei zählt
  82. DLLEXPORT void setLPosition(__int64 pos, bool ende) override;
  83. //! Setzt die Position des Bytes, das als nächstes überschrieben wird
  84. //! \param pos Der Index des Bytes
  85. //! \param ende 1, wenn der Index vom ende der Datei zählt. 0, wenn der
  86. //! Index vom Beginn der Datei zählt
  87. DLLEXPORT void setSPosition(__int64 pos, bool ende) override;
  88. //! Schreibt in die Datei
  89. //! \param bytes Ein Array von bytes, die geschrieben werden sollen.
  90. //! \param len Wie viele Bytes in die Datei geschrieben werden sollen
  91. DLLEXPORT void schreibe(const char* bytes, int len) override;
  92. //! Ließt aus der Datei
  93. //! \param bytes Ein Array, der mit Bytes aus der Datei gefüllt werden
  94. //! soll \param len Wie viele Bytes aus der Datei gelesen werden sollen
  95. DLLEXPORT void lese(char* bytes, int len) override;
  96. //! Ließt die nächste zeile der Datei ein
  97. //! \return Die gelesene Zeile als Text mit zeilenumbruch
  98. DLLEXPORT Text* leseZeile() override;
  99. //! Schließt die datei
  100. DLLEXPORT void close();
  101. //! Setzt den Schlüssel für die Datei
  102. DLLEXPORT void setKey(char* s, int l);
  103. #ifdef WIN32
  104. //! Setzt den Zeitpunkt der letzten Änderung der Datei (nur für Windows)
  105. //! \param zeit den Zeitpunkt der letzten Änderung
  106. //! \return 1, wenn der Zeitpunkt gesetzt wurde. 0 sonst
  107. DLLEXPORT bool setLetzteÄnderung(Zeit* zeit);
  108. #endif
  109. //! Ließt das nächste Bit aus der Datei
  110. //! \param bit Eine Referenz auf deinen bool, in dem das Bit gespeichert
  111. //! wird
  112. //! return 1, falls das lesen erfolgreich war. 0, sonst
  113. DLLEXPORT bool getNextBit(bool& bit);
  114. //! Speichert ein einzelnes Bit in der Datei
  115. //! \param bit Das bit, welches gespeichert werden soll
  116. //! return 1, falls das speichern erfolgreich war
  117. DLLEXPORT bool setNextBit(bool bit);
  118. //! Prüft, ob die Datei ein Verzeichnis ist
  119. //! return 1, falls die Datei ein Verzeichnis ist. 0, sonst
  120. DLLEXPORT bool istOrdner() const;
  121. //! Prüft, ob die Datei bereits geöffnet wurde
  122. //! \return 1, wenn die Datei geöffnet ist. 0 sonnst
  123. DLLEXPORT bool istOffen() const;
  124. //! Gibt die Anzahl an Unterdateien von dem Verzeichnis zurück
  125. //! \return 0, falls die Datei kein Verzeichnis ist. Sonst die Anzahl
  126. //! der Unterdateien
  127. DLLEXPORT int getUnterdateiAnzahl() const;
  128. //! Gibt eine Liste mit unterdateien zurück
  129. //! return 0, falls die Datei kein Verzeichnis ist. Eine Liste mit den
  130. //! Namen der Unterdateien
  131. DLLEXPORT RCArray<Text>* getDateiListe() const;
  132. //! Gibt die Größe der Datei zurück
  133. //! return -1, falls die Datei ein Verzeichnis ist oder ein Fehler
  134. //! auftrat. Sonst die größe der Datei
  135. DLLEXPORT __int64 getSize() const;
  136. //! Gibt den Zeitpunkt der letzten änderung zurück
  137. //! \return 0, falls ein Fehler aufgetreten ist. Der Zeitpunkt der
  138. //! letzten Änderung sonst
  139. DLLEXPORT Zeit* getLastChange() const;
  140. //! Prüft, ob die Datei existiert
  141. //! \return 1, falls die Datei existiert. 0 sonnst
  142. DLLEXPORT bool existiert() const;
  143. //! Gibt den Index des Bytes aus der Datei zurück, welches als nächstes
  144. //! gelesen werden würde return -1, falls ein Fehler aufgetreten ist.
  145. //! Sonst die Position des Lesezeigers
  146. DLLEXPORT __int64 getLPosition() const override;
  147. //! Gibt den Index des Bytes aus der Datei zurück, welches als nächstes
  148. //! überschrieben werden würde return -1, falls ein Fehler aufgetreten
  149. //! ist. Sonst die Position des Schreibzeigers
  150. DLLEXPORT __int64 getSPosition() const override;
  151. //! Prüft, ob die Datei vollständig gelesen wurde
  152. //! return 1, wenn die Datei vollständig gelesen wurde. 0, sonst
  153. DLLEXPORT bool istEnde() const override;
  154. //! Gibt den Pfad zur Datei zurück
  155. DLLEXPORT Text* getPfad() const;
  156. //! Gibt den Pfad zur Datei ohne erhöhten Reference Counter zurück
  157. DLLEXPORT Text* zPfad() const;
  158. };
  159. //! Datei Funktionen
  160. //! Sucht einen unbenutzten Dateinamen
  161. //! \param zPfad Ein Zeiger zu dem Pfad, in dem ein unbenutzter Dateiname
  162. //! gefunden werden soll. Ohne erhöhten Reference Counter.
  163. //! Wird auch als rückgabewert benutzt
  164. DLLEXPORT void GetFreePfad(Text* zPfad);
  165. //! Erstellt den vollständigen Pfad mit Datei
  166. //! \param pfad Der Pfad zur Datei
  167. //! \return 1, falls das erstellen erfolgreich war.
  168. DLLEXPORT bool DateiPfadErstellen(Text* pfad);
  169. //! Löscht die angegebene Datei
  170. //! \param pfad Der Pfad zur Datei
  171. //! \return 1, falls die Datei gelöscht wurde
  172. DLLEXPORT bool DateiRemove(Text* pfad);
  173. //! Benennt eine Datei um oder verschiebt sie
  174. //! pfad_alt: Der Pfad zur Datei, die umbenannt werden soll.
  175. //! pfad_neu: Der neue Pfad zur Datei. Wenn sich nur der Name ändert, wird
  176. //! sie nur umbenannt
  177. //! \return 1, wenn das umbenennen erfolgreich war. 0, sonst
  178. DLLEXPORT bool DateiUmbenennen(Text* pfad_alt, Text* pfad_neu);
  179. //! Prüft, ob Datei existiert
  180. //! \param pfad Der Pfad zur Datei
  181. //! \return 1, wenn die Datei existiert. 0, wenn die Datei nicht gefunden
  182. //! wurde
  183. DLLEXPORT bool DateiExistiert(Text* pfad);
  184. //! prüft, ob pfad ein Verzeichnis ist
  185. //! \param pfad Der Pfad zur Datei
  186. //! \return 1, wenn die Datei ein Verzeichnis ist. 0 sonst
  187. DLLEXPORT bool DateiIstVerzeichnis(Text* pfad);
  188. //! Erstellt den vollständigen Pfad mit Datei
  189. //! \param pfad Der Pfad zur Datei
  190. //! \return 1, falls das erstellen erfolgreich war.
  191. DLLEXPORT bool DateiPfadErstellen(const char* pfad);
  192. //! Löscht die angegebene Datei
  193. //! \param pfad Der Pfad zur Datei
  194. //! \return 1, falls die Datei gelöscht wurde
  195. DLLEXPORT bool DateiRemove(const char* pfad);
  196. //! Benennt eine Datei um oder verschiebt sie
  197. //! pfad_alt: Der Pfad zur Datei, die umbenannt werden soll.
  198. //! pfad_neu: Der neue Pfad zur Datei. Wenn sich nur der Name ändert, wird
  199. //! sie nur umbenannt
  200. //! \return 1, wenn das umbenennen erfolgreich war. 0, sonst
  201. DLLEXPORT bool DateiUmbenennen(const char* pfad_alt, const char* pfad_neu);
  202. //! Prüft, ob Datei existiert
  203. //! \param pfad Der Pfad zur Datei
  204. //! \return 1, wenn die Datei existiert. 0, wenn die Datei nicht gefunden
  205. //! wurde
  206. DLLEXPORT bool DateiExistiert(const char* pfad);
  207. //! prüft, ob pfad ein Verzeichnis ist
  208. //! \param pfad Der Pfad zur Datei
  209. //! \return 1, wenn die Datei ein Verzeichnis ist. 0 sonst
  210. DLLEXPORT bool DateiIstVerzeichnis(const char* pfad);
  211. } // namespace Framework
  212. #endif