Mit NAME() wird eine Datei umbenannt. Die Funktion nimmt zwei Strings als Argumente entgegen, nämlich den ursprünglichen Dateinamen und den neuen Namen, in den umbenannt werden soll. Als Funktion verwendet, liefert NAME() wie gewohnt 0, wenn kein Fehler auftritt, und -1 bei einem Fehler (z. B. bei fehlenden Schreibrechten oder wenn bereits eine Datei mit dem neuen Namen existiert).

Im zweiten Teil des Quelltextes sehen Sie, dass sich auch die Pfadangabe im alten und neuen Dateinamen unterscheiden kann. In diesem Fall versucht das Programm, die Datei zu verschieben. Wenn sich zudem auch der Dateiname unterscheidet, wird mit der Verschiebung auch eine Umbenennung durchgeführt. Umgekehrt bedeutet das aber auch: Wenn Sie eine Datei umbenennen wollen, die sich nicht im Arbeitsverzeichnis befindet, müssen Sie sowohl im alten als auch im neuen Namen den Pfad angeben, da die Datei sonst verschoben wird.

Mit dem QuickBASIC-Sprachumfang war das Kopieren einer Datei nur möglich, indem sie komplett eingelesen und die Werte in eine neue Datei geschrieben wurden. FreeBASIC greift zu diesem Zweck die Funktion FILECOPY() auf. Auch diesem Befehl wird der Quell- und der Zielname übergeben, und als Funktion aufgerufen gibt er im Erfolgsfall 0 zurück. Etwas ungewöhnlich ist, dass bei einem Fehler 1 zurückgegeben wird und nicht -1.

Über eine geöffnete Datei können mit FILEATTR() verschiedene Informationen abgerufen werden:

Dateinummer ist dabei die Nummer, unter der die Datei mit OPEN geöffnet wurde. Als Ausgabe kann einer der Werte 1, 2 oder 3 angegeben werden. Statt sich jedoch eine recht nichtssagende Nummernaufteilung merken zu müssen, stellt file.bi Konstanten zur Verfügung, die stattdessen verwendet werden können. Wird Ausgabe nicht angegeben, verwendet FreeBASIC den Wert fbFileAttrMode.

Der Rückgabewert für die Ausgabeoption fbFileAttrHandle ist der Handle, über den das System auf die Datei zugreift. Er ist identisch mit dem, den auch die C-Runtime-Library verwendet. Der Handle kann damit an andere C-Funktionen übergeben werden. Dieses Thema führt hier allerdings zu weit. Zu den anderen Optionen folgt ein Beispiel in Quelltext 17.6.
Kann eine Information nicht abgefragt werden, z. B. weil die angegebene Dateinummer nicht belegt ist, so ist der Rückgabewert 0.

Man könnte sich nun fragen, wozu der Dateimodus oder die Codierungsvariante einer geöffneten Datei abgefragt werden muss, wenn man diese Informationen doch selbst über OPEN festgelegt hat. Allerdings kann ein Programm in mehrere Teile gegliedert sein, die unabhängig voneinander agieren. Das einfachste Szenario dazu ist ein Unterprogramm, dem die Dateinummer einer Datei übergeben wird, mit der es arbeiten soll (das Unterprogramm muss dann etwa den Namen der Datei nicht kennen, sondern nur den „Einhängepunkt“). Über FILEATTR() kann es nun beispielsweise die Codierungsvariante ermitteln und so sicherstellen, dass die Daten in korrekter Form gelesen bzw. geschrieben werden.

Zur Veranschaulichung der Syntax hier noch ein (minimal geändertes) Beispiel aus der deutschsprachigen FreeBASIC-Referenz:

Für FILELEN() und FILEDATETIME() ist es dagegen nicht erforderlich, die Datei vorher zu öffnen. FILELEN() gibt die Länge einer Datei in Byte an, FILEDATETIME() liefert den Zeitpunkt, an dem die Datei das letzte Mal geändert wurde. Dieser Zeitpunkt wird als Serial Number zurückgegeben, auf die Kapitel 18 ausführlich eingeht. Auch die formatierte Ausgabe einer Serial Number mittels FORMAT() wird dort ausführlich besprochen.

