Datei.h 10 KB

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