Datei.h 9.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224
  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. //! Schreibt alle temporären bytes in die Datei
  93. DLLEXPORT void flush();
  94. //! Ließt aus der Datei
  95. //! \param bytes Ein Array, der mit Bytes aus der Datei gefüllt werden
  96. //! soll \param len Wie viele Bytes aus der Datei gelesen werden sollen
  97. DLLEXPORT void lese(char* bytes, int len) override;
  98. //! Ließt die nächste zeile der Datei ein
  99. //! \return Die gelesene Zeile als Text mit zeilenumbruch
  100. DLLEXPORT Text* leseZeile() override;
  101. //! Schließt die datei
  102. DLLEXPORT void close();
  103. //! Setzt den Schlüssel für die Datei
  104. DLLEXPORT void setKey(char* s, int l);
  105. #ifdef WIN32
  106. //! Setzt den Zeitpunkt der letzten Änderung der Datei (nur für Windows)
  107. //! \param zeit den Zeitpunkt der letzten Änderung
  108. //! \return 1, wenn der Zeitpunkt gesetzt wurde. 0 sonst
  109. DLLEXPORT bool setLetzteÄnderung(Zeit* zeit);
  110. #endif
  111. //! Ließt das nächste Bit aus der Datei
  112. //! \param bit Eine Referenz auf deinen bool, in dem das Bit gespeichert
  113. //! wird
  114. //! return 1, falls das lesen erfolgreich war. 0, sonst
  115. DLLEXPORT bool getNextBit(bool& bit);
  116. //! Speichert ein einzelnes Bit in der Datei
  117. //! \param bit Das bit, welches gespeichert werden soll
  118. //! return 1, falls das speichern erfolgreich war
  119. DLLEXPORT bool setNextBit(bool bit);
  120. //! Prüft, ob die Datei ein Verzeichnis ist
  121. //! return 1, falls die Datei ein Verzeichnis ist. 0, sonst
  122. DLLEXPORT bool istOrdner() const;
  123. //! Prüft, ob die Datei bereits geöffnet wurde
  124. //! \return 1, wenn die Datei geöffnet ist. 0 sonnst
  125. DLLEXPORT bool istOffen() const;
  126. //! Gibt die Anzahl an Unterdateien von dem Verzeichnis zurück
  127. //! \return 0, falls die Datei kein Verzeichnis ist. Sonst die Anzahl
  128. //! der Unterdateien
  129. DLLEXPORT int getUnterdateiAnzahl() const;
  130. //! Gibt eine Liste mit unterdateien zurück
  131. //! return 0, falls die Datei kein Verzeichnis ist. Eine Liste mit den
  132. //! Namen der Unterdateien
  133. DLLEXPORT RCArray<Text>* getDateiListe() const;
  134. //! Gibt die Größe der Datei zurück
  135. //! return -1, falls die Datei ein Verzeichnis ist oder ein Fehler
  136. //! auftrat. Sonst die größe der Datei
  137. DLLEXPORT __int64 getSize() const;
  138. //! Gibt den Zeitpunkt der letzten änderung zurück
  139. //! \return 0, falls ein Fehler aufgetreten ist. Der Zeitpunkt der
  140. //! letzten Änderung sonst
  141. DLLEXPORT Zeit* getLastChange() const;
  142. //! Prüft, ob die Datei existiert
  143. //! \return 1, falls die Datei existiert. 0 sonnst
  144. DLLEXPORT bool existiert() const;
  145. //! Gibt den Index des Bytes aus der Datei zurück, welches als nächstes
  146. //! gelesen werden würde return -1, falls ein Fehler aufgetreten ist.
  147. //! Sonst die Position des Lesezeigers
  148. DLLEXPORT __int64 getLPosition() const override;
  149. //! Gibt den Index des Bytes aus der Datei zurück, welches als nächstes
  150. //! überschrieben werden würde return -1, falls ein Fehler aufgetreten
  151. //! ist. Sonst die Position des Schreibzeigers
  152. DLLEXPORT __int64 getSPosition() const override;
  153. //! Prüft, ob die Datei vollständig gelesen wurde
  154. //! return 1, wenn die Datei vollständig gelesen wurde. 0, sonst
  155. DLLEXPORT bool istEnde() const override;
  156. //! Gibt den Pfad zur Datei zurück
  157. DLLEXPORT Text* getPfad() const;
  158. //! Gibt den Pfad zur Datei ohne erhöhten Reference Counter zurück
  159. DLLEXPORT Text* zPfad() const;
  160. };
  161. //! Datei Funktionen
  162. //! Sucht einen unbenutzten Dateinamen
  163. //! \param zPfad Ein Zeiger zu dem Pfad, in dem ein unbenutzter Dateiname
  164. //! gefunden werden soll. Ohne erhöhten Reference Counter.
  165. //! Wird auch als rückgabewert benutzt
  166. DLLEXPORT void GetFreePfad(Text* zPfad);
  167. //! Erstellt den vollständigen Pfad mit Datei
  168. //! \param pfad Der Pfad zur Datei
  169. //! \return 1, falls das erstellen erfolgreich war.
  170. DLLEXPORT bool DateiPfadErstellen(Text* pfad);
  171. //! Löscht die angegebene Datei
  172. //! \param pfad Der Pfad zur Datei
  173. //! \return 1, falls die Datei gelöscht wurde
  174. DLLEXPORT bool DateiRemove(Text* pfad);
  175. //! Benennt eine Datei um oder verschiebt sie
  176. //! pfad_alt: Der Pfad zur Datei, die umbenannt werden soll.
  177. //! pfad_neu: Der neue Pfad zur Datei. Wenn sich nur der Name ändert, wird
  178. //! sie nur umbenannt
  179. //! \return 1, wenn das umbenennen erfolgreich war. 0, sonst
  180. DLLEXPORT bool DateiUmbenennen(Text* pfad_alt, Text* pfad_neu);
  181. //! Prüft, ob Datei existiert
  182. //! \param pfad Der Pfad zur Datei
  183. //! \return 1, wenn die Datei existiert. 0, wenn die Datei nicht gefunden
  184. //! wurde
  185. DLLEXPORT bool DateiExistiert(Text* pfad);
  186. //! prüft, ob pfad ein Verzeichnis ist
  187. //! \param pfad Der Pfad zur Datei
  188. //! \return 1, wenn die Datei ein Verzeichnis ist. 0 sonst
  189. DLLEXPORT bool DateiIstVerzeichnis(Text* pfad);
  190. //! Erstellt den vollständigen Pfad mit Datei
  191. //! \param pfad Der Pfad zur Datei
  192. //! \return 1, falls das erstellen erfolgreich war.
  193. DLLEXPORT bool DateiPfadErstellen(const char* pfad);
  194. //! Löscht die angegebene Datei
  195. //! \param pfad Der Pfad zur Datei
  196. //! \return 1, falls die Datei gelöscht wurde
  197. DLLEXPORT bool DateiRemove(const char* pfad);
  198. //! Benennt eine Datei um oder verschiebt sie
  199. //! pfad_alt: Der Pfad zur Datei, die umbenannt werden soll.
  200. //! pfad_neu: Der neue Pfad zur Datei. Wenn sich nur der Name ändert, wird
  201. //! sie nur umbenannt
  202. //! \return 1, wenn das umbenennen erfolgreich war. 0, sonst
  203. DLLEXPORT bool DateiUmbenennen(const char* pfad_alt, const char* pfad_neu);
  204. //! Prüft, ob Datei existiert
  205. //! \param pfad Der Pfad zur Datei
  206. //! \return 1, wenn die Datei existiert. 0, wenn die Datei nicht gefunden
  207. //! wurde
  208. DLLEXPORT bool DateiExistiert(const char* pfad);
  209. //! prüft, ob pfad ein Verzeichnis ist
  210. //! \param pfad Der Pfad zur Datei
  211. //! \return 1, wenn die Datei ein Verzeichnis ist. 0 sonst
  212. DLLEXPORT bool DateiIstVerzeichnis(const char* pfad);
  213. } // namespace Framework
  214. #endif