Wenn die Datei nicht existiert oder keine Zugriffsberechtigung besteht, liefert FILELEN() den Wert 0 zurück. Achtung: Der Rückgabewert 0 kann auch bedeuten, dass die Datei tatsächlich eine Länge von 0 Byte besitzt!

Wenn Sie einfach nur überprüfen wollen, ob eine Datei existiert, können Sie FILEEXISTS() verwenden. Der Rückgabewert ist -1, wenn die Datei existiert, oder 0, wenn keine Datei mit diesem Namen existiert. Auch wenn es sich beim angegebenen Namen um einen Ordner statt um eine Datei handelt, wird 0 zurückgegeben.

Bisher war es immer nötig, den genauen Dateinamen der gewünschten Datei zu kennen. Das ist nicht immer möglich. Vielleicht benötigen Sie einmal eine Liste aller PDF-Dateien in Ihrem Ordner, oder Sie wollen alle Dateien löschen, die mit temp_ beginnen. Für die Suche nach Dateien, die einem bestimmten Muster entsprechen, eignet sich DIR().

DIR() gibt den Namen der gefundenen Datei zurück. Der Pfadname entfällt bei der Rückgabe. Eine leere Rückgabe zeigt an, dass keine Datei gefunden wurde, die dem Suchmuster entspricht.

Um den Sinn hinter Rueckgabeattribut zu verstehen, müssen wir etwas in die Funktionsweise von DIR() hineinschauen. Attributnummer setzt sich aus einer Kombination verschiedener Werte zusammen, die in der Datei file.bi mit sprechenden Namen belegt wurden:

Außerdem ist fbNormal = fbReadOnly OR fbArchive. Sie können jede gewünschte Kombination von Attributen über eine OR-Verknüpfung herstellen, also z. B. mit fbNormal OR fbHidden OR fbDirectory nach Einträgen suchen, die auch versteckt und/oder Ordner sein können.

Wird Attributnummer nicht angegeben, wird fbNormal verwendet. DIR sucht also nach allen „normalen“ Dateien einschließlich schreibgeschützter und archivierbarer Dateien, aber keine versteckten Dateien oder Ordner. Der Schalter fbReadOnly bedeutet also, dass auch nach schreibgeschützten Dateien gesucht wird, aber nicht nur schreibgeschützte Dateien. Wenn Sie nun lediglich die schreibgeschützten Dateien ermitteln wollen, jedoch nicht die beschreibbaren, müssen Sie die Rückgabe anhand von Rueckgabeattribut filtern, also nachsehen, ob dort fbReadOnly gesetzt ist oder nicht.

DIR() benötigt zwar keine Einbindung von file.bi bzw. vbcompat.bi, die verwendeten Attributvariablen fbNormal und fbReadOnly dagegen schon.
Die Umsetzung der Dateiattribute wird unter den verschiedenen Betriebssystemen unterschiedlich gehandhabt. Beispielsweise markiert Windows versteckte Dateien über ein spezielles Dateienattribut, während Linux alle Dateien als versteckt behandelt, die mit einem Punkt beginnen. Windows stellt eine Option zur Verfügung, Dateien als nicht archivierbar zu kennzeichnen, was dann aber bei einem Schreibzugriff großzügig annulliert wird; Linux dagegen unterstützt dieses Attribut nicht … Im Zweifelsfall müssen Sie mit den Attributen etwas herumexperimentieren.

Nun hat DIR() in Quelltext 17.7 zwar Wildcards unterstützt, aber nur eine einzige Datei zurückgeliefert. Allerdings wird das letzte Suchmuster immer intern gespeichert. Jetzt kann DIR() erneut aufgerufen werden, diesmal jedoch mit einem Leerstring als Dateiangabe. Dadurch liefert es den nächsten passenden Treffer. Diesen „leeren“ Aufruf können Sie auch in eine Schleife packen und damit alle passenden Treffer nacheinander abarbeiten. Wenn Sie Rueckgabeattribut nutzen wollen, müssen Sie das erneut angeben (ansonsten wird der Wert nicht aktualisiert). Dateiangabe und Attributnummer entfällt jedoch und wird aus der letzten Abfrage übernommen.

