Klassenreferenz: Datei

Klasse DateiSchreiber

Mit dieser Klasse lässt sich eine binäre Datei schreiben. Die Datei wird, falls sie nicht vorhanden ist, neu angelegt. Es gibt auch die Möglichkeit Daten an eine vorhandene Datei anzuhängen. Nach dem Schreiben der Datei sollte die Methode 'schließe' aufgerufen werden. Mit der Methode 'istBereit' lässt sich herausfinden, ob die Datei ordnungsgemäß erzeugt beziehungsweise geöffnet wurde und ob in die Datei geschrieben werden kann.

• Objektname = DateiSchreiber ( Parameter )

• Datei=DateiSchreiber(Name="data.dat")
  wenn istBereit:Datei dann
  schreibe(Text="Hallo"):Datei
  schreibe(Zahl=-1420042):Datei
  schreibe(Kommazahl=3001.123):Datei
  schreibe(Bool=wahr):Datei
  schreibe(Zeichen="A"):Datei
  schreibe(Zeichen="bc"):Datei
  schreibe(Byte=255):Datei
  schreibe(Wort=65535):Datei
  schließe:Datei

• Name = Text()
  Gibt den relativen Namen der Datei auf dem Datenträger an (z.B. 'Name="KidsPL/Datei.txt"'). Die Dateinamen beziehen sich auf das Verzeichnis mit den persönlichen Dateien des angemeldeten Nutzers. Dateinamen mit absoluten Pfadangaben müssen mit '/' starten (z.B. 'Name="/C:\Datei.txt"').
   
• anfügen = Bool()
  Dieser Parameter bestimmt, ob der Text an eine vorhandene Datei angefügt wird ('anfügen=wahr') oder ob die Datei neu geschrieben wird ('anfügen=falsch'). Standardmäßig wird die Datei neu geschrieben.
   

Methoden der Klasse DateiSchreiber

• gibDateiname: Gibt den absoluten Pfad der Datei auf dem Datenträger zurück.
• istBereit: Die Methode überprüft, ob die Datei bereit ist, so dass in die Datei geschrieben werden kann.
• schließe: Diese Methode schließt die Datei, so dass der Inhalt der Datei von allen Programmen gelesen werden kann.
• schreibe: Schreibt den angegebenen Parameter binär in die Datei.

Methoden der Klasse DateiSchreiber im Detail

Gibt den absoluten Pfad der Datei auf dem Datenträger zurück.

• gibDateiname : Objektname

• schreibe:gibDateiname:Datei

• Text()
  Der absolute Pfad der Datei, der alle Unterverzeichnisse enthält.
   

Die Methode überprüft, ob die Datei bereit ist, so dass in die Datei geschrieben werden kann.

• istBereit : Objektname

• Datei=DateiSchreiber(Name="data.dat")
  wenn nicht istBereit:Datei dann
  schreibe:"Ein Dateifehler ist aufgetreten."

• Bool()
  Gibt 'wahr' zurück, wenn die Datei ordnungsgemäß geöffnet wurde und in die Datei geschrieben werden kann. Ansonsten wird 'falsch' zurückgegeben.
   

Diese Methode schließt die Datei, so dass der Inhalt der Datei von allen Programmen gelesen werden kann. Die Methode muss nach dem letzten Schreibvorgang aufgerufen werden. Nachdem die Datei geschlossen wurde, kann in die Datei nicht mehr geschrieben werden und die Methode 'istBereit' gibt den Wert 'falsch' zurück.

• schließe : Objektname

• wenn schließe:Datei dann
  schreibe:"Erfolgreich geschrieben."

• Bool()
  Der Rückgabewert ist 'wahr', wenn die Datei ordnungsgemäß geschlossen wurde und während des Öffnens und Schreibens kein Fehler aufgetreten ist. Sonst wird 'falsch' zurückgegeben.
   

Schreibt den angegebenen Parameter binär in die Datei. Es wird dabei immer nur ein Parameter geschrieben.

• schreibe ( Parameter ) : Objektname

• schreibe(Text="Hallo"):Datei
• schreibe(Zahl=-1420042):Datei
• schreibe(Kommazahl=3001.123):Datei
• schreibe(Bool=wahr):Datei
• schreibe(Zeichen="A"):Datei
• schreibe(Zeichen="bc"):Datei
• schreibe(Byte=255):Datei
• schreibe(Wort=65535):Datei

• Text = Text()
  Gibt einen Text an, der in die Datei geschrieben werden soll.
   
• Zahl = Zahl()
  Gibt eine Zahl an, die in die Datei geschrieben werden soll. Die Zahl nimmt vier Bytes in der Datei ein und kann negativ sein.
   
• Kommazahl = Kommazahl()
  Gibt eine Kommazahl an, die in die Datei geschrieben werden soll.
   
• Bool = Bool()
  Gibt einen Bool-Wert an, der in die Datei geschrieben werden soll.
   
• Zeichen = Text()
  Gibt einen Text an, dessen Zeichen einzeln in die Datei geschrieben werden. Dabei werden keinerlei Informationen gespeichert, wie lang der Text ist, wie es beim Parameter 'Text' passiert.
   
• Byte = Zahl()
  Gibt eine Zahl an, die in die Datei geschrieben werden soll. Die Zahl nimmt ein Byte in der Datei ein. Dies entspricht einem Zahlwert von 0 bis 255.
   
• Wort = Zahl()
  Gibt eine Zahl an, die in die Datei geschrieben werden soll. Die Zahl nimmt ein Wort (2 Bytes) in der Datei ein. Dies entspricht einem Zahlwert von 0 bis 65535.
   

© Kids' Programming Language - Programmieren für Kinder Die Programmiersprache für Kinder und Jugendliche www.KidsPL.de - Letzte Änderung am 05.08.08