Klassenreferenz: Datei

Klasse TextdateiSchreiber

Mit dieser Klasse lässt sich ein Text in eine Datei schreiben. Die Datei wird, falls sie nicht vorhanden ist, neu angelegt. Es gibt auch die Möglichkeit einen Text 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 sich Text in die Datei schreiben lässt.

• Objektname = TextdateiSchreiber ( Parameter )

• Datei=TextdateiSchreiber(Name="EineDatei.txt")
  schreibeZeile(Text="Dies ist eine Datei"):Datei
  schreibe(Text="mit "):Datei
  schreibeZeile(Text="zwei Zeilen!"):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 TextdateiSchreiber

• 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 Textdatei, so dass der Inhalt der Datei von allen Programmen gelesen werden kann.
• schreibe: Schreibt den angegebenen Text in die Datei ohne am Ende einen Zeilenumbruch einzufügen.
• schreibeZeile: Schreibt den angegebenen Text in die Datei und verursacht am Ende des Texts einen Zeilenumbruch.

Methoden der Klasse TextdateiSchreiber 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=TextdateiSchreiber(Name="EineDatei.txt")
  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 Textdatei, 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

• schließe:Datei

• 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 Text in die Datei ohne am Ende einen Zeilenumbruch einzufügen. Alle auftretenden "|" im Text verursachen einen Zeilenumbruch.

• schreibe ( Parameter ) : Objektname

• Datei=TextdateiSchreiber(Name="EineDatei.txt")
  schreibe(Text="Eins, zwei"):Datei
  schreibe(Text=", drei!"):Datei % schreibt "Eins, zwei, drei!"
  schließe:Datei

• Text = Text()
  Gibt den Text an, der in die Datei geschrieben werden soll.
   

Schreibt den angegebenen Text in die Datei und verursacht am Ende des Texts einen Zeilenumbruch. Alle auftretenden "|" im Text verursachen ebenfalls einen Zeilenumbruch.

• schreibeZeile ( Parameter ) : Objektname

• Datei=TextdateiSchreiber(Name="EineDatei.txt")
  schreibeZeile(Text="Zeile 1"):Datei
  schreibeZeile(Text="Zeile 2"):Datei
  schließe:Datei

• Text = Text()
  Gibt den Text an, der in die Datei geschrieben werden soll.
   

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