Wenn Sie auf die Auswertung von Rueckgabeattribut verzichten, können Sie sich am Ende der Schleife sogar einfach mit einem dateiname = DIR begnügen.

Die drei Funktionen CHAIN(), EXEC() und RUN() übergeben jeweils die Kontrolle an ein anderes Programm und startet dieses. Programm ist ein String mit dem Dateinamen des zu startenden Programmes (eventuell mit Pfadangabe). Argumente ist ein String, mit den Argumenten, die an das Programm übergeben werden sollen. Während CHAIN() keine Argumentübergabe erlaubt, wird sie von EXEC() erzwungen — Sie können aber auch einen Leerstring "" übergeben. Bei RUN() ist die Übergabe der Argumente optional. Der Rueckgabewert der drei Funktionen ist der Errorlevel, der vom aufgerufenen Programm zurückgegeben wurde, oder -1, falls das Programm nicht aufgerufen werden konnte. (Beachten Sie aber, dass auch der zurückgegebene Errorlevel -1 sein könnte!)

RUN() unterscheidet sich von den beiden anderen Funktionen dadurch, was nach der Ausführung des aufgerufenen Programmes weiter passiert. Während bei CHAIN() und EXEC() anschließend die Kontrolle an das aufrufende Programm zurückgegeben wird und dieses normal weiterläuft, beendet RUN nach erfolgreicher Ausführung und gibt die Kontrolle an das Betriebssystem zurück. Entsprechend können Sie bei RUN() auch nur den Rückgabewert -1 bei missglücktem Aufruf erhalten — bei einem erfolgreichen Aufruf haben Sie ja anschließend keine Möglichkeit mehr, die Rückgabe auszuwerten.

Sie sehen, dass die Unterschiede zwischen den drei Funktionen sehr gering sind. CHAIN() kann problemlos durch EXEC() ersetzt werden, und auch RUN() unterscheidet sich von EXEC() im Prinzip nur durch das Verhalten nach Beendigung des aufgerufenen Programmes.

Natürlich können Sie auch in Ihren eigenen Programmen am Ende ein Errorlevel setzen. Dies geschieht ganz einfach mit der Anweisung END, gefolgt von einem Integerwert. In Kapitel 17.4 wird dazu ein Beispiel präsentiert.

Mit SHELL() steht noch eine vierte Funktion zur Verfügung. Diese unterscheidet sich jedoch tatsächlich etwas von den anderen, denn zum einen wird ihr statt eines Programmes ein Shell-Befehl übergeben (der seinerseits aber auch ein Programmname sein kann), zum anderen findet eine Parameterübergabe innerhalb dieses Befehls statt. SHELL() ist ungleich mächtiger als die zuvor genannten Befehle, da über den Shell-Befehl z. B. auch Programmaufrufe verknüpft und Ausgaben umgeleitet werden können.

Beachten Sie, dass sich zwei nacheinander ausgeführte SHELL()-Aufrufe nicht gegenseitig beeinflussen! Sie können beispielsweise als Kommando auch einen Ordnerwechsel (cd) durchführen; dieser ist in einem folgenden SHELL()-Aufrufe aber nicht mehr vorhanden. Dazu ein einfaches Beispiel — der Befehl cd wechselt das Verzeichnis und dir listet den Inhalt des Verzeichnisses auf.

Natürlich kann hier nicht ansatzweise auf die Möglichkeiten der Shell-Kommandos eingegangen werden. Es ist jedoch lohnenswert, sich näher damit zu beschäftigen, da mit den zur Verfügung stehenden Werkzeugen Programme effizient miteinander verknüpft werden